ECS Blue/Green Deployment with Terraform

Introduction

This project will provision fully CI/CD Pipeline as Code using Terraform, deploy simple Application in AWS ECS with Blue/Green deployment model. The pipeline will include Source/Build/Deploy. The Build Phase will use CodeBuild with Source from Github, Deploy phase will use CodeDeploy to support ECS Blue/Green deployment model. CodePipeline will work as orchestrator and trigger whenever the code changes is commited to Github.

This is simple CI/CD pipeline as Code with leveraging AWS native solutions. Any comments to improve are welcomed.

Project Structure

.
├── Dockerfile
├── Makefile
├── README.md
├── apps
│   └── index.html
├── buildspec.yaml
├── deployment
│   └── appspec_template.yaml
├── terraform
│   ├── demo
│   │   ├── demo-service.tf
│   │   ├── ecs.tf
│   │   ├── main.tf
│   │   ├── output.tf
│   │   └── vars.tf
│   ├── modules
│   │   ├── alb
│   │   ├── codebuild
│   │   ├── codedeploy
│   │   ├── codepipeline
│   │   ├── codepipeline-roles
│   │   ├── ecr
│   │   ├── ecs-cicd-pipeline
│   │   ├── ecs-cluster
│   │   ├── ecs-roles
│   │   ├── ecs-service
│   │   ├── iam-roles
│   │   ├── security-groups
│   │   └── vpc
│   └── templates
│       ├── ecr_policy
│       ├── ecs_roles
│       └── ecs_task
├── terraform.tfstate
└── terraform.tfstate.backup

22 directories, 13 files

Usage

• View a description of Makefile targets

$ make help
cleanup-state                  clean up the local state.
create-stacks                  Create stacks
destroy-stacks                 Destroy stacks
init-demo                      Init terraform
plan-destroy-stacks            Plan what to destroy
plan-stacks                    Plan what will create

• Create Stacks

$ AWS_PROFILE=demo make create-stacks

• Plan stacks

$ AWS_PROFILE=demo make plan-stacks 

• Delete Stacks

$ AWS_PROFILE=demo make destroy-stacks 

Note

1. This code will provision ECR repository as the beginning because the Infra and Application code are in same repo (for demo purpose). Therefore, The Application cannot start because there is no image in ECR. But DO NOT WORRY. All you need is just deploy the service with CodePipeline. Then the pipeline will build out ECR image and the application can pull image to start.
2. As I use GitHubv2 as Source within CodePipeline and establish connection via CodeStar. After you provision the resources, please follow the link here (https://docs.aws.amazon.com/codepipeline/latest/userguide/update-github-action-connections.html) to link connection between Github and CodePipeline.
3. Remember to terminate the environment after using otherwise you will be cost.