How to upgrade from EKS AL2 to EKS AL2023
The Amazon EKS optimized AMIs are available in two families based on Amazon Linux 2 (AL2) and Amazon Linux 2023 (AL2023). AL2023 is a new Linux-based operating system designed to provide a secure, stable, and high-performance environment for your cloud applications. For more information about the differences between AL2 and AL2023 see Upgrade from Amazon Linux 2 to Amazon Linux 2023 in the Amazon EKS User Guide.
Depending on how your compute environment is configured you can use one of the following upgrade path from AL2 to AL2023.
Upgrade using Ec2Configuraiton.ImageType
-
If you are not using a launch template or launch template overrides then change Ec2Configuraiton.ImageType to
EKS_AL2023orEKS_AL2023_NVIDIAand the run UpdateComputeEnvironment. -
If you specify an Ec2Configuration.ImageIdOverride then Ec2Configuration.ImageType must match the AMI type specified in Ec2Configuration.ImageIdOverride.
If you mismatch
ImageIdOverrideandImageTypethen the node won't join the cluster.
Upgrade using launch templates
-
If you have any
kubeletextra arguments defined in a launch template or launch template override, they need to updated to the new kubelet extra arguments format.If you mismatch the
kubeletextra arguments format then the extra arguments aren't applied. -
For AL2023 AMIs, containerd is the only supported container runtime. You do not need to specify container runtime for
EKS_AL2023in the launch template.You can't specify a customised container runtime with
EKS_AL2023. If you use a launch template or launch template override that specifies an AMI based on
EKS_AL2023then you need to set userdataType toEKS_NODEADM.If you mismatch the
userdataTypeand AMI then the node won't join the EKS cluster.