You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Supported Kubernetes versions in Azure Kubernetes Service (AKS)
12
12
13
-
The Kubernetes community releases minor versions roughly every three months. Recently, the Kubernetes community has [increased the support window for each version from 9 months to 12 months](https://kubernetes.io/blog/2020/08/31/kubernetes-1-19-feature-one-year-support/), starting with version 1.19.
13
+
The Kubernetes community releases minor versions roughly every three months. Recently, the Kubernetes community has [increased the support window for each version from nine months to one year](https://kubernetes.io/blog/2020/08/31/kubernetes-1-19-feature-one-year-support/), starting with version 1.19.
14
14
15
15
Minor version releases include new features and improvements. Patch releases are more frequent (sometimes weekly) and are intended for critical bug fixes within a minor version. Patch releases include fixes for security vulnerabilities or major bugs.
16
16
@@ -42,9 +42,9 @@ Aim to run the latest patch release of the minor version you're running. For exa
42
42
> [!NOTE]
43
43
> Alias minor version requires Azure CLI version 2.37 or above. Use `az upgrade` to install the latest version of the CLI.
44
44
45
-
With AKS, you can create a cluster without specifying the exact patch version. When creating a cluster without designating a patch, the cluster will run the minor version's latest GA patch. For example, if you create a cluster with **`1.21`**, your cluster will run **`1.21.7`**, which is the latest GA patch version of *1.21*.
45
+
With AKS, you can create a cluster without specifying the exact patch version. When you create a cluster without designating a patch, the cluster will run the minor version's latest GA patch. For example, if you create a cluster with **`1.21`**, your cluster will run **`1.21.7`**, which is the latest GA patch version of *1.21*.
46
46
47
-
When upgrading by alias minor version, only a higher minor version is supported. For example, upgrading from `1.14.x` to `1.14`will not trigger an upgrade to the latest GA `1.14` patch, but upgrading to `1.15` will trigger an upgrade to the latest GA `1.15` patch.
47
+
When you upgrade by alias minor version, only a higher minor version is supported. For example, upgrading from `1.14.x` to `1.14`won't trigger an upgrade to the latest GA `1.14` patch, but upgrading to `1.15` will trigger an upgrade to the latest GA `1.15` patch.
48
48
49
49
To see what patch you're on, run the `az aks show --resource-group myResourceGroup --name myAKSCluster` command. The `currentKubernetesVersion` property shows the whole Kubernetes version.
50
50
@@ -141,8 +141,8 @@ You can reference upcoming version releases and deprecations on the [AKS Kuberne
141
141
142
142
For new **minor** versions of Kubernetes:
143
143
144
-
* AKS publishes a pre-announcement with the planned date of a new version release and respective old version deprecationon the [AKS release notes](https://aka.ms/aks/releasenotes) at least 30 days prior to removal.
145
-
* AKS uses [Azure Advisor](../advisor/advisor-overview.md) to alert users if a new version will cause issues in their cluster because of deprecated APIs. Azure Advisor is also used to alert the user if they are currently out of support.
144
+
* AKS publishes a pre-announcement with the planned date of the new version release and respective old version deprecation. This announcement is published on the [AKS release notes](https://aka.ms/aks/releasenotes) at least 30 days before removal.
145
+
* AKS uses [Azure Advisor](../advisor/advisor-overview.md) to alert users if a new version will cause issues in their cluster because of deprecated APIs. Azure Advisor is also used to alert the user if they're currently out of support.
146
146
* AKS publishes a [service health notification](../service-health/service-health-overview.md) available to all users with AKS and portal access and sends an email to the subscription administrators with the planned version removal dates.
147
147
148
148
> [!NOTE]
@@ -206,11 +206,11 @@ For the past release history, see [Kubernetes](https://en.wikipedia.org/wiki/Kub
206
206
207
207
### How does Microsoft notify me of new Kubernetes versions?
208
208
209
-
The AKS team publishes pre-announcements with planned dates of the new Kubernetes versions in our documentation, our [GitHub](https://github.com/Azure/AKS/releases), and emails to subscription administrators who own clusters that are going to fall out of support. In addition to announcements, AKS also uses [Azure Advisor](../advisor/advisor-overview.md) to notify the customer inside the Azure portal to alert users if they are out of support, and alerts them of deprecated APIs that will affect their application or development processes.
209
+
The AKS team publishes pre-announcements with planned dates of the new Kubernetes versions in the AKS docs, our [GitHub](https://github.com/Azure/AKS/releases), and emails to subscription administrators who own clusters that are going to fall out of support. AKS also uses [Azure Advisor](../advisor/advisor-overview.md) to alert customers in the Azure portal to notify users if they're out of support. It also alerts them of deprecated APIs that will affect their application or development processes.
210
210
211
211
### How often should I expect to upgrade Kubernetes versions to stay in support?
212
212
213
-
Starting with Kubernetes 1.19, the [open source community has expanded support to 1 year](https://kubernetes.io/blog/2020/08/31/kubernetes-1-19-feature-one-year-support/). AKS commits to enabling patches and support matching the upstream commitments. For AKS clusters on 1.19 and greater, you'll be able to upgrade at a minimum of once a year to stay on a supported version.
213
+
Starting with Kubernetes 1.19, the [open source community has expanded support to one year](https://kubernetes.io/blog/2020/08/31/kubernetes-1-19-feature-one-year-support/). AKS commits to enabling patches and support matching the upstream commitments. For AKS clusters on 1.19 and greater, you'll be able to upgrade at a minimum of once a year to stay on a supported version.
214
214
215
215
### What happens when a user upgrades a Kubernetes cluster with a minor version that isn't supported?
216
216
@@ -219,7 +219,7 @@ If you're on the *n-3* version or older, it means you're outside of support and
219
219
* If the oldest supported AKS version is *1.15.a* and you're on *1.14.b* or older, you're outside of support.
220
220
* When you successfully upgrade from *1.14.b* to *1.15.a* or higher, you're back within our support policies.
221
221
222
-
Downgrades are not supported.
222
+
Downgrades aren't supported.
223
223
224
224
### What does 'Outside of Support' mean?
225
225
@@ -232,19 +232,19 @@ Additionally, AKS doesn't make any runtime or other guarantees for clusters outs
232
232
233
233
### What happens when a user scales a Kubernetes cluster with a minor version that isn't supported?
234
234
235
-
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.
235
+
For minor versions not supported by AKS, scaling in or out should continue to work. Since there are no guarantees with quality of service, we recommend upgrading to bring your cluster back into support.
236
236
237
237
### Can a user stay on a Kubernetes version forever?
238
238
239
239
If a cluster has been out of support for more than three (3) minor versions and has been found to carry security risks, Azure proactively contacts you to upgrade your cluster. If you don't take further action, Azure reserves the right to automatically upgrade your cluster on your behalf.
240
240
241
-
### What version does the control plane support if the node pool is not in one of the supported AKS versions?
241
+
### What version does the control plane support if the node pool isn't in one of the supported AKS versions?
242
242
243
243
The control plane must be within a window of versions from all node pools. For details on upgrading the control plane or node pools, visit documentation on [upgrading node pools](use-multiple-node-pools.md#upgrade-a-cluster-control-plane-with-multiple-node-pools).
244
244
245
245
### Can I skip multiple AKS versions during cluster upgrade?
246
246
247
-
When you upgrade a supported AKS cluster, Kubernetes minor versions cannot be skipped. Kubernetes control planes [version skew policy](https://kubernetes.io/releases/version-skew-policy/) doesn't support minor version skipping. For example, upgrades between:
247
+
When you upgrade a supported AKS cluster, Kubernetes minor versions can't be skipped. Kubernetes control planes [version skew policy](https://kubernetes.io/releases/version-skew-policy/) doesn't support minor version skipping. For example, upgrades between:
248
248
249
249
**1.12.x* -> *1.13.x*: allowed.
250
250
**1.13.x* -> *1.14.x*: allowed.
@@ -261,11 +261,11 @@ When performing an upgrade from an _unsupported version_ that skips two or more
261
261
262
262
### Can I create a new 1.xx.x cluster during its 30 day support window?
263
263
264
-
No. Once a version is deprecated/removed, you cannot create a cluster with that version. As the change rolls out, you'll start to see the old version removed from your version list. This process may take up to two weeks from announcement, progressively by region.
264
+
No. Once a version is deprecated/removed, you can't create a cluster with that version. As the change rolls out, you'll start to see the old version removed from your version list. This process may take up to two weeks from announcement, progressively by region.
265
265
266
-
### I am on a freshly deprecated version, can I still add new node pools? Or will I have to upgrade?
266
+
### I'm on a freshly deprecated version, can I still add new node pools? Or will I have to upgrade?
267
267
268
-
No. You will not be allowed to add node pools of the deprecated version to your cluster. You can add node pools of a new version. However, this may require you to update the control plane first.
268
+
No. You won't be allowed to add node pools of the deprecated version to your cluster. You can add node pools of a new version, but this may require you to update the control plane first.
0 commit comments