AWS Fargate Platform Versions - Amazon Elastic Container Service

AWS Fargate Platform Versions

AWS Fargate platform versions are used to refer to a specific runtime environment for Fargate task infrastructure. It is a combination of the kernel and container runtime versions.

New platform versions are released as the runtime environment evolves, for example, if there are kernel or operating system updates, new features, bug fixes, or security updates. Security updates and patches are deployed automatically for your Fargate tasks. If a security issue is found that affects a platform version, AWS patches the platform version. In some cases, you may be notified that your Fargate tasks have been scheduled for retirement. For more information, see Task Retirement.

Platform Version Considerations

The following should be considered when specifying a platform version:

  • When specifying a platform version, you can use either the version number (for example, 1.3.0) or LATEST.

  • To use a specific platform version, specify the version number when creating or updating your service. If you specify LATEST, your tasks use the most current platform version available, which may not be the most recent platform version.

  • In the China (Beijing) and China (Ningxia) Regions, the only supported platform version is 1.3.0. The AWS Management Console displays older platform versions but an error will be returned if they are chosen. The LATEST platform version is supported because it uses the 1.3.0 platform version.

  • If you have a service with running tasks and want to update their platform version, you can update your service, specify a new platform version, and choose Force new deployment. Your tasks are redeployed with the latest platform version. For more information, see Updating a Service.

  • If your service is scaled up without updating the platform version, those tasks receive the platform version that was specified on the service's current deployment.

Available AWS Fargate Platform Versions

The following is a list of the platform versions currently available:

Fargate Platform Version‐1.3.0
  • Beginning on Sept 30, 2019, any new Fargate task that is launched supports the awsfirelens log driver. FireLens for Amazon ECS enables you to use task definition parameters to route logs to an AWS service or AWS Partner Network (APN) destination for log storage and analytics. For more information, see Custom Log Routing.

  • Added task recycling for Fargate tasks, which is the process of refreshing tasks that are a part of an Amazon ECS service. For more information, see Fargate Task Recycling.

  • Beginning on March 27, 2019, any new Fargate task that is launched can use additional task definition parameters that enable you to define a proxy configuration, dependencies for container startup and shutdown as well as a per-container start and stop timeout value. For more information, see Proxy Configuration, Container Dependency, and Container Timeouts.

  • Beginning on April 2, 2019, any new Fargate task that is launched supports injecting sensitive data into your containers by storing your sensitive data in either AWS Secrets Manager secrets or AWS Systems Manager Parameter Store parameters and then referencing them in your container definition. For more information, see Specifying Sensitive Data.

  • Beginning on May 1, 2019, any new Fargate task that is launched supports referencing sensitive data in the log configuration of a container using the secretOptions container definition parameter. For more information, see Specifying Sensitive Data.

  • Beginning on May 1, 2019, any new Fargate task that is launched supports the splunk log driver in addition to the awslogs log driver. For more information, see Storage and Logging.

  • Beginning on July 9, 2019, any new Fargate tasks that is launched supports CloudWatch Container Insights. For more information, see Amazon ECS CloudWatch Container Insights.

  • Beginning on December 3, 2019, the Fargate Spot capacity provider is supported. For more information, see Using AWS Fargate Capacity Providers.

Fargate Platform Version‐1.2.0
Fargate Platform Version‐1.1.0
  • Added support for the Amazon ECS task metadata endpoint. For more information, see Amazon ECS Task Metadata Endpoint.

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

  • Added support for Amazon ECS service discovery. For more information, see Service Discovery.

Fargate Platform Version‐1.0.0
  • Based on Amazon Linux 2017.09.

  • Initial release.