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
Copy file name to clipboardExpand all lines: support/azure/azure-kubernetes/error-codes/aks-upgrade-blocked.md
+5-8Lines changed: 5 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool
13
13
## Prerequisites
14
14
15
15
This article requires Azure CLI version 2.67.0 or a later version.
16
-
To find the version number, run `az --version`. If you have to install or
16
+
To find the version number, run `az --version`. If you need to install or
17
17
upgrade Azure CLI, see [How to install the Azure CLI](/cli/azure/install-azure-cli).
18
18
19
19
For more detailed information about the upgrade process, see the "Upgrade an AKS cluster" section in
@@ -51,9 +51,7 @@ The upgrade is not allowed due to one or more of the following reasons:
51
51
52
52
- Skipping minor versions during upgrades (e.g., from 1.24.x to 1.26.x or 1.27.x) is not allowed unless the current version is unsupported.
53
53
54
-
- A control plane and node pool version skew (**NodePoolMcVersionIncompatible**) occurred when attempting to
55
-
upgrade only the control plane while the nodepool version is too far behind causing a big gap such that the
56
-
node pool version is more than three minor versions behind the control plane version.
54
+
- A control plane and node pool version skew (**NodePoolMcVersionIncompatible**) occurred when attempting to upgrade only the control plane while the nodepool version is too far behind causing a big gap such that the node pool version is more than three minor versions behind the control plane version.
57
55
58
56
To understand more about these errors, you can refer to following articles:
59
57
@@ -67,20 +65,19 @@ To understand more about these errors, you can refer to following articles:
67
65
Run the following command to view the current Kubernetes version and supported upgrade targets:
68
66
69
67
```azurecli
70
-
az aks get-upgrades --resource-group <RG> --name <ClusterName> --output table`
68
+
az aks get-upgrades --resource-group <RG> --name <ClusterName> --output table
71
69
```
72
70
73
71
If only newer versions such as 1.29.x are listed, and intermediate versions like 1.25.x, 1.26.x, or 1.27.x are missing, this indicates that
74
72
those versions are deprecated in your region.
75
73
76
74
### Step 2: Attempt full upgrade (control plane and node pool together)
77
75
78
-
Due to the version skew policy (**control planes cannot be more than three minor versions ahead of node pools**),
76
+
Due to the version skew policy (**control planes cannot be more than 3 minor versions ahead of node pools**),
79
77
a separate control-plane-only upgrade may not be allowed. Instead, upgrade both the control plane and node pool together:
80
78
81
79
```azurecli
82
-
az aks upgrade --resource-group <RG> --name <ClusterName>
0 commit comments