These instructions describe the process for setting up a local development environment for developing Drupal 8 websites using the uiowa/uiowa and uiowa/multisite tools.
Install Lando by following the directions for your OS.
Follow the directions on uiowa/multisite under the Requirements and Saving sections of the readme. At the end of that, you should have the ~/.drush/drush.yml
file created or updated with the following information:
uiowa:
multisite:
github:
token: foo
acquia:
user: your-email@uiowa.edu
token: baz
- Clone the application repository to your machine:
git clone git@github.com:uiowa/uiowa.git ~/acquia/uiowa
. - Verify that Docker is running.
- Use a terminal window and navigate to your application directory. For example:
cd ~/acquia/uiowa
. - Run
lando start
. This will spin up the docker containers specified in the .lando.yml file. This may take a few minutes, so now is a good time to go grab some coffee.
For testing and development on uiowa/rusty profile, it is usually sufficient to use the eight.uiowa.edu site, which should already be created by the previous steps.
lando ssh
cd docroot/sites/eight.uiowa.edu
drush sql:create
drush si rusty --sites-subdir eight.uiowa.edu
drush uli
The last step provides a login URL that you can copy and add to the end of your local domain, for example https://eight.uiowa.lndo.site/user/reset/1/1542233093/tmsrOQ-HBNttyh0ZSqg-KMVglxEkjFFBKdnNHwWuppU/login
.
cd ~/acquia/uiowa
git pull
Update the composer.json
file, changing to the branch of uiowa/rusty you would like to review. You'll find this under the "require" section. For example, to test the "foobar" branch, you would update it as follows:
"require": {
"uiowa/rusty": "dev-foobar",
},
Then run these commands:
cd ~/acquia/uiowa
composer update uiowa/rusty
composer install
cd docroot/sites/eight.uiowa.edu
drush si rusty --sites-subdir eight.uiowa.edu
drush uli
This will re-install the rusty profile so you'll have a fresh installation. Login with the URL generated by the last command.
Might be better to have all this documentation living in one place. I would suggest updating our uiowa repo readme.md. I think some of this info already lives there.