Amazon ECS

Home » AWS Certification Cheat Sheets » AWS Certified Developer Associate Cheat Sheets » AWS Compute » Amazon ECS

General ECS Concepts

Amazon Elastic Container Service (ECS) is a highly scalable, high-performance container management service that supports Docker containers and allows you to easily run applications on a managed cluster of Amazon EC2 instances.

Amazon ECS eliminates the need for you to install, operate, and scale your own cluster management infrastructure.

Using API calls you can launch and stop container-enabled applications, query the complete state of clusters, and access many familiar features like security groups, Elastic Load Balancing, EBS volumes, and IAM roles.

Amazon ECS can be used to schedule the placement of containers across clusters based on resource needs and availability requirements.

There is no additional charge for Amazon ECS. You pay for:

  • Resources created with the EC2 Launch Type (e.g. EC2 instances and EBS volumes).
  • The number and configuration of tasks you run for the Fargate Launch Type.

Possible to use Elastic Beanstalk to handle the provisioning of an Amazon ECS cluster, balancing load, auto-scaling, monitoring, and placing your containers across your cluster.

Alternatively, use ECS directly for more fine-grained control for customer application architectures.

Launch Types

An Amazon ECS launch type determines the type of infrastructure on which your tasks and services are hosted.

There are two launch types and the table below describes some of the differences between the two launch types:

Amazon ECS Launch Types

Fargate Launch Type

  • The Fargate launch type allows you to run your containerized applications without the need to provision and manage the backend infrastructure. Just register your task definition and Fargate launches the container for you.
  • Fargate Launch Type is a serverless infrastructure managed by AWS.
  • Fargate only supports container images hosted on Elastic Container Registry (ECR) or Docker Hub.

EC2 Launch Type

  • The EC2 launch type allows you to run your containerized applications on a cluster of Amazon EC2 instances that you manage.
  • Private repositories are only supported by the EC2 Launch Type.

The following diagram shows the two launch types and summarises some key differences:

Amazon ECS EC2 vs Fargate

ECS Terminology

The following table provides an overview of some of the terminology used with Amazon ECS:

Amazon ECS Terminology

These high-level concepts are all depicted in the image below:

Amazon ECS Clusters Instances Tasks and Services


ECS Clusters are a logical grouping of container instances that you can place tasks on.

A default cluster is created but you can then create multiple clusters to separate resources.

ECS allows the definition of a specified number (desired count) of tasks to run in the cluster.

Clusters can contain tasks using the Fargate and EC2 launch type.

For clusters with the EC2 launch type clusters can contain different container instance types.

Each container instance may only be part of one cluster at a time.

“Services” provide auto-scaling functions for ECS.

Clusters are region-specific.

You can create IAM policies for your clusters to allow or restrict users’ access to specific clusters.

ECS Container Instances & Container Agent

You can use any AMI that meets the Amazon ECS AMI specification.

The EC2 instances used as container hosts must run an ECS agent.

The ECS container agent allows container instances to connect to the cluster.

The container agent runs on each infrastructure resource on an ECS cluster.

The ECS container agent is included in the Amazon ECS optimized AMI and can also be installed on any EC2 instance that supports the ECS specification (only supported on EC2 instances).

Linux and Windows-based.

For non-AWS Linux instances to be used on AWS you must manually install the ECS container agent.

The agent is configured in /etc/ecs/ecs.config.

Prefer to learn by doing? Watch the AWS Hands-On Labs video tutorial below to learn how to create an Amazon ECS cluster and a task running WordPress. We’ll show you how to do this using a combination of the AWS ECS CLI and the console.


Containers are created from a read-only template called an image which has the instructions for creating a Docker container.

Images are built from a Dockerfile.

Only Docker containers are currently supported on ECS.

Images are stored in a registry such as DockerHub or AWS Elastic Container Registry (ECR).

ECR is a managed AWS Docker registry service that is secure, scalable and reliable.

ECR supports private Docker repositories with resource-based permissions using AWS IAM in order to access repositories and images.

Can use the Docker CLI to push, pull and manage images.

Tasks and Task Definitions

A task definition is required to run Docker containers in Amazon ECS.

A task definition is a text file in JSON format that describes one or more containers, up to a maximum of 10.

Task definitions use Docker images to launch containers.

You specify the number of tasks to run (i.e. the number of containers).

Some of the parameters you can specify in a task definition include:

  • Which Docker images to use with the containers in your task.
  • How much CPU and memory to use with each container.
  • Whether containers are linked together in a task.
  • The Docker networking mode to use for the containers in your task.
  • What (if any) ports from the container are mapped to the host container instances.
  • Whether the task should continue if the container finished or fails.
  • The commands the container should run when it is started.
  • Environment variables that should be passed to the container when it starts.
  • Data volumes that should be used with the containers in the task.
  • IAM role the task should use for permissions.

You can use Amazon ECS “Run task” to run one or more tasks once.

Amazon ECS Task and Task Definition

Task Placement Strategy

A task placement strategy is an algorithm for selecting instances for task placement or tasks for termination. Task placement strategies can be specified when either running a task or creating a new service.

This is relevant only to the EC2 launch type.

Amazon ECS supports the following task placement strategies:

binpack – place tasks based on the least available amount of CPU or memory. This minimizes the number of instances in use.

random – place tasks randomly.

spread – place tasks evenly based on the specified value. Accepted values are instanceId (or host, which has the same effect), or any platform or custom attribute that is applied to a container instance, such as attribute:ecs.availability-zone. Service tasks are spread based on the tasks from that service. Standalone tasks are spread based on the tasks from the same task group.

A task placement constraint is a rule that is considered during task placement.

Amazon ECS supports the following types of task placement constraints:

  • distinctInstance – Place each task on a different container instance.
  • memberOf – Place tasks on container instances that satisfy an expression.

Cluster Query Language

Cluster queries are expressions that enable you to group objects.

For example, you can group container instances by attributes such as Availability Zone, instance type, or custom metadata.

Expressions have the following syntax: subject operator [argument]

Example 1: The following expression selects instances with the specified instance type.

attribute:ecs.instance-type == t2.small

Example 2: The following expression selects instances in the us-east-1a or us-east-1b Availability Zone.

attribute:ecs.availability-zone in [us-east-1a, us-east-1b]

Example 3: The following expression selects instances that are hosting tasks in the service:production group.

task:group == service:production

Service Scheduler

You can schedule ECS using Service Scheduler and Custom Scheduler.

Ensures that the specified number of tasks is constantly running and reschedules tasks when a task fails.

It can ensure tasks are registered against an ELB.

Custom Scheduler

You can create your own schedulers to meet business needs.

Leverage third-party schedulers such as Blox.

The Amazon ECS schedulers leverage the same cluster state information provided by the Amazon ECS API to make appropriate placement decisions.

Auto Scaling

Service Auto Scaling

Amazon ECS service can optionally be configured to use Service Auto Scaling to adjust the desired task count up or down automatically.

Service Auto Scaling leverages the Application Auto Scaling service to provide this functionality.

Amazon ECS Service Auto Scaling supports the following types of scaling policies:

  • Target Tracking Scaling Policies—Increase or decrease the number of tasks that your service runs based on a target value for a specific CloudWatch metric.
  • Step Scaling Policies—Increase or decrease the number of tasks that your service runs in response to CloudWatch alarms. Step scaling is based on a set of scaling adjustments, known as step adjustments, which vary based on the size of the alarm breach.
  • Scheduled Scaling—Increase or decrease the number of tasks that your service runs based on the date and time.

Amazon ECS Service Auto Scaling

Cluster Auto Scaling

Click the image above to watch the FREE Video Tutorial on Amazon ECS Cluster Auto Scaling with a Capacity Provider.

This is a new feature released in December 2019.

Uses a new ECS resource type called a Capacity Provider.

A Capacity Provider can be associated with an EC2 Auto Scaling Group (ASG).

When you associate an ECS Capacity Provider with an ASG and add the Capacity Provider to an ECS cluster, the cluster can now scale your ASG automatically by using two new features of ECS:

  1. Managed scaling, with an automatically-created scaling policy on your ASG, and a new scaling metric (Capacity Provider Reservation) that the scaling policy uses; and
  2. Managed instance termination protection, which enables container-aware termination of instances in the ASG when scale-in happens.

Amazon ECS Cluster Auto Scaling


EC2 instances use an IAM role to access ECS.

ECS tasks can have IAM Roles attached (including Fargate tasks).

ECS tasks use the IAM role to access services and resources.

The container agent makes calls to the ECS API on your behalf through the applied IAM roles and policies.

You need to apply IAM roles to container instances before they are launched (EC2 launch type).

Best practices:

  • AWS recommends limiting the permissions that are assigned to the container instance’s IAM roles.
  • Assign extra permissions to tasks through separate IAM roles (IAM Roles for Tasks).

Security groups attach at the instance or container level.

Amazon ECS IAM Roles for Tasks

You have root-level access to the operating system of the EC2 instances.

The Compute SLA guarantees a Monthly Uptime Percentage of at least 99.99% for Amazon ECS.

ECS with X-Ray

There are two ways to run X-Ray:

As a daemon: X-Ray agent runs in a daemon container.

As a “sidecar”: X-Ray runs alongside each container.

For Fargate the X-Ray daemon only runs as a sidecar.

Amazon ECS with AWS X-Ray Daemon

Task definition:

  • X-Ray runs on port 2000 UDP.
  • Must specify the daemon address.
  • Must link the containers together.

X-Ray provides a Docker container image that you can deploy alongside your application:

    • Command: docker pull amazon/aws-xray-daemon

ECS with Elastic Beanstalk

There are two options: Single and Multi- Docker container mode.

Single Container Docker

The single container platform can be used to deploy a Docker image (described in a Dockerfile or definition) and source code to EC2 instances running in an Elastic Beanstalk environment.

Use the single container platform when you only need to run one container per instance.

Multicontainer Docker

The other basic platform, Multicontainer Docker, uses the Amazon Elastic Container Service to coordinate the deployment of multiple Docker containers to an Amazon ECS cluster in an Elastic Beanstalk environment.

The instances in the environment each run the same set of containers, which are defined in a file.

Use the multicontainer platform when you need to deploy multiple Docker containers to each instance.

ElasticBeanstalk creates the following resources:

  • ECS cluster.
  • EC2 container instances.
  • Load balancers (for high availability mode).
  • Task definitions and execution.

Requires a config file at the root of the source code.

Your Docker images must be pre-built (can be stored in ECR).

Amazon Elastic Container Registry (ECR)

Amazon Elastic Container Registry (ECR) is a fully-managed Docker container registry that makes it easy for developers to store, manage, and deploy Docker container images.

Amazon ECR is integrated with Amazon Elastic Container Service (ECS).

Amazon ECR hosts your images in a highly available and scalable architecture, allowing you to reliably deploy containers for your applications.

Integration with AWS Identity and Access Management (IAM) provides resource-level control of each repository.

Amazon Elastic Container Registry (ECR)

Pushing and Pulling Images to ECR

You must first authenticate.

To authenticate Docker to an Amazon ECR registry with get-login-password, run the aws ecr get-login-password command:

aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin

Note: In the AWS CLI version 1 the command is aws ecr get-login (without the -password). This is still appearing in the exam.

Tag your image:

docker tag e9ae3c220b23

Push the image using the docker push command:

docker push

Pull the image using the docker pull command. The image name format should be registry/repository[:tag] to pull by tag, or registry/repository[@digest] to pull by digest.

docker pull

Using an Amazon Elastic Load Balancer with ECS

Click the image above to watch the FREE Video Tutorial on Amazon ECS with Elastic Load Balancing

Amazon ECS with Elastic Load Balancing

It is possible to associate a service on Amazon ECS to an Amazon Elastic Load Balancer (ELB).

The ALB supports a target group that contains a set of instance ports.

You can specify a dynamic port in the ECS task definition which gives the container an unused port when it is scheduled on the EC2 instance (this is specific to ALB only).

Amazon ECS with Application Load Balancer (ALB)