Skip to content

Latest commit

 

History

History
55 lines (33 loc) · 2.22 KB

readme.md

File metadata and controls

55 lines (33 loc) · 2.22 KB
Raw

Terraform - Web Server ECS on AWS

This terraform provides quick management and deployment of load-balanced web-servers running as an ECS Fargate cluster on AWS.

The terraform folder /ECR-Registry will setup an ECR Registry only. It can be safely left deployed at very little cost.

The terraform folder /ECS-Service will deploy:

  • VPC with Subnets and Security Groups
  • ECS Cluster, ECS Task Definition and ECS Fargate Service
  • Load Balancer, Listener and Target Group

There is a small hourly cost for running this, so it should be taken down when not needed.

Requirements

This project requires Docker and Terraform to be installed, AWS credentials to be set, and a dockerized web project ready to go.

Setup ECR Container Registry

cd into /ECR-Registry and check variables.tf. If any need to be overridden, create a local.tfvars file and place the overridden variables in there.

Run terraform apply to create the infrastructure, or if using overridden variables:

terraform apply -var-file="local.tfvars"

After creation, docker login, tag, push cmds will be provided as terraform output outputs for quick access.

Steps For Deploying

  • First build a docker ready project with a cmd similar to docker build -t my-image .
  • Login to docker with the terraform output cmd starting with docker login.
  • Tag the image with the terraform output cmd starting with docker tag.
  • Push the image to ECR with the terraform output cmd starting with docker push.

The ECR registry now stores your image and is ready to be pulled from by ECS.

Setup ECS Fargate Service

cd into /ECS-Service and check variables.tf for anything that needs to be changed. Create a local.tfvars file and manually set the variable ecr_repository_uri to the output from ECR ecr_repository_uri.

Run the apply command to deploy the infrastructure:

terraform apply -var-file="local.tfvars"

After the infrastructure has been created, the address for the Load Balancer will be ready to view via terraform output.

Clean up

cd into /ECS-Service run terraform destroy to destroy the infrastructure. Repeat the steps for the /ECS-Registry folder. Any images contained within ECR will also be deleted.