First-Time Setup

Note: this has only been tested on ddev 1.19 and above.

1. Clone main branch of repo:

   git clone -b main git@github.com:USEPA/webcms.git
   

2. Then, start the project:

   cd services/drupal && ddev start
   

3. Next, create the S3 bucket for s3fs:

   ddev aws-setup
   

4. After that, please download the latest database (see https://forumone.atlassian.net/wiki/spaces/EPA/pages/1794637894/HOWTO+Import+D8+InnoDB+Cold+Backup) and put the .tar file in the services/drupal/.ddev/db/ folder. The filename isn't important; you will be prompted to select the DB you wish to import during the next step.

5. Import the database by running:

   ddev epa-import
   

6. After the import you will need to restart:

   ddev poweroff && ddev start
   

7. Copy cp .env.example .env.

8. Install dependencies:

   ddev composer install
   

9. Install the requirements for the theme: ddev gesso install:

   ddev gesso install
   

10. Building/watching the CSS and Pattern Lab:

    1. to build

    ddev gesso build
    

    2. to watch:

    ddev gesso watch
    

11. Install Drupal from config (or restore a backup). You can install from config by running:

    Note: Do not run this command if starting from a new installation. This will wipe the database out, instead skip to #11.

ddev drush si --existing-config

12. Ensure the latest configuration has been fully applied and clear cache:

ddev drush deploy -y

13. Edit your services/drupal/.env file and change the line that reads ENV_STATE=build to read ENV_STATE=run -- without this change you will not make use of Redis caching.

14. To unblock the user run ddev drush user:unblock drupalwebcms-admin

15. Access the app at https://epa.ddev.site

Testing migrations

To load a D7 DB copy for testing:

gunzip < cleaned-d7-db.sql.gz | f1 drush sqlc --db-url mysql://web_d7:web_d7@mysql:3306/web_d7

Other READMEs

• Terraform configuration: see infrastructure/terraform.
• Builds: see .buildkite.

Troubleshooting

Elasticsearch

If you run into an error trying to use elasticsearch. Please run the following command:

ddev poweroff && docker volume rm ddev-epa-ddev_elasticsearch && ddev start

You will need to re-index.

Helpful commands

Here is a list of helpful commands:

• ddev gesso install > Installs the node modules needed for epa_core.
• ddev gesso build > Builds the current assets for CSS & PatternLab.
• ddev gesso watch > Same thing as build but will watch for changes.
• ddev ssh > Goes into the web container.
• ddev drush > Runs any drush command.
• ddev epa-import > Will import a specific database.
• ddev epa-export > Exports a database with the current date.
• ddev aws-setup > Sets up the requirements to get drupal file system to work

Disclaimer

The United States Environmental Protection Agency (EPA) GitHub project code is provided on an "as is" basis and the user assumes responsibility for its use. EPA has relinquished control of the information and no longer has responsibility to protect the integrity , confidentiality, or availability of the information. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by EPA. The EPA seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity by EPA or the United States Government.