This repository contains Terraform configurations for deploying an ECS (Elastic Container Service) cluster on AWS using Terraform and Terragrunt.
The infrastructure includes the following components:
- ECS Cluster: A managed ECS cluster to run containerized applications.
- Task Definitions: Definitions for Docker containers to be run in the ECS cluster.
- Services: ECS services to manage the tasks and maintain desired task count.
- Load Balancer: Application Load Balancer (ALB) for routing traffic to ECS services.
The ECS cluster is deployed in private subnets to enhance security and control access to resources. The network infrastructure ensures that ECS tasks are not directly exposed to the internet, providing a more secure environment for running containerized workloads.
Before you begin, ensure you have:
- AWS IAM credentials with sufficient permissions.
- Terraform and Terragrunt installed locally.
- Docker images for your applications pushed to a container registry (e.g., Amazon ECR).
-
Clone the repository:
git clone https://github.com/minaroid/aws-ecs-terragrunt.git
-
Navigate to the cloned directory:
cd aws-ecs-terragrunt/environments/development -
Initialize Terragrunt:
terragrunt run-all init
-
Review the Terraform plan:
terragrunt run-all plan
-
Apply the Terraform configuration:
terragrunt run-all apply
-
After applying the changes, you should see the ECS cluster and associated resources deployed in your AWS account.
-
Navigate to ECR console and follow the steps to push an image to the repository with this name and tag
nodejs-express:development -
Force ECS service for new deployment:
aws ecs update-service --cluster development-ecs-cluster --service development-ecs-service --force-new-deployment
Feel free to customize the Terraform configurations according to your requirements. You can adjust variables, add or remove resources, or modify configurations as needed.
To destroy the infrastructure and clean up resources:
terragrunt run-all destroy