Pick a box. It's contents will help you on your way. -- Toad
Every commit on this project will be deployed automatically to Pantheon as per this Circle CI SCript.
If you want to change configuration, commit your YML files to the /config directory and the CI will automatically import that configuration as part of moving the site to Pantheon.
If you want to add a module (or other extension), simply add it in composer to the repo and it will automatically be assembled as part of moving the site to Pantheon.
There is currently no CSS compilation setup as part of the CI build, but this will be done as soon as we pick the tooling that everyone wants to use.
Please do all of your code commits directly to GitHub. Do not commit anything directly to Pantheon.
To setup a local development environment, checkout the code from this repository and then run composer install to get everything up to date. Do not commit the vendor directory to the project (there is a .gitignore to help).
Speaking of picking a box...
After you have run composer install:
- Set up a new site Important: Your document root is the web subdirectory of the repo. You might want to have MAMP set up the database for you while creating the site, you're going to need one anyway.
- Get a dump of the database from the dev environment of the Pantheon site (Database / Files -> Export). Why? becasue Drupal 8 sites have a uuid that is in the configuration and if you did your own fresh install you would have a different one in your config from the site we're working on that already has been installed.
- Import the downloaded database into your newly created local site database (Sequel Pro is a nice free tool or from command line:
mysql -uMYSQLUSERNAME -p NAME_OF_YOURDB < PATH_TO_YOUR_DOWNLOADED_SQL_DUMP_FILE). - Set up you local settings.local.php with a setting for 'hash_salt' and database connection.
$settings['hash_salt'] = 'JUST A BUNCH OF RANDOM CHARACTERS GO HERE';
$databases['default']['default'] = array (
'database' => 'NAME_OF_DB',
'username' => 'DB_USERNAME',
'password' => 'DB_PASSWORD',
'host' => 'localhost',
'port' => '3306',
'driver' => 'mysql',
'prefix' => '',
'collation' => 'utf8mb4_general_ci',
);- Add a .htaccess file to the web directory (need to do this to get to admin paths, etc.). You can just grab this from any other clean Drupal 8 codebase.
- On the command line import the configuration using drush from the web directory. Remember to do this after you pull from GitHub as well. It gives you the latest config for the site.
#drush cim -y
- Profit! I mean, you're prolly gonna have to raise your rates now because that took a while, but, yeah... profit!
- Note: want to login as an admin? from the command line in web directory:
# drush uli uri=WHATEVER_YOU_SET_NAME_TO
Currently this site's architecture does not play nice with Kalabox. Mike Pirog is efforting some solution to the issue and once resolved there will be instructions placed here.
If you want to make a change, you can commit it to an individual branch and the CI will automatically create a Multidev with the same name and push the code there.