ECS HTTP Task

This module will allow you to deploy an ECS Task and an ECS Service. This is intended to be run as part of your app deployment pipeline. It works well with Concourse. It is assumed you already have a solution for deploying an ECS Cluster. If not, check out ours. This particular iteration assumes that you are deploying applications behind a load balancer with SSL termination and redirection from port 80 (i.e. AWS application load balancer).

Prerequisites

First, you need a decent understanding of how to use Terraform. Hit the docs for that. Then, you should familiarize yourself with ECS concepts, especially if you've never worked with a clustering solution before. Once you're good, import this module and pass the appropriate variables. Then, plan your run and deploy.

We also assume that you're deploying an application behind an ALB to port 443 (a really good idea). We will ask for your certificate ARN and automagically configure an HTTP to HTTPS redirect on the ALB. If you need more interesting features like opening ports other than 80 and 443 then feel free to use this as a template.

Example Usage

module "terraform-ecs-task" {
  source  = "7Factor/ecs-http-task/aws"
  version = "~> 1"

  vpc_id                = data.aws_vpc.primary_vpc.id
  alb_subnets           = data.aws_subnet_ids.subnet_ids.ids
  lb_security_group_id  = data.aws_security_group.primary_sg.id
  app_name              = var.app_name
  app_port              = var.app_port
  cpu                   = 256
  memory                = 256
  desired_task_count    = 2
  service_role_arn      = var.service_role_arn
  service_name          = "Angular Starter Service"
  container_definitions = data.template_file.container_definitions.rendered
}

Deployment Options

The default configuration will perform standard blue/green deployments by setting the minimum and maximum "percentages" to 100% and 200%, respectively. When deploying non-critical services (e.g. development and staging instances) in tightly constrained environments, deployments may fail if there are insufficient CPU/memory "units" to start new tasks before stopping the old ones. To resolve this, set these values to 0% and 100%:

service_deployment_maximum_percent         = 100
service_deployment_minimum_healthy_percent = 0

Migrating from github.com/7Factor/terraform-ecs-http-task

This is the new home of the ecs-http-task module. It was copied here so that changes wouldn't break services relying on the old repo. Going forward, you should endeavour to use this version of the module. More specifically, use the module from the Terraform registry. This way, you can select a range of versions to use in your service which allows us to make potentially breaking changes to the module without breaking your service.

Migration instructions

You need to change the module source from the GitHub url to 7Factor/ecs-http-task/aws. This will pull the module from the Terraform registry. You should also add a version to the module block. See the example above for what this looks like together.