Events
Mar 17, 9 PM - Mar 21, 10 AM
Join the meetup series to build scalable AI solutions based on real-world use cases with fellow developers and experts.
Register nowThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
This article describes the supported Kubernetes versions for Azure Kubernetes Service enabled by Azure Arc. AKS Arc releases new Kubernetes minor versions approximately every three months.
Kubernetes uses the standard Semantic Versioning versioning scheme for each version:
[major].[minor].[patch]
Example:
1.29.2
1.29.5
Each number in the version indicates general compatibility with the previous version:
You should install the latest patch release of the minor version you're running. For example, if your production cluster is on 1.29.2
. 1.29.5
is the latest available patch version available for the 1.29 series, you should upgrade to 1.29.5 as soon as possible to ensure your Kubernetes cluster is fully patched and supported.
K8s minor version | Supported Azure Local versions | Current status | Last release with Kubernetes patch/CVE updates |
---|---|---|---|
1.30 | TBD | Upcoming | TBD |
1.29 | 2411, 2408 | Generally available | TBD |
1.28 | 2411, 2408, 2405 | Generally available | TBD |
1.27 | 2411, 2408, 2405, 2402 | Generally available | 2411 release |
1.26 | 2405, 2402 and older | No more patch versions/CVE updates | 2405 release |
Release | Supported minor & patch versions |
---|---|
2411 | 1.27.7, 1.27.9, 1.28.5, 1.28.9, 1.29.2, 1.29.4 |
2408 | 1.27.7, 1.27.9, 1.28.5, 1.28.9, 1.29.2, 1.29.4 |
2405 | 1.26.10, 1.26.12, 1.27.7, 1.27.9, 1.28.3, 1.28.5 |
AKS defines a generally available (GA) version as a version that's available for download when deploying or updating AKS enabled by Arc. AKS supports three GA minor versions of Kubernetes:
AKS might also support preview versions, which are explicitly labeled as previews.
Note
AKS uses safe deployment practices which involve gradual region deployment. This means it can take up to 10 business days for a new release or a new version to be available in all regions.
The supported window of Kubernetes versions on AKS is known as "N-2": (N (Latest release) - 2 (minor versions)).
For example, if AKS introduces 1.30 today, support is provided for the following versions:
New minor version | Supported Version List |
---|---|
1.30 | 1.30, 1.29, 1.28 |
When a new minor version is introduced, the oldest minor version and patch releases supported are deprecated and removed. For example, the current supported version list is:
When AKS releases 1.30.*, all the 1.27.* versions are removed and go out of support in 30 days.
Note
If you're running an unsupported Kubernetes version, you are asked to upgrade when requesting support for the cluster. Clusters running unsupported Kubernetes releases are not covered by the AKS support policies.
In addition to this policy, AKS supports a maximum of two patch releases of a given minor version. Given the following supported versions:
Current Supported Version List
------------------------------
1.29.8, 1.29.7, 1.28.10, 1.28.9
If AKS releases 1.29.9 and 1.28.11, the oldest patch versions are deprecated and removed, and the supported version list becomes:
New Supported Version List
----------------------
1.29.*9*, 1.29.*8*, 1.28.*11*, 1.28.*10*
You can use one minor version older or newer of kubectl
relative to your kube-apiserver version, consistent with the Kubernetes support policy for kubectl.
For example, if your kube-apiserver is at 1.17, then you can use versions 1.16 to 1.18 of kubectl
with that kube-apiserver.
To install or update your version of kubectl
, run az aks install-cli
.
For new minor versions of Kubernetes:
For new patch versions of Kubernetes:
AKS reserves the right to add or remove new/existing versions with one or more critical production-impacting bugs or security issues without advance notice.
Specific patch releases may be skipped or rollout accelerated, depending on the severity of the bug or security issue.
The AKS team publishes pre-announcements with planned dates of new Kubernetes versions in the AKS Arc documentation.
Starting with Kubernetes 1.19, the open source community expanded support to one year. AKS commits to enabling patches and support matching the upstream commitments. For Kubernetes clusters on 1.19 and greater, you'll be able to upgrade a minimum of once a year to stay on a supported version.
If you're on the n-3 version or older, it means you're outside of support and are asked to upgrade. When your upgrade from version n-3 to n-2 succeeds, you're back within our support policies. For example:
Downgrades are not supported.
"Outside of support" means that:
Additionally, AKS doesn't make any runtime (or other) guarantees for clusters outside of the supported versions list.
For minor versions not supported by AKS, scaling in or out should continue to work. Since there are no Quality of Service guarantees, we recommend upgrading to bring your cluster back into support.
When you upgrade a supported AKS cluster, Kubernetes minor versions can't be skipped. For example, upgrades between:
To upgrade from 1.12.x -> 1.14.x:
You can only skip multiple versions when upgrading from an unsupported version back into a supported version. For example, you can upgrade from an unsupported 1.10.x to a supported 1.15.x.
No. Once a version is deprecated/removed, you cannot create a cluster with that version. As the change rolls out, you see the old version removed from your version list. This process can take up to two weeks from the announcement, progressively by region.
No. You can't add node pools from the deprecated version to your cluster.
For information about how to upgrade your cluster, see Update the Kubernetes version of AKS clusters.
Events
Mar 17, 9 PM - Mar 21, 10 AM
Join the meetup series to build scalable AI solutions based on real-world use cases with fellow developers and experts.
Register nowTraining
Module
Apply cluster upgrades and security patches with Azure Kubernetes Service - Training
Apply the latest version upgrades and patches to your Azure Kubernetes Service clusters.