SLAC W6-D9

Pantheon Setup

1. Ensure you have a Pantheon account
2. Ping the TL your username to get added to the Pantheon site once you have an account
3. Add your SSH key to your Pantheon account
4. Install and Authenticate Terminus
5. Test your access to the site by running terminus site:list and ensuring slac-w6-d9 is in the list of sites you have access to

Local Development

Requirements

• Docker
  • Docker for Mac
  • Docker for Windows
• DDEV

Setup

1. Clone the repo: git clone git@github.com:slac/w6-d9.git
2. Create .env file: cp .env.example .env
3. Start the project: ddev start
4. Install dependencies: ddev composer install
5. Build the theme: ddev gesso install && ddev gesso build

To install the site from configuration:

1. Run ddev drush si --existing-config
2. Ensure all latest config is installed and clear cache: ddev drush deploy

To install the latest database and files from integration:

Ensure ddev is configured with terminus authentication:

1. Login to your Pantheon Dashboard, and Generate a Machine Token for ddev to use.
2. Add the API token to the web_environment section in your global ddev configuration at ~/.ddev/global_config.yaml

   web_environment:
   - TERMINUS_MACHINE_TOKEN=abcdeyourtoken
   

3. Restart ddev with ddev restart

Pull the files and database

1. Run ddev pull pantheon to connect to Pantheon and download the latest backup of the database and files for the stage environment
2. Clear cache: ddev drush cr

Setup Drupal 7 Migration

1. Create secrets.json file: cp web/sites/default/example.secrets.json web/sites/default/secrets.json
2. Set the correct value for migrate_source_db_url. Get the source db url from the TL
3. Test the db connection: ddev drush sqlc --database=drupal7

Drush on Pantheon Sites

To run drush commands on any of the Pantheon-hosted dev sites, you will need to use Terminus. After installing and setting up, you can run terminus drush slac-w6-d9.[env] -- [drush command]. For example, to clear cache on the dev site, run terminus drush slac-w6-d9.dev -- cr.

Troubleshooting

Xdebug

Xdebug is available in the Docker container but it is not running by default. To spin up the project with Xdebug enabled, run ddev xdebug to turn xdebug on, or ddev xdebug off when you're done.

You'll also need to install an Xdebug plugin for your browser. Xdebug Helper is available for Chrome and Firefox.

PHP Debug is a popular Visual Studio Code extension to add support for XDebug. You'll need to configure pathMappings in the launch.json settings for PHP Debug:

"pathMappings": {
    "/var/www/html": "${workspaceRoot}"
}

Platform Environments

Environments in Pantheon	Forum One Git Branch	Site URL
integration	integration	https://integration-slac-w6-d9.pantheonsite.io
stage	main	https://stage-slac-w6-d9.pantheonsite.io
dev, test, live	live	https://dev-slac-w6-d9.pantheonsite.io https://test-slac-w6-d9.pantheonsite.io https://slac.stanford.edu