Skip to content

Commit 27d815c

Browse files
committed
Improving Acrolinx score
1 parent f2f9398 commit 27d815c

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

articles/aks/supported-kubernetes-versions.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.custom: devx-track-azurepowershell, event-tier1-build-2022
1010

1111
# Supported Kubernetes versions in Azure Kubernetes Service (AKS)
1212

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.
1414

1515
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.
1616

@@ -42,9 +42,9 @@ Aim to run the latest patch release of the minor version you're running. For exa
4242
> [!NOTE]
4343
> Alias minor version requires Azure CLI version 2.37 or above. Use `az upgrade` to install the latest version of the CLI.
4444
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*.
4646

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.
4848

4949
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.
5050

@@ -141,8 +141,8 @@ You can reference upcoming version releases and deprecations on the [AKS Kuberne
141141

142142
For new **minor** versions of Kubernetes:
143143

144-
* AKS publishes a pre-announcement with the planned date of a new version release and respective old version deprecation on 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.
146146
* 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.
147147

148148
> [!NOTE]
@@ -206,11 +206,11 @@ For the past release history, see [Kubernetes](https://en.wikipedia.org/wiki/Kub
206206

207207
### How does Microsoft notify me of new Kubernetes versions?
208208

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.
210210

211211
### How often should I expect to upgrade Kubernetes versions to stay in support?
212212

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.
214214

215215
### What happens when a user upgrades a Kubernetes cluster with a minor version that isn't supported?
216216

@@ -219,7 +219,7 @@ If you're on the *n-3* version or older, it means you're outside of support and
219219
* If the oldest supported AKS version is *1.15.a* and you're on *1.14.b* or older, you're outside of support.
220220
* When you successfully upgrade from *1.14.b* to *1.15.a* or higher, you're back within our support policies.
221221

222-
Downgrades are not supported.
222+
Downgrades aren't supported.
223223

224224
### What does 'Outside of Support' mean?
225225

@@ -232,19 +232,19 @@ Additionally, AKS doesn't make any runtime or other guarantees for clusters outs
232232

233233
### What happens when a user scales a Kubernetes cluster with a minor version that isn't supported?
234234

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.
236236

237237
### Can a user stay on a Kubernetes version forever?
238238

239239
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.
240240

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?
242242

243243
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).
244244

245245
### Can I skip multiple AKS versions during cluster upgrade?
246246

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:
248248

249249
* *1.12.x* -> *1.13.x*: allowed.
250250
* *1.13.x* -> *1.14.x*: allowed.
@@ -261,11 +261,11 @@ When performing an upgrade from an _unsupported version_ that skips two or more
261261

262262
### Can I create a new 1.xx.x cluster during its 30 day support window?
263263

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.
265265

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?
267267

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.
269269

270270
### How often do you update patches?
271271

0 commit comments

Comments
 (0)