infrastructure

Deployment/Infrastructure

This project is built, tested and deployed to AWS by CodeBuild. Artifacts are served from S3. CloudFront is used as a CDN. Route 53 is used for DNS.

---

Deployment Prerequisites

All commands below must be run in the /infrastructure directory.

To deploy to AWS, you must:

1. Install Terraform and make sure it is in your PATH.
2. Set your AWS credentials using one of the following options:
   1. Set your credentials as the environment variables AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY.
   2. Run aws configure and fill in the details it asks for.
   3. Run on an EC2 instance with an IAM Role.
   4. Run via CodeBuild or ECS Task with an IAM Role (see buildspec-test.yml for workaround)

Deploying infrastructure

1. Update and export all environment variables specified in the appropriate buildspec declaration (check all phases) and bash scripts
2. Initialise Terraform:

terraform init \
  -backend-config 'bucket=YOUR_S3_BUCKET' \
  -backend-config 'key=YOUR_S3_KEY' \
  -backend-config 'region=YOUR_REGION' \
  -get=true \
  -upgrade=true

1. terraform plan -out main.tfplan
2. terraform apply main.tfplan

Updating infrastructure

1. Update and export all environment variables specified in the appropriate buildspec declaration (check all phases) and bash scripts
2. Make necessary infrastructure code changes.
3. Initialise Terraform:

terraform init \
  -backend-config 'bucket=YOUR_S3_BUCKET' \
  -backend-config 'key=YOUR_S3_KEY' \
  -backend-config 'region=YOUR_REGION' \
  -get=true \
  -upgrade=true

1. terraform plan -out main.tfplan
2. terraform apply main.tfplan

Destroying infrastructure (use with care)

1. Update and export all environment variables specified in the appropriate buildspec declaration (check all phases) and bash scripts
2. Initialise Terraform:

terraform init \
  -backend-config 'bucket=YOUR_S3_BUCKET' \
  -backend-config 'key=YOUR_S3_KEY' \
  -backend-config 'region=YOUR_REGION' \
  -get=true \
  -upgrade=true

1. terraform destroy