TTS Drupal Template

This repository aims to simplify the process of getting a drupal/cms app running in cloud.gov

Important

This script is very much a work in progress. All aspects should be independently validated before using.

PRs and ideas for improvement VERY much welcome.

Bootstrap application and run locally

1. Clone this repository
2. Run ./bootstrap.sh PATH_TO_NEW_DIR
3. bootstrap.sh will finish by presenting you in a ddev ssh console
4. At that command line, run ./init.sh

Deploy to Cloud.gov

Follow these steps to deploy your app:

1. Go to the directory where you bootstrapped the app (PATH_TO_NEW_DIR above)

   cd PATH_TO_NEW_DIR

2. cd terraform

3. terraform init

4. terraform validate

5. Create a terraform/terraform.tfvars file to define the required variables:

   • cf_org_name - Organization name on Cloud.gov where Drupal should be deployed
   • cf_space_name - Space name on Cloud.gov in cf_org_name where Drupal should be deployed. This space will be created.
   • app_name - Name of deployed Drupal application
   • cf_users - List of usernames that can deploy the application within cf_space_name

6. terraform apply to deploy to your new space

Log in to your Drupal site

1. View the root credentials for logging in:

   cf curl "/v3/service_instances/$(terraform output -raw credentials_id)/credentials"

   Make note of the ROOT_USER_NAME and ROOT_USER_PASS credentials

2. From terraform output, visit the URL in route:

   terraform output -raw route

3. Click the "Log in" button on the page

4. Use the ROOT_USER_NAME and ROOT_USER_PASS values from the root user credentials to log in

Disclaimers

This template does not do many things needed for a well-architected federal application. You are responsible for:

1. Updating the terraform modules for proper multiple environment setup and shared backend
2. Implementing egress control for the space
3. CI/CD tests and scans
4. Compliance documentation
5. Proper authentication either through SSO or with MFA
6. etc.