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

Amazon ECS-Optimized Amazon Linux 2 AMI

The Amazon ECS-optimized Amazon Linux 2 AMI is the recommended AMI to use for launching your Amazon ECS container instances. Amazon ECS provides separate Amazon ECS-optimized Amazon Linux 2 AMIs for x86 and arm64 architecture.

Although you can create your own container instance AMI that meets the basic specifications outlined in Container Instance AMIs, the Amazon ECS-optimized Amazon Linux 2 AMI is preconfigured and tested on Amazon ECS by AWS engineers. It is the simplest AMI for you to get started and to get your containers running on AWS quickly.

Note

Amazon ECS vends Linux AMIs that are optimized for the service in two variants. The latest and recommended version is based on Amazon Linux 2. Amazon ECS also vends AMIs that are based on the Amazon Linux AMI. We recommend that you migrate your workloads to the Amazon Linux 2 variant, as support for the Amazon Linux AMI ends no later than June 30, 2020.

The current Amazon ECS-optimized Amazon Linux 2 AMI consists of:

  • The latest minimal version of the Amazon Linux 2

  • The latest version of the Amazon ECS container agent (1.24.0)

  • The recommended version of Docker for the latest Amazon ECS container agent (18.06.1-ce)

  • The latest version of the ecs-init package to run and monitor the Amazon ECS agent (1.24.0-1)

The Amazon ECS-optimized Amazon Linux 2 AMI metadata, including the AMI ID, can be retrieved programmatically. For more information, see Retrieving Amazon ECS-Optimized AMI Metadata.

The current Amazon ECS-optimized Amazon Linux 2 AMI IDs by region are listed below for reference.

Region AMI Name AMI ID EC2 console link
us-east-2 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-0fbc9fff39b859770 Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-00a0ec1744b47e7e3 Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-0a8893b3446d3e884 Launch instance
us-west-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-09a718d703d4dfd1d Launch instance
eu-west-3 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-0d8b13ba7c91ce621 Launch instance
eu-west-2 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-0e57cd83d692ab020 Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-07c916f51e03b3fc6 Launch instance
eu-central-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-00c89894d831fd9bf Launch instance
eu-north-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-0b1735736271ee063 Launch instance
ap-northeast-2 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-0309114e6e5df021e Launch instance
ap-northeast-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-079d813d04571915e Launch instance
ap-southeast-2 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-03ba7b79573cdbe5e Launch instance
ap-southeast-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-06227143764cbe5b6 Launch instance
ca-central-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-0b8d05f39cf05bdb9 Launch instance
ap-south-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-0d4c0e46eb46325cb Launch instance
sa-east-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-0aaea9f335c45e3a3 Launch instance
us-gov-west-1 amzn2-ami-ecs-hvm-2.0.20190107-x86_64-ebs ami-843351e5 Launch instance

The current Amazon ECS-optimized Amazon Linux 2 (arm64) AMI IDs by region are listed below for reference.

Region AMI Name AMI ID EC2 console link
us-east-2 amzn2-ami-ecs-hvm-2.0.20190107-arm64-ebs ami-0283be7c51553d21a Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190107-arm64-ebs ami-050fdacbc39dffd05 Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190107-arm64-ebs ami-0fdba42282afd8d70 Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190107-arm64-ebs ami-0b86e0124e957c7aa Launch instance