Amazon ECS
User Guide for AWS Fargate (API Version 2014-11-13)

Document History

The following table describes the major updates and new features for the Amazon ECS User Guide for AWS Fargate. We also update the documentation frequently to address the feedback that you send us.

Change

Description

Date

AWS Fargate region expansion

AWS Fargate with Amazon ECS has expanded to the US West (N. California) and Asia Pacific (Seoul) Regions.

For more information, see AWS Fargate Platform Versions.

07 Nov 2018

Service limits updated

The following service limits were updated:

  • Number of tasks using the Fargate launch type, per region, per account was raised from 20 to 50.

  • Number of public IP addresses for tasks using the Fargate launch type was raised from 20 to 50.

For more information, see Amazon ECS Service Limits.

31 Oct 2018

AWS Fargate region expansion

AWS Fargate with Amazon ECS has expanded to the EU (London) Region.

For more information, see AWS Fargate Platform Versions.

26 Oct 2018

Private registry authentication support for Amazon ECS using AWS Fargate tasks

Amazon ECS introduced support for Fargate tasks using private registry authentication using AWS Secrets Manager. This feature enables you to store your credentials securely and then reference them in your container definition, which allows your tasks to use private images.

For more information, see Private Registry Authentication for Tasks.

10 Sept 2018

Amazon ECS CLI v1.8.0

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

  • Added support for Docker volumes in Docker compose files.

  • Added support for task placement constraints and strategies in Docker compose files.

  • Added support for private registry authentication in Docker compose files.

  • Added support for --force-update on compose up to force relaunching of tasks.

For more information, see the Amazon ECS Command Line Reference in the Amazon Elastic Container Service Developer Guide.

7 Sept 2018

Amazon ECS service discovery region expansion

Amazon ECS service discovery has expanded support to the Asia Pacific (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), EU (Frankfurt), and EU (London) regions.

For more information, see Service Discovery.

30 August 2018

Scheduled tasks with Fargate tasks support

Amazon ECS introduced support for scheduled tasks for the Fargate launch type.

For more information, see Scheduled Tasks (cron).

28 August 2018

AWS Fargate region expansion

AWS Fargate with Amazon ECS has expanded to the EU (Frankfurt), Asia Pacific (Singapore), and Asia Pacific (Sydney) regions.

For more information, see AWS Fargate Platform Versions.

19 July 2018

Amazon ECS CLI v1.7.0

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

  • Added support for container healthcheck and devices in Docker compose files. For more information, see the Amazon ECS Command Line Reference in the Amazon Elastic Container Service Developer Guide.

18 July 2018

Amazon ECS service scheduler strategies added

Amazon ECS introduced the concept of service scheduler strategies.

There are two service scheduler strategies available:

  • REPLICA—The replica scheduling strategy places and maintains the desired number of tasks across your cluster. By default, the service scheduler spreads tasks across Availability Zones. You can use task placement strategies and constraints to customize task placement decisions. For more information, see Replica.

  • DAEMON—The daemon scheduling strategy deploys exactly one task on each active container instance that meets all of the task placement constraints that you specify in your cluster. When using this strategy, there is no need to specify a desired number of tasks, a task placement strategy, or use Service Auto Scaling policies. For more information, see Daemon.

    Note

    Fargate tasks do not support the DAEMON scheduling strategy.

For more information, see Service Scheduler Concepts.

12 June 2018

Amazon ECS CLI v1.6.0

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

5 June 2018

AWS Fargate region expansion

AWS Fargate with Amazon ECS has expanded to the US East (Ohio), US West (Oregon), and EU West (Ireland) regions.

For more information, see AWS Fargate Platform Versions.

26 April 2018

Amazon ECS CLI v1.5.0

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.

  • Added support for the shm_size and tmpfs parameters in compose files.

For more information, see the Amazon ECS Command Line Reference in the Amazon Elastic Container Service Developer Guide.

19 April 2018

Amazon ECS CLI download verification

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

New AWS Fargate platform version released, which contains:

For more information, see AWS Fargate Platform Versions.

26 March 2018

Amazon ECS Service Discovery

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

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, see the Amazon ECS Command Line Reference in the Amazon Elastic Container Service Developer Guide.

20 March 2018

Amazon ECS CLI v1.4.0

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.

  • Added support for aws_session_token in ECS profiles.

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

For more information, see the Amazon ECS Command Line Reference in the Amazon Elastic Container Service Developer Guide.

09 March 2018

Container Health Checks

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

08 March 2018

Amazon ECS Task Metadata Endpoint

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

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

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, see the Amazon ECS Command Line Reference in the Amazon Elastic Container Service Developer Guide.

19 January 2018

Elastic Load Balancing health check initialization wait period

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

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 Additional Service Concepts.

11 January 2018

Task-level CPU and memory

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

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

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

Amazon ECS CLI v1.1.0 with Fargate support

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

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

29 November 2017