Amazon ECS-optimized AMIs
The basic Amazon Elastic Container Service (Amazon ECS) container instance specification consists of the following:
Required
-
A modern Linux distribution running at least version 3.10 of the Linux kernel.
-
The Amazon ECS container agent (preferably the latest version). For more information, see Amazon ECS Container Agent.
-
A Docker daemon running at least version 1.9.0, and any Docker runtime dependencies. For more information, see Check runtime dependencies in the Docker documentation.
Note
For the best experience, we recommend the Docker version that ships with and is tested with the corresponding Amazon ECS agent version that you are using. For more information, see Amazon ECS Container Agent Versions.
Recommended
-
An initialization and nanny process to run and monitor the Amazon ECS agent. The Amazon ECS-optimized AMIs use the
ecs-initRPM to manage the agent. For more information, see theecs-initproject on GitHub.
The Amazon ECS-optimized AMIs are preconfigured with these requirements and recommendations. We recommend that you use the Amazon ECS-optimized Amazon Linux 2 AMI for your container instances unless your application requires a specific operating system or a Docker version that is not yet available in that AMI.
Amazon ECS vends AMIs that are optimized for the service in the following five variants.
-
Amazon ECS-optimized Amazon Linux 2 AMI – Recommended for launching your Amazon ECS container instances in most cases.
-
Amazon ECS-optimized Amazon Linux 2 (arm64) AMI – Recommended for launching your Amazon ECS container instances when using the Amazon EC2 A1 instance type, which is powered by Arm-based AWS Graviton Processors. For more information, see General Purpose Instances in the Amazon EC2 User Guide for Linux Instances.
-
Amazon ECS GPU-optimized AMI – Recommended for launching your Amazon ECS container instances when working with GPU workloads. For more information, see Working with GPUs on Amazon ECS.
-
Amazon ECS-optimized Amazon Linux AMI – This AMI is based off of Amazon Linux 1. We recommend that you migrate your workloads to the Amazon ECS-optimized Amazon Linux 2 AMI. Support for the Amazon ECS-optimized Amazon Linux AMI ends no later than June 30, 2020.
-
Amazon ECS-optimized Windows AMI – Recommended for launching your Amazon ECS container instances on the Windows operating system. For more information, see Windows Containers.
Although you can create your own container instance AMI that meets the basic specifications needed to run your containerized workloads on Amazon ECS, the Amazon ECS-optimized AMIs are preconfigured and tested on Amazon ECS by AWS engineers. It is the simplest way for you to get started and to get your containers running on AWS quickly.
The Amazon ECS-optimized AMI metadata, including the AMI ID, for each variant can be retrieved programmatically. For more information, see Retrieving Amazon ECS-Optimized AMI Metadata.
View the AMI IDs on one of the following tabs, according to the variant you choose.
- Amazon Linux 2
-
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.27.0) -
The recommended version of Docker for the latest Amazon ECS container agent (
18.06.1-ce) -
The latest version of the
ecs-initpackage to run and monitor the Amazon ECS agent (1.27.0-1)
The following table lists the current Amazon ECS-optimized Amazon Linux 2 AMI IDs by Region.
Region AMI Name AMI ID EC2 Console Link us-east-2amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-00cffcd24cb08edf1Launch instance us-east-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0bc08634af113cccbLaunch instance us-west-2amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0054160a688deeb6aLaunch instance us-west-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-05cc68a00d392447aLaunch instance eu-west-3amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0b4b8274f0c0d3bacLaunch instance eu-west-2amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-016a20f0624bae8c5Launch instance eu-west-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-09cd8db92c6bf3a84Launch instance eu-central-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0ab1db011871746efLaunch instance eu-north-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-036cf93383aba5279Launch instance ap-northeast-2amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0470f8828abe82a87Launch instance ap-northeast-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-00f839709b07ffb58Launch instance ap-southeast-2amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-011ce3fbe73731dfeLaunch instance ap-southeast-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0c5b69a05af2f0e23Launch instance ca-central-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-039a05a64b90f63eeLaunch instance ap-south-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0d143ad35f29ad632Launch instance sa-east-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-04e333c875fae9d77Launch instance us-gov-east-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-04002561557e6b65dLaunch instance us-gov-west-1amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-c8c6b1a9Launch instance -
- Amazon Linux 2 (arm64)
-
The current Amazon ECS-optimized Amazon Linux 2 (arm64) AMI consists of:
-
The latest minimal version of the Amazon Linux 2
-
The latest version of the Amazon ECS container agent (
1.27.0) -
The recommended version of Docker for the latest Amazon ECS container agent (
18.06.1-ce) -
The latest version of the
ecs-initpackage to run and monitor the Amazon ECS agent (1.27.0-1)
The following table lists the current Amazon ECS-optimized Amazon Linux 2 (arm64) AMI IDs by Region.
Region AMI Name AMI ID EC2 Console Link us-east-2amzn2-ami-ecs-hvm-2.0.20190403-arm64-ebs ami-0b7373d6d90afa646Launch instance us-east-1amzn2-ami-ecs-hvm-2.0.20190403-arm64-ebs ami-0a399f59161729e22Launch instance us-west-2amzn2-ami-ecs-hvm-2.0.20190403-arm64-ebs ami-0db3030cf5c933348Launch instance eu-west-1amzn2-ami-ecs-hvm-2.0.20190403-arm64-ebs ami-0c812cd5f7b956092Launch instance -
- Amazon Linux 2 (GPU)
-
The current Amazon ECS GPU-optimized AMI consists of the following:
-
The latest minimal version of the Amazon Linux 2
-
The latest version of the Amazon ECS container agent (
1.27.0) -
The recommended version of Docker for the latest Amazon ECS container agent (
18.06.1-ce) -
The latest version of the
ecs-initpackage to run and monitor the Amazon ECS agent (1.27.0-1) -
The recommended NVIDIA driver version (
"NVIDIA Driver Version": "410.104") -
The NVIDIA container runtime hook version (
v1.4.0-1) -
The recommended CUDA version (
"CUDA Version": "9.2.88")
The following table lists the current Amazon ECS GPU-optimized AMI IDs by Region.
Region AMI Name AMI ID EC2 Console Link us-east-2amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-083c800fe4211192fLaunch instance us-east-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-03e13a3b6e7815f1fLaunch instance us-west-2amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-05284b9aa3c01ab6bLaunch instance us-west-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-03fc1e85125c026d1Launch instance eu-west-3amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-04a041a6e222beb5cLaunch instance eu-west-2amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0190d74b4f308b3faLaunch instance eu-west-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0638eba79fcfe776eLaunch instance eu-central-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0a06003d7b855bfd3Launch instance eu-north-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0a1b9d94154abd70aLaunch instance ap-northeast-2amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0b4cb7dc47ed8d637Launch instance ap-northeast-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0b23c122484f8bf90Launch instance ap-southeast-2amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-03cc98c2bbe75bc58Launch instance ap-southeast-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0962019d4f4ce50a9Launch instance ca-central-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-004fcd34a016ba693Launch instance ap-south-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-060e32be63fa1b286Launch instance sa-east-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0027082516f6d0cdaLaunch instance us-gov-east-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0a99d51364f87002aLaunch instance us-gov-west-1amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-58c6b139Launch instance -
- Amazon Linux AMI
-
The current Amazon ECS-optimized Amazon Linux AMI consists of:
-
The latest minimal version of the Amazon Linux AMI
-
The latest version of the Amazon ECS container agent (
1.27.0) -
The recommended version of Docker for the latest Amazon ECS container agent (
18.06.1-ce) -
The latest version of the
ecs-initpackage to run and monitor the Amazon ECS agent (1.27.0-1)
The following table lists the current Amazon ECS-optimized Amazon Linux AMI IDs by Region.
Region AMI Name AMI ID EC2 Console Link us-east-2amzn-ami-2018.03.p-amazon-ecs-optimized ami-0351a163d5f20e068Launch instance us-east-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-0be9e1908fe51a590Launch instance us-west-2amzn-ami-2018.03.p-amazon-ecs-optimized ami-01a82c3fce2c3ba58Launch instance us-west-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-0860832102c806acbLaunch instance eu-west-3amzn-ami-2018.03.p-amazon-ecs-optimized ami-0a6720df6a8239525Launch instance eu-west-2amzn-ami-2018.03.p-amazon-ecs-optimized ami-0bf096cb3ddbdffe0Launch instance eu-west-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-0f85d8192f90863dcLaunch instance eu-central-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-02c40c6d994943b85Launch instance eu-north-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-0719a9312994ac2cbLaunch instance ap-northeast-2amzn-ami-2018.03.p-amazon-ecs-optimized ami-07ef5505ecca20315Launch instance ap-northeast-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-047281402e27cf0c5Launch instance ap-southeast-2amzn-ami-2018.03.p-amazon-ecs-optimized ami-0f0ba4af21d1e1766Launch instance ap-southeast-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-04e47a1e7ce1d448aLaunch instance ca-central-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-0e73429acd3865bd2Launch instance ap-south-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-0cf953afde70921a2Launch instance sa-east-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-0656fd0f926c55fc6Launch instance us-gov-east-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-0c6b0b15e70eb6f3eLaunch instance us-gov-west-1amzn-ami-2018.03.p-amazon-ecs-optimized ami-22d3a443Launch instance -
- Windows
-
The following table lists the current Amazon ECS-optimized Windows AMI IDs by Region.
Region AMI ID us-east-2ami-00c56e74f090d6f65us-east-1ami-0ed2f29599018e745us-west-2ami-07f6b98dc6c8067c3us-west-1ami-01b55f7fe967f727beu-west-3ami-06a5b6fc522511993eu-west-2ami-0fac4f3bdab9ccddceu-west-1ami-04a2fa8ce0fc20c61eu-central-1ami-0f7386282aa13a0d8eu-north-1ami-06e3cb4d2875b172eap-northeast-2ami-071b78467d9d35580ap-northeast-1ami-07839df9eec55ac8dap-southeast-2ami-06d33f81ca8384556ap-southeast-1ami-0a6c13d83c0fdbf2bca-central-1ami-098ad73a3005be676ap-south-1ami-0183732d8e0fd56c7sa-east-1ami-05889298c47e6d5c2us-gov-east-1ami-0b6f703732ae49d69us-gov-west-1ami-9d91fafc
