Help improve this page
To contribute to this user guide, choose the Edit this page on GitHub link that is located in the right pane of every page.
This topic gives important changes to be aware of for each Kubernetes version in extended support. When upgrading, carefully review the changes that have occurred between the old and new versions for your cluster.
Kubernetes 1.28
Kubernetes 1.28
is now available in Amazon EKS. For more information about Kubernetes 1.28
, see the official release announcement
-
Kubernetes
v1.28
expanded the supported skew between core node and control plane components by one minor version, fromn-2
ton-3
, so that node components (kubelet
andkube-proxy
) for the oldest supported minor version can work with control plane components (kube-apiserver
,kube-scheduler
,kube-controller-manager
,cloud-controller-manager
) for the newest supported minor version. -
Metrics
force_delete_pods_total
andforce_delete_pod_errors_total
in thePod GC Controller
are enhanced to account for all forceful pods deletion. A reason is added to the metric to indicate whether the pod is forcefully deleted because it’s terminated, orphaned, terminating with the out-of-service taint, or terminating and unscheduled. -
The
PersistentVolume (PV)
controller has been modified to automatically assign a defaultStorageClass
to any unboundPersistentVolumeClaim
with thestorageClassName
not set. Additionally, thePersistentVolumeClaim
admission validation mechanism within the API server has been adjusted to allow changing values from an unset state to an actualStorageClass
name.
For the complete Kubernetes 1.28
changelog, see https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.28.md#changelog-since-v1270
Kubernetes 1.27
Kubernetes 1.27
is now available in Amazon EKS. For more information about Kubernetes 1.27
, see the official release announcement
Important
-
The support for the alpha
seccomp
annotationsseccomp.security.alpha.kubernetes.io/pod
andcontainer.seccomp.security.alpha.kubernetes.io
annotations was removed. The alphaseccomp
annotations was deprecated in1.19
, and with their removal in1.27
,seccomp
fields will no longer auto-populate forPods
withseccomp
annotations. Instead, use thesecurityContext.seccompProfile
field forPods
or containers to configureseccomp
profiles. To check whether you are using the deprecated alphaseccomp
annotations in your cluster, run the following command:kubectl get pods --all-namespaces -o json | grep -E 'seccomp.security.alpha.kubernetes.io/pod|container.seccomp.security.alpha.kubernetes.io'
-
The
--container-runtime
command line argument for thekubelet
was removed. The default container runtime for Amazon EKS has beencontainerd
since1.24
, which eliminates the need to specify the container runtime. From1.27
onwards, Amazon EKS will ignore the--container-runtime
argument passed to any bootstrap scripts. It is important that you don’t pass this argument to--kubelet-extra-args
in order to prevent errors during the node bootstrap process. You must remove the--container-runtime
argument from all of your node creation workflows and build scripts.
-
The
kubelet
in Kubernetes1.27
increased the defaultkubeAPIQPS
to50
andkubeAPIBurst
to100
. These enhancements allow thekubelet
to handle a higher volume of API queries, improving response times and performance. When the demands forPods
increase, due to scaling requirements, the revised defaults ensure that thekubelet
can efficiently manage the increased workload. As a result,Pod
launches are quicker and cluster operations are more effective. -
You can use more fine grained
Pod
topology to spread policies such asminDomain
. This parameter gives you the ability to specify the minimum number of domains yourPods
should be spread across.nodeAffinityPolicy
andnodeTaintPolicy
allow for an extra level of granularity in governingPod
distribution. This is in accordance to node affinities, taints, and thematchLabelKeys
field in thetopologySpreadConstraints
of yourPod’s
specification. This permits the selection ofPods
for spreading calculations following a rolling upgrade. -
Kubernetes
1.27
promoted to beta a new policy mechanism forStatefulSets
that controls the lifetime of theirPersistentVolumeClaims
(PVCs
). The newPVC
retention policy lets you specify if thePVCs
generated from theStatefulSet
spec template will be automatically deleted or retained when theStatefulSet
is deleted or replicas in theStatefulSet
are scaled down. -
The goaway-chance
option in the Kubernetes API server helps prevent HTTP/2
client connections from being stuck on a single API server instance, by randomly closing a connection. When the connection is closed, the client will try to reconnect, and will likely land on a different API server as a result of load balancing. Amazon EKS version1.27
has enabledgoaway-chance
flag. If your workload running on Amazon EKS cluster uses a client that is not compatible with HTTP GOAWAY, we recommend that you update your client to handle GOAWAY
by reconnecting on connection termination.
For the complete Kubernetes 1.27
changelog, see https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.27.md#changelog-since-v1260
Kubernetes 1.26
Kubernetes 1.26
is now available in Amazon EKS. For more information about Kubernetes 1.26
, see the official release announcement
Important
Kubernetes 1.26
no longer supports CRI v1alpha2
. This results in the kubelet
no longer registering the node if the container runtime doesn’t support CRI v1
. This also means that Kubernetes 1.26
doesn’t support containerd minor version 1.5
and earlier. If you’re using containerd, you need to upgrade to containerd version 1.6.0
or later before you upgrade any nodes to Kubernetes 1.26
. You also need to upgrade any other container runtimes that only support the v1alpha2
. For more information, defer to the container runtime vendor. By default, Amazon Linux and Bottlerocket AMIs include containerd version 1.6.6
.
-
Before you upgrade to Kubernetes
1.26
, upgrade your Amazon VPC CNI plugin for Kubernetes to version1.12
or later. If you don’t upgrade to Amazon VPC CNI plugin for Kubernetes version1.12
or later, the Amazon VPC CNI plugin for Kubernetes will crash. For more information, see Assign IPs to Pods with the Amazon VPC CNI. -
The goaway-chance
option in the Kubernetes API server helps prevent HTTP/2
client connections from being stuck on a single API server instance, by randomly closing a connection. When the connection is closed, the client will try to reconnect, and will likely land on a different API server as a result of load balancing. Amazon EKS version1.26
has enabledgoaway-chance
flag. If your workload running on Amazon EKS cluster uses a client that is not compatible with HTTP GOAWAY, we recommend that you update your client to handle GOAWAY
by reconnecting on connection termination.
For the complete Kubernetes 1.26
changelog, see https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.26.md#changelog-since-v1250
Kubernetes 1.25
Kubernetes 1.25
is now available in Amazon EKS. For more information about Kubernetes 1.25
, see the official release announcement
Important
-
Amazon EC2
P2
instances aren’t supported on Amazon EKS because they requireNVIDIA
driver version 470 or earlier. -
PodSecurityPolicy
(PSP) is removed in Kubernetes1.25
. PSPs are replaced with Pod Security Admission (PSA)and Pod Security Standards (PSS). PSA is a built-in admission controller that implements the security controls outlined in the PSS . PSA and PSS are graduated to stable in Kubernetes 1.25
and are enabled in Amazon EKS by default. If you have PSPs in your cluster, make sure to migrate from PSP to the built-in Kubernetes PSS or to a policy-as-code solution before upgrading your cluster to version1.25
. If you don’t migrate from PSP, you might encounter interruptions to your workloads. For more information, see the Migrate from legacy Pod security policies (PSP). -
Kubernetes version
1.25
contains changes that alter the behavior of an existing feature known as API Priority and Fairness (APF). APF serves to shield the API server from potential overload during periods of heightened request volumes. It does this by placing restrictions on the number of concurrent requests that can be processed at any given time. This is achieved through the application of distinct priority levels and limits to requests originating from various workloads or users. This approach ensures that critical applications or high-priority requests receive preferential treatment, while simultaneously preventing lower priority requests from overwhelming the API server. For more information, see API Priority and Fairnessin the Kubernetes documentation or API Priority and Fairness in the EKS Best Practices Guide. These updates were introduced in PR #10352
and PR #118601 . Previously, APF treated all types of requests uniformly, with each request consuming a single unit of the concurrent request limit. The APF behavior change assigns higher units of concurrency to LIST
requests due to the exceptionally heavy burden put on the API server by these requests. The API server estimates the number of objects that will be returned by aLIST
request. It assigns a unit of concurrency that is proportional to the number of objects returned.Upon upgrading to Amazon EKS version
1.25
or higher, this updated behavior might cause workloads with heavyLIST
requests (that previously functioned without issue) to encounter rate limiting. This would be indicated by an HTTP 429 response code. To avoid potential workload disruption due toLIST
requests being rate limited, we strongly encourage you to restructure your workloads to reduce the rate of these requests. Alternatively, you can address this issue by adjusting the APF settings to allocate more capacity for essential requests while reducing the capacity allocated to non-essential ones. For more information about these mitigation techniques, see Preventing Dropped Requestsin the EKS Best Practices Guide. -
Amazon EKS
1.25
includes enhancements to cluster authentication that contain updated YAML libraries. If a YAML value in theaws-auth
ConfigMap
found in thekube-system
namespace starts with a macro, where the first character is a curly brace, you should add quotation marks (" "
) before and after the curly braces ({ }
). This is required to ensure thataws-iam-authenticator
versionv0.6.3
accurately parses theaws-auth
ConfigMap
in Amazon EKS1.25
. -
The beta API version (
discovery.k8s.io/v1beta1
) ofEndpointSlice
was deprecated in Kubernetes1.21
and is no longer served as of Kubernetes1.25
. This API has been updated todiscovery.k8s.io/v1
. For more information, see EndpointSlicein the Kubernetes documentation. The AWS Load Balancer Controller v2.4.6
and earlier used thev1beta1
endpoint to communicate withEndpointSlices
. If you’re using theEndpointSlices
configuration for the AWS Load Balancer Controller, you must upgrade to AWS Load Balancer Controllerv2.4.7
before upgrading your Amazon EKS cluster to1.25
. If you upgrade to1.25
while using theEndpointSlices
configuration for the AWS Load Balancer Controller, the controller will crash and result in interruptions to your workloads. To upgrade the controller, see Route internet traffic with AWS Load Balancer Controller. -
The beta API version (
autoscaling/v2beta1
) of HorizontalPodAutoscaler is no longer served as of Kubernetes1.25
. This API was deprecated in version1.23
. Migrate manifests and API clients to use theautoscaling/v2
HorizontalPodAutoscaler API version. For more information, see the Kubernetes documentation.
-
SeccompDefault
is promoted to beta in Kubernetes1.25
. By setting the--seccomp-default
flag when you configurekubelet
, the container runtime uses itsRuntimeDefaultseccomp
profile, rather than the unconfined (seccomp disabled
) mode. The default profiles provide a strong set of security defaults, while preserving the functionality of the workload. Although this flag is available, Amazon EKS doesn’t enable this flag by default, so Amazon EKS behavior is effectively unchanged. If you want to, you can start enabling this on your nodes. For more details, see the tutorial Restrict a Container’s Syscalls with seccompin the Kubernetes documentation. -
Support for the Container Runtime Interface (CRI) for Docker (also known as dockershim) was removed from Kubernetes
1.24
and later. The only container runtime in Amazon EKS official AMIs for Kubernetes1.24
and later clusters is containerd. Before upgrading to Amazon EKS1.24
or later, remove any reference to bootstrap script flags that aren’t supported anymore. For more information, see Migrate from dockershim to containerd. -
The support for wildcard queries was deprecated in CoreDNS
1.8.7
and removed in CoreDNS1.9
. This was done as a security measure. Wildcard queries no longer work and return NXDOMAIN instead of an IP address. -
The goaway-chance
option in the Kubernetes API server helps prevent HTTP/2
client connections from being stuck on a single API server instance, by randomly closing a connection. When the connection is closed, the client will try to reconnect, and will likely land on a different API server as a result of load balancing. Amazon EKS version1.25
has enabledgoaway-chance
flag. If your workload running on Amazon EKS cluster uses a client that is not compatible with HTTP GOAWAY, we recommend that you update your client to handle GOAWAY
by reconnecting on connection termination.
For the complete Kubernetes 1.25
changelog, see https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.25.md#changelog-since-v1240