Skip to content

Latest commit

 

History

History
33 lines (23 loc) · 1.6 KB

DEVELOPMENT.md

File metadata and controls

33 lines (23 loc) · 1.6 KB

Development Guide

This guide is for developers of the OE Drupal Pattern.

Setup

We are following the 3 Musketeers pattern for project layout / setup.

AWS Vault is a handy tool we use for managing AWS credentials. The commands below assume AWS Vault is configured with credentials named 'oe-patterns-dev' or 'oe-patterns-prod'.

First, install Docker, Docker Compose, and Make.

Then:

$ make build
$ make synth
$ aws-vault exec oe-patterns-dev -- make deploy

How to release a new version

  1. Create release branch with git flow release start [version]
  2. Update CHANGELOG.md on release branch
  3. Build AMI in production account with aws-vault exec oe-patterns-prod -- make TEMPLATE_VERSION=$TEMPLATE_VERSION ami-ec2-build
  4. Update drupal_stack.py with updated AMI ID as instructed
  5. Synth the template with make synth-to-file and test in prod AWS Console
  6. Repeat until test passes
  7. Generate PLF row using AMI ID and release version with aws-vault exec oe-patterns-prod -- make AMI_ID=$AMI_ID TEMPLATE_VERSION=$TEMPLATE_VERSION gen-plf
  8. Publish CFN template to artifacts bucket using aws-vault exec oe-patterns-dev -- make TEMPLATE_VERSION=$TEMPLATE_VERSION publish
  9. Commit changes to release branch
  10. Finish release branch with git flow release finish [version]
  11. Teardown test stacks with aws-vault-exec oe-patterns-prod -- make destroy
  12. Go to develop branch and rebuild ami in dev account, commit to results develop