Menu
Amazon Elastic Container Service
Developer Guide (API Version 2014-11-13)

Document History

The following table describes the important changes to the documentation since the last release of Amazon ECS. We also update the documentation frequently to address the feedback that you send us.

  • Current API version: 2014-11-13

  • Latest documentation update: April 10th, 2018

Feature

API Version

Description

Release Date

Amazon ECS CLI v1.5.0

2014-11-13

New version of the Amazon ECS CLI released, which added the following functionality:

  • Added support for the ECS CLI to automatically retrieve the latest stable Amazon ECS-optimized AMI by querying the SSM Parameter Store API during the cluster resource creation process. This requires the user account that you are using to have the required SSM permissions. For more information, see ecs-cli up.

  • Added support for the shm_size and tmpfs parameters in compose files. For more information, see ecs-cli compose.

For more information about the updated ECS CLI syntax, see Amazon ECS Command Line Reference.

19 April 2018

Amazon ECS-optimized AMI Metadata Retrieval

2014-11-13

Added ability to programatically retrieve Amazon ECS-optimized AMI metadata using the SSM Parameter Store API. For more information, see Retrieving the Amazon ECS-optimized AMI Metadata.

10 April 2018

Amazon ECS CLI download verification

2014-11-13

Added new PGP signature method for verifying the Amazon ECS CLI installation file. For more information, see Installing the Amazon ECS CLI.

5 April 2018

AWS Fargate Platform Version

2014-11-13

New AWS Fargate platform version released, which contains:

For more information, see AWS Fargate Platform Versions.

26 March 2018

Amazon ECS Service Discovery

2014-11-13

Added integration with Route 53 to support Amazon ECS service discovery. For more information, see Service Discovery.

22 March 2018

Amazon ECS CLI v1.4.2

2014-11-13

New version of the Amazon ECS CLI released, which added the following functionality:

  • Updated the AMI to amzn-ami-2017.09.k-amazon-ecs-optimized.

For more information about the updated ECS CLI syntax, see Amazon ECS Command Line Reference.

20 March 2018

Docker shm-size and tmpfs support

2014-11-13

Added support for the Docker shm-size and tmpfs parameters in Amazon ECS task definitions.

For more information about the updated ECS CLI syntax, see Linux Parameters.

20 March 2018

Amazon ECS CLI v1.4.0

2014-11-13

New version of the Amazon ECS CLI released, which added the following functionality:

  • Added support for the us-gov-west-1 region.

  • Added --force-deployment flag for the compose service command. For more information, see ecs-cli compose service.

  • Added support for aws_session_token in ECS profiles. For more information, see ecs-cli configure profile.

  • Updated the AMI to amzn-ami-2017.09.j-amazon-ecs-optimized.

For more information about the updated ECS CLI syntax, see Amazon ECS Command Line Reference.

09 March 2018

Container Health Checks

2014-11-13

Added support for Docker health checks in container definitions. For more information, see Health Check.

08 March 2018

AWS Fargate

2014-11-13

Added overview for Amazon ECS with AWS Fargate. For more information, see AWS Fargate on Amazon ECS.

22 February 2018

Amazon ECS Task Metadata Endpoint

2014-11-13

Beginning with version 1.17.0 of the Amazon ECS container agent, various task metadata and Docker stats are available to tasks that use the awsvpc network mode at an HTTP endpoint that is provided by the Amazon ECS container agent. For more information, see Amazon ECS Task Metadata Endpoint.

8 February 2018

Amazon ECS Service Auto Scaling using target tracking policies

2014-11-13

Added support for ECS Service Auto Scaling using target tracking policies in the Amazon ECS console. For more information, see Target Tracking Scaling Policies.

Removed the previous tutorial for step scaling in the ECS first run wizard. This was replaced with the new tutorial for target tracking.

8 February 2018

Amazon ECS CLI v1.3.0

2014-11-13

New version of the Amazon ECS CLI released, which added the following functionality:

  • Ability to create empty clusters with the up command.

  • Added --health-check-grace-period flag for the compose service up command.

  • Updated the AMI to amzn-ami-2017.09.g-amazon-ecs-optimized.

For more information about the updated ECS CLI syntax, see Amazon ECS Command Line Reference.

19 January 2018

Docker 17.09 support

2014-11-13

Added support for Docker 17.09. For more information, see Amazon ECS-Optimized AMI.

18 January 2018

Elastic Load Balancing health check initialization wait period

2014-11-13

Added ability to specify a wait period for health checks. For more information, see (Optional) Health Check Grace Period.

27 December 2017

New service scheduler behavior

2014-11-13

Updated information about the behavior for service tasks that fail to launch. Documented new service event message that triggers when a service task has consecutive failures. For more information about this updated behavior, see Service Concepts.

11 January 2018

Task-level CPU and memory

2014-11-13

Added support for specifying CPU and memory at the task-level in task definitions. For more information, see TaskDefinition.

12 December 2017

Amazon ECS console AWS CodePipeline integration

2014-11-13

Added Amazon ECS integration with CodePipeline. CodePipeline supports Amazon ECS as a deployment option to help set up deployment pipelines. For more information, see Tutorial: Continuous Deployment with AWS CodePipeline.

12 December 2017

Task execution role

2014-11-13

The Amazon ECS container agent makes calls to the Amazon ECS API actions on your behalf, so it requires an IAM policy and role for the service to know that the agent belongs to you. The following actions are covered by the task execution role:

  • Calls to Amazon ECR to pull the container image

  • Calls to CloudWatch to store container application logs

For more information, see Amazon ECS Task Execution IAM Role.

7 December 2017

Windows containers support GA

2014-11-13

Added support for Windows 2016 containers. For more information, see Windows Containers.

5 December 2017

Amazon ECS CLI v1.1.0 with Fargate support

2014-11-13

New version of the Amazon ECS CLI released, which added the following features:

  • Support for task networking

  • Support for AWS Fargate

  • Support for viewing CloudWatch Logs data from a task

For more information, see ECS CLI changelog.

29 November 2017

AWS Fargate GA

2014-11-13

Added support for launching Amazon ECS services using the Fargate launch type. For more information, see Amazon ECS Launch Types.

29 November 2017

Amazon ECS name change

2014-11-13

Amazon Elastic Container Service is renamed (previously Amazon EC2 Container Service).

21 November 2017

Task networking

2014-11-13

The task networking features provided by the awsvpc network mode give Amazon ECS tasks the same networking properties as Amazon EC2 instances. When you use the awsvpc network mode in your task definitions, every task that is launched from that task definition gets its own elastic network interface, a primary private IP address, and an internal DNS hostname. The task networking feature simplifies container networking and gives you more control over how containerized applications communicate with each other and other services within your VPCs. For more information, see Task Networking with the awsvpc Network Mode.

14 November 2017

Amazon ECS CLI v1.0.0

2014-11-13

New version of the Amazon ECS CLI released, which added the following features:

  • Support for adding multiple named profiles and cluster configurations

  • Support for custom task definition parameters specified using --ecs-params

  • Support for running the Amazon ECS CLI on Windows

For more information, see ECS CLI changelog.

7 November 2017

Amazon ECS container metadata

2014-11-13

Amazon ECS containers are now able to access metadata such as their Docker container or image ID, networking configuration, or Amazon ARNs. For more information, see Amazon ECS Container Metadata File.

2 November 2017

Docker 17.06 support

2014-11-13

Added support for Docker 17.06. For more information, see Amazon ECS-Optimized AMI.

2 November 2017

Support for Docker flags: device and init

2014-11-13

Added support for Docker's device and init features in task definitions using the LinuxParameters parameter (devices and initProcessEnabled). For more information, see LinuxParameters.

2 November 2017

Support for Docker flags: cap-add and cap-drop

2014-11-13

Added support for Docker's cap-add and cap-drop features in task definitions using the LinuxParameters parameter (capabilities). For more information, see LinuxParameters.

22 September 2017

Network Load Balancer support

2014-11-13

Amazon ECS added support for Network Load Balancers in the Amazon ECS console. For more information, see Creating a Network Load Balancer.

7 September 2017

RunTask overrides

2014-11-13

Added support for task definition overrides when running a task. This allows you to run a task while changing a task definition without the need to create a new task definition revision. For more information, see Running Tasks.

27 June 2017

Amazon ECS scheduled tasks

2014-11-13

Added support for scheduling tasks using cron. For more information, see Scheduled Tasks (cron).

7 June 2017

Spot Instances in the Amazon ECS console

2014-11-13

Added support for creating Spot Fleet container instances within the Amazon ECS console. For more information, see Launching an Amazon ECS Container Instance.

6 June 2017

Amazon ECS CLI v0.5.0

2014-11-13

New version of the Amazon ECS CLI released, which added the following features:

  • Ability to push, pull, and list Amazon ECR images

  • Support for existing load balancers and Application Load Balancers in CreateService

For more information, see ECS CLI changelog.

3 April 2017

Amazon SNS notification for new Amazon ECS-optimized AMI releases

2014-11-13

Added ability to subscribe to SNS notifications about new Amazon ECS-optimized AMI releases. For more information, see Subscribing to Amazon ECS–Optimized AMI Update Notifications.

23 March 2017

Microservices and batch jobs

2014-11-13

Added documentation for two common use cases for Amazon ECS: microservices and batch jobs. For more information, see Common Use Cases in Amazon ECS.

February 2017

Container instance draining

2014-11-13

Added support for container instance draining, which provides a method for removing container instances from a cluster. For more information, see Container Instance Draining.

24 January 2017

Docker 1.12 support

2014-11-13

Added support for Docker 1.12. For more information, see Amazon ECS-Optimized AMI.

24 January 2017

New task placement strategies

2014-11-13

Added support for task placement strategies: attribute-based placement, bin pack, Availability Zone spread, and one per host. For more information, see Amazon ECS Task Placement Strategies.

29 December 2016

Windows container support in beta

2014-11-13

Added support for Windows 2016 containers (beta). For more information, see Windows Containers.

20 December 2016

Blox OSS support

2014-11-13

Added support for Blox OSS, which allows for custom task schedulers. For more information, see Scheduling Amazon ECS Tasks.

1 December 2016

Amazon ECS event stream for CloudWatch Events

2014-11-13

Amazon ECS now sends container instance and task state changes to CloudWatch Events. For more information, see Amazon ECS Event Stream for CloudWatch Events.

21 November 2016

Amazon ECS container logging to CloudWatch Logs

2014-11-13

Added support for the awslogs driver to send container log streams to CloudWatch Logs. For more information, see Using the awslogs Log Driver.

12 September 2016

Amazon ECS services with Elastic Load Balancing support for dynamic ports

2014-11-13

Added support for a load balancer to support multiple instance:port combinations per listener, which increases flexibility for containers. Now you can let Docker dynamically define the container's host port and the ECS scheduler registers the instance:port with the load balancer. For more information, see Service Load Balancing.

11 August 2016

IAM roles for Amazon ECS tasks

2014-11-13

Added support for associating IAM roles with a task. This provides finer-grained permissions to containers as opposed to a single role for an entire container instance. For more information, see IAM Roles for Tasks.

13 July 2016

Amazon ECS CLI support for Docker Compose v2 format

2014-11-13

The Amazon ECS CLI added support for Docker Compose v2 format. For more information, see ecs-cli compose.

8 July 2016

Docker 1.11 support

2014-11-13

Added support for Docker 1.11. For more information, see Amazon ECS-Optimized AMI.

31 May 2016

Task automatic scaling

2014-11-13

Amazon ECS added support for automatically scaling your tasks run by a service. For more information, see Service Auto Scaling.

18 May 2016

Task definition filtering on task family

2014-11-13

Added support for filtering a list of task definition based on the task definition family. For more information, see ListTaskDefinitions.

17 May 2016

Docker container and Amazon ECS agent logging

2014-11-13

Amazon ECS added ability to send ECS agent and Docker container logs from container instances to CloudWatch Logs to simplify troubleshooting issues.

5 May 2016

Amazon ECS CLI v0.3 released

2014-11-13

New version of the Amazon ECS CLI released, which added support for service creation with a load balancer.

11 April 2016

ECS-optimized AMI now supports Amazon Linux 2016.03.

2014-11-13

The ECS-optimized AMI added support for Amazon Linux 2016.03. For more information, see Amazon ECS-Optimized AMI.

5 April 2016

Docker 1.9 support

2014-11-13

Added support for Docker 1.9. For more information, see Amazon ECS-Optimized AMI.

22 December 2015

CloudWatch metrics for cluster CPU and memory reservation

2014-11-13

Amazon ECS added custom CloudWatch metrics for CPU and memory reservation.

22 December 2015

Amazon ECR

2014-11-13

Added the new Amazon ECR service to the console, which added support for storing images that are controlled by resource-level permissions associated with Docker Hub or IAM users. Available in all AWS Regions, images are automatically replicated and cached globally so that starting hundreds of containers is as fast as a single container.

21 December 2015

New Amazon ECS first-run experience

2014-11-13

The Amazon ECS console first-run experience added zero-click role creation.

23 November 2015

Task placement across Availability Zones

2014-11-13

The Amazon ECS service scheduler added support for task placement across Availability Zones.

8 October 2015

Amazon ECS CLI with support for Docker Compose

2014-11-13

The Amazon ECS CLI added support for Docker Compose.

8 October 2015

CloudWatch metrics for Amazon ECS clusters and services

2014-11-13

Amazon ECS added custom CloudWatch metrics for CPU and memory utilization for each container instance, service, and task definition family in a cluster. These new metrics can be used to scale container instances in a cluster using Auto Scaling groups or to create custom CloudWatch alarms.

17 August 2015

UDP port support

2014-11-13

Added support for UDP ports in task definitions.

7 July 2015

Environment variable overrides

2014-11-13

Added support for deregisterTaskDefinition and environment variable overrides for runTask.

18 June 2015

Automated Amazon ECS agent updates

2014-11-13

Added ability to see the ECS agent version that is running on a container instance. Also able to update the ECS agent from the AWS Management Console, AWS CLI, and SDK.

11 June 2015

Amazon ECS service scheduler and Elastic Load Balancing integration

2014-11-13

Added ability to define a service and associate that service with an Elastic Load Balancing load balancer.

9 April 2015

Amazon ECS GA

2014-11-13

Amazon ECS general availability in the IAD, PDX, NRT, and DUB regions.

9 April 2015