Help improve this page
Want to contribute to this user guide? Scroll to the bottom of this page and select Edit this page on GitHub. Your contributions will help make our user guide better for everyone.
Create nodes with optimized Amazon Linux AMIs
The Amazon EKS optimized Amazon Linux AMIs are built on top of Amazon Linux 2 (AL2) and Amazon Linux 2023 (AL2023). They are configured to serve as the base images for Amazon EKS nodes. The AMIs are configured to work with Amazon EKS and they include the following components:
-
kubelet
-
AWS IAM Authenticator
-
Docker (Amazon EKS version
1.23
and earlier) -
containerd
Note
-
You can track security or privacy events for Amazon Linux at the Amazon Linux security center
by choosing the tab for your desired version. You can also subscribe to the applicable RSS feed. Security and privacy events include an overview of the issue, what packages are affected, and how to update your instances to correct the issue. -
Before deploying an accelerated or Arm AMI, review the information in Amazon EKS optimized accelerated Amazon Linux AMIs and Amazon EKS optimized Arm Amazon Linux AMIs.
-
For Kubernetes version
1.23
, you can use an optional bootstrap flag to test migration from Docker tocontainerd
. For more information, see Test Amazon Linux 2 migration from Docker to containerd. -
Amazon EC2
P2
instances aren’t supported on Amazon EKS because they requireNVIDIA
driver version 470 or earlier. -
Any newly created managed node groups in clusters on version
1.30
or newer will automatically default to using AL2023 as the node operating system. Previously, new node groups would default to AL2. You can continue to use AL2 by choosing it as the AMI type when creating a new node group. -
Support for AL2 will end on June 30th, 2025. For more information, see Amazon Linux 2 FAQs
.
Amazon EKS optimized accelerated Amazon Linux AMIs
The Amazon EKS optimized accelerated Amazon Linux AMIs are built on top of the standard Amazon EKS optimized Amazon Linux AMIs. They are configured to serve as optional images for Amazon EKS nodes to support GPU, Inferentia
In addition to the standard Amazon EKS optimized AMI configuration, the accelerated AMIs include the following:
-
NVIDIA drivers
-
nvidia-container-toolkit
-
AWS Neuron driver
For a list of the latest components included in the accelerated AMIs, see the amazon-eks-ami
Releases
Note
-
Make sure to specify the applicable instance type in your node AWS CloudFormation template. By using the Amazon EKS optimized accelerated AMIs, you agree to NVIDIA’s Cloud End User License Agreement (EULA)
. -
The Amazon EKS optimized accelerated AMIs were previously referred to as the Amazon EKS optimized AMIs with GPU support.
-
Previous versions of the Amazon EKS optimized accelerated AMIs installed the
nvidia-docker
repository. The repository is no longer included in Amazon EKS AMI versionv20200529
and later.
For details on running workloads on Amazon EKS optimized accelerated Amazon Linux AMIs, see Run GPU-accelerated containers (Linux on EC2).
Amazon EKS optimized Arm Amazon Linux AMIs
Arm instances deliver significant cost savings for scale-out and Arm-based applications such as web servers, containerized microservices, caching fleets, and distributed data stores. When adding Arm nodes to your cluster, review the following considerations.
-
If your cluster was deployed before August 17, 2020, you must do a one-time upgrade of critical cluster add-on manifests. This is so that Kubernetes can pull the correct image for each hardware architecture in use in your cluster. For more information about updating cluster add-ons, see Step 1: Prepare for upgrade. If you deployed your cluster on or after August 17, 2020, then your CoreDNS,
kube-proxy
, and Amazon VPC CNI plugin for Kubernetes add-ons are already multi-architecture capable. -
Applications deployed to Arm nodes must be compiled for Arm.
-
If you have DaemonSets that are deployed in an existing cluster, or you want to deploy them to a new cluster that you also want to deploy Arm nodes in, then verify that your DaemonSet can run on all hardware architectures in your cluster.
-
You can run Arm node groups and x86 node groups in the same cluster. If you do, consider deploying multi-architecture container images to a container repository such as Amazon Elastic Container Registry and then adding node selectors to your manifests so that Kubernetes knows what hardware architecture a Pod can be deployed to. For more information, see Pushing a multi-architecture image in the Amazon ECR User Guide and the Introducing multi-architecture container images for Amazon ECR
blog post.
More information
For more information about using Amazon EKS optimized Amazon Linux AMIs, see the following sections:
-
To use Amazon Linux with managed node groups, see Simplify node lifecycle with managed node groups.
-
To launch self-managed Amazon Linux nodes, see Retrieve recommended Amazon Linux AMI IDs.
-
For version information, see Retrieve Amazon Linux AMI version information.
-
To retrieve the latest IDs of the Amazon EKS optimized Amazon Linux AMIs, see Retrieve recommended Amazon Linux AMI IDs.
-
For open-source scripts that are used to build the Amazon EKS optimized AMIs, see Build a custom Amazon Linux AMI with a script.