Amazon ECS-optimized AMI
An Amazon ECS container instance specification consists of the following components.
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 container agent version that you are using.
Recommended
-
An initialization and nanny process to run and monitor the Amazon ECS container agent. The Amazon ECS-optimized AMIs use the
ecs-initRPM to manage the agent. For more information, see theecs-initprojecton 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.
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 name, Amazon ECS container agent version, and ECS runtime version which includes the Docker version, for each variant can be retrieved programmatically. For more information, see Retrieving Amazon ECS-Optimized AMI metadata.
Amazon ECS-optimized AMI variants
The following variants of the Amazon ECS-optimized AMI are available for your Amazon EC2 instances.
Linux 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 – Based on Amazon Linux 2, this AMI is recommended for use when launching your instances, which are powered by Arm-based AWS Graviton/Graviton 2 Processors. For more information, see General Purpose Instances in the Amazon EC2 User Guide for Linux Instances.
-
Amazon ECS GPU-optimized AMI – Based on Amazon Linux 2, this AMI is recommended for use when launching your Amazon EC2 GPU-based instances. It comes pre-configured with NVIDIA kernel drivers and a Docker GPU runtime which makes running workloads that take advantage of GPUs on Amazon ECS. For more information, see Working with GPUs on Amazon ECS.
-
Amazon ECS-optimized Amazon Linux 2 (Inferentia) AMI – Based on Amazon Linux 2, this AMI is recommended for use when launching your Amazon EC2 Inf1 instances. It comes pre-configured with AWS Inferentia drivers and the AWS Neuron runtime for Docker which makes running machine learning inference workloads easier on Amazon ECS. For more information, see Working with inference workloads on Amazon ECS.
-
Amazon ECS-optimized Amazon Linux AMI – This AMI is based off of Amazon Linux. 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 is the same as the Amazon Linux AMI. For more information, see Amazon Linux AMI
. Important On April 15, 2021, the Amazon ECS-optimized Amazon Linux AMI ended its standard support phase and entered a maintenance support phase. In the maintenance support phase, Amazon ECS will continue providing critical and important security updates for a reduced list of packages. During this period, Amazon ECS will no longer add support for new EC2 instance types, new services and features, and new packages. Instead, Amazon ECS will provide updates only for critical and important security fixes that apply to a reduced set of packages. Maintenance support period will end on June 30, 2023.
Windows variants
The following Windows Server variants of the Amazon ECS-optimized AMI are available for your Amazon EC2 instances. For more information, see Windows containers.
-
Amazon ECS-optimized Windows Server 2019 Full AMI –
-
Amazon ECS-optimized Windows Server 2019 Core AMI –
-
Amazon ECS-optimized Windows Server 2004 Core AMI –
-
Amazon ECS-optimized Windows Server 20H2 Core AMI –
-
Amazon ECS-optimized Windows Server 2016 Full AMI –
Windows Server 2019 and Windows Server 2016 are Long-Term Servicing Channel (LTSC)
releases. Windows Server 2004 and Windows Server 20H2 are Semi-Annual Channel (SAC)
releases. For more information, see Windows Server release information
Linux Amazon ECS-optimized AMI
The following are the details for retrieving the AMI IDs for each of the Linux variants of the Amazon ECS-optimized AMI.
The latest Amazon ECS-optimized Amazon Linux 2 AMI can be retrieved using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended
The following table provides a link to retrieve the current Amazon ECS-optimized Amazon Linux 2 AMI IDs by Region.
|
Region Name |
Region |
AMI ID |
|---|---|---|
|
US East (Ohio) |
|
|
|
US East (N. Virginia) |
|
|
|
US West (N. California) |
|
|
|
US West (Oregon) |
|
|
|
Africa (Cape Town) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Stockholm) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (London) |
|
|
|
Europe (Milan) |
|
|
|
Europe (Paris) |
|
|
|
Middle East (Bahrain) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions of
the Amazon ECS-optimized Amazon Linux 2 AMI and their corresponding versions of the
Amazon ECS container agent,
Docker, and the ecs-init package, see Linux Amazon ECS-optimized AMIs
versions.
The current Amazon ECS-optimized Amazon Linux 2 (arm64) AMI can be retrieved using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended
The following table provides a link to retrieve the current Amazon ECS-optimized Amazon Linux 2 (arm64) AMI IDs by Region.
|
Region Name |
Region |
AMI ID |
|---|---|---|
|
US East (Ohio) |
|
|
|
US East (N. Virginia) |
|
|
|
US West (N. California) |
|
|
|
US West (Oregon) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (London) |
|
|
|
Europe (Stockholm) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions
of the Amazon ECS-optimized Amazon Linux 2 (arm64) AMI and their corresponding versions
of the Amazon ECS container
agent, Docker, and the ecs-init package, see Linux Amazon ECS-optimized AMIs
versions.
You can retrieve the current Amazon ECS GPU-optimized AMI using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended
The following table provides a link to retrieve the current Amazon ECS GPU-optimized AMI IDs by Region.
|
Region Name |
Region |
AMI ID |
|---|---|---|
|
US East (Ohio) |
|
|
|
US East (N. Virginia) |
|
|
|
US West (N. California) |
|
|
|
US West (Oregon) |
|
|
|
Africa (Cape Town) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Stockholm) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (London) |
|
|
|
Europe (Milan) |
|
|
|
Europe (Paris) |
|
|
|
Middle East (Bahrain) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions of
the Amazon ECS GPU-optimized AMI and their corresponding versions of the Amazon ECS
container agent,
Docker, the ecs-init package, and NVIDIA driver see Linux Amazon ECS-optimized AMIs
versions.
You can retrieve the current Amazon ECS-optimized Amazon Linux 2 (Inferentia) AMI using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/inf/recommended
The following table provides a link to retrieve the current Amazon ECS-optimized Amazon Linux 2 (Inferentia) AMI IDs by Region.
|
Region name |
Region |
AMI ID |
|---|---|---|
|
US East (N. Virginia) |
|
|
|
US East (Ohio) |
|
|
|
US West (Oregon) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Milan) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (Paris) |
|
|
|
Middle East (Bahrain) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions of
the Amazon ECS-optimized Amazon Linux 2 (Inferentia) AMI and their corresponding versions
of the Amazon ECS container agent,
Docker, and the ecs-init package see Linux Amazon ECS-optimized AMIs
versions.
On April 15, 2021, the Amazon ECS-optimized Amazon Linux AMI ended its standard support phase and entered a maintenance support phase. In the maintenance support phase, Amazon ECS will continue providing critical and important security updates for a reduced list of packages. During this period, Amazon ECS will no longer add support for new EC2 instance types, new services and features, and new packages. Instead, Amazon ECS will provide updates only for critical and important security fixes that apply to a reduced set of packages. Maintenance support period will end on June 30, 2023.
You can retrieve the current Amazon ECS-optimized Amazon Linux AMI using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux/recommended
The following table provides a link to retrieve the current Amazon ECS-optimized Amazon Linux AMI IDs by Region.
|
Region Name |
Region |
AMI ID |
|---|---|---|
|
US East (Ohio) |
|
|
|
US East (N. Virginia) |
|
|
|
US West (N. California) |
|
|
|
US West (Oregon) |
|
|
|
Africa (Cape Town) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Stockholm) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (London) |
|
|
|
Europe (Milan) |
|
|
|
Europe (Paris) |
|
|
|
Middle East (Bahrain) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions of the
Amazon ECS-optimized Amazon Linux 2 (Inferentia) AMI and their corresponding versions
of the Amazon ECS container agent,
Docker, and the ecs-init package see Linux Amazon ECS-optimized AMIs
versions.
Windows Amazon ECS-optimized AMI
The following are the details for retrieving the AMI IDs for each of the Windows variants of the Amazon ECS-optimized AMI. You can subscribe to the Windows AMI Amazon SNS topics to be notified when a new AMI is released or an AMI version is marked private. For more information, see Windows Amazon ECS-optimized AMIs.
To ensure that customers have the latest security updates by default, Amazon ECS maintains at least the last three Windows Amazon ECS-optimized AMIs. After releasing new Windows Amazon ECS-optimized AMIs, Amazon ECS makes the Windows Amazon ECS-optimized AMIs that are older private. If there is a private AMI that you need access to, let us know by filing a ticket with Cloud Support.
The current Amazon ECS-optimized Windows Server 2019 Full AMI can be retrieved using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized
The following table provides a link to retrieve the current Amazon ECS-optimized Windows Server 2019 Full AMI IDs by Region.
|
Region Name |
Region |
AMI ID |
|---|---|---|
|
US East (Ohio) |
|
|
|
US East (N. Virginia) |
|
|
|
US West (N. California) |
|
|
|
US West (Oregon) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Stockholm) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (London) |
|
|
|
Europe (Paris) |
|
|
|
Middle East (Bahrain) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions of the Windows Server 2019 Full and their corresponding versions of the Amazon ECS container agent and Docker see Windows Amazon ECS-optimized AMIs versions.
The current Amazon ECS-optimized Windows Server 2019 Core AMI can be retrieved using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized
The following table provides a link to retrieve the current Amazon ECS-optimized Windows Server 2019 Core AMI IDs by Region.
|
Region Name |
Region |
AMI ID |
|---|---|---|
|
US East (Ohio) |
|
|
|
US East (N. Virginia) |
|
|
|
US West (N. California) |
|
|
|
US West (Oregon) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Stockholm) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (London) |
|
|
|
Europe (Paris) |
|
|
|
Middle East (Bahrain) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions of the Windows Server 2019 Core and their corresponding versions of the Amazon ECS container agent and Docker see Windows Amazon ECS-optimized AMIs versions.
The current Amazon ECS-optimized Windows Server 2004 Core AMI can be retrieved using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2004-English-Core-ECS_Optimized
The following table provides a link to retrieve the current Amazon ECS-optimized Windows Server 2004 Core AMI IDs by Region.
|
Region Name |
Region |
AMI ID |
|---|---|---|
|
US East (Ohio) |
|
|
|
US East (N. Virginia) |
|
|
|
US West (N. California) |
|
|
|
US West (Oregon) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Stockholm) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (London) |
|
|
|
Europe (Paris) |
|
|
|
Middle East (Bahrain) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions of the Amazon ECS-optimized Windows Server 2004 Core AMI and their corresponding versions of the Amazon ECS container agent and Docker see Windows Amazon ECS-optimized AMIs versions.
The current Amazon ECS-optimized Windows Server 20H2 Core AMI can be retrieved using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-20H2-English-Core-ECS_Optimized
The following table provides a link to retrieve the current Amazon ECS-optimized Windows Server 20H2 Core AMI IDs by Region.
|
Region name |
Region |
AMI ID |
|---|---|---|
|
US East (Ohio) |
|
|
|
US East (N. Virginia) |
|
|
|
US West (N. California) |
|
|
|
US West (Oregon) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Stockholm) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (London) |
|
|
|
Europe (Paris) |
|
|
|
Middle East (Bahrain) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions of the Windows Server 20H2 Core and their corresponding versions of the Amazon ECS container agent and Docker see Windows Amazon ECS-optimized AMIs versions.
The current Amazon ECS-optimized Windows Server 2016 Full AMI can be retrieved using the AWS CLI with the following command:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized
The following table provides a link to retrieve the current Amazon ECS-optimized Windows Server 2016 Full AMI IDs by Region.
|
Region Name |
Region |
AMI ID |
|---|---|---|
|
US East (Ohio) |
|
|
|
US East (N. Virginia) |
|
|
|
US West (N. California) |
|
|
|
US West (Oregon) |
|
|
|
Asia Pacific (Hong Kong) |
|
|
|
Asia Pacific (Tokyo) |
|
|
|
Asia Pacific (Seoul) |
|
|
|
Asia Pacific (Mumbai) |
|
|
|
Asia Pacific (Singapore) |
|
|
|
Asia Pacific (Sydney) |
|
|
|
Canada (Central) |
|
|
|
Europe (Frankfurt) |
|
|
|
Europe (Stockholm) |
|
|
|
Europe (Ireland) |
|
|
|
Europe (London) |
|
|
|
Europe (Paris) |
|
|
|
Middle East (Bahrain) |
|
|
|
South America (São Paulo) |
|
|
|
AWS GovCloud (US-East) |
|
|
|
AWS GovCloud (US-West) |
|
|
|
China (Beijing) |
|
|
|
China (Ningxia) |
|
For a full list of current and previous versions of the Amazon ECS-optimized Windows Server 2016 Full AMI and their corresponding versions of the Amazon ECS container agent and Docker see Windows Amazon ECS-optimized AMIs versions.
