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: articles/aks/tutorial-kubernetes-upgrade-cluster.md
+47-28Lines changed: 47 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Kubernetes on Azure tutorial - Upgrade an Azure Kubernetes Service (AKS) cluster
3
3
description: In this Azure Kubernetes Service (AKS) tutorial, you learn how to upgrade an existing AKS cluster to the latest available Kubernetes version.
4
4
ms.topic: tutorial
5
-
ms.date: 11/02/2023
5
+
ms.date: 06/10/2024
6
6
author: schaffererin
7
7
ms.author: schaffererin
8
8
@@ -40,27 +40,27 @@ If using Azure PowerShell, this tutorial requires Azure PowerShell version 5.9.0
40
40
az aks get-upgrades --resource-group myResourceGroup --name myAKSCluster
41
41
```
42
42
43
-
The following example output shows the current version as *1.26.6* and lists the available versions under `upgrades`:
43
+
The following example output shows the current version as *1.28.9* and lists the available versions under `upgrades`:
44
44
45
45
```output
46
-
{
47
-
"agentPoolProfiles": null,
48
-
"controlPlaneProfile": {
49
-
"kubernetesVersion": "1.26.6",
46
+
{
47
+
"agentPoolProfiles": null,
48
+
"controlPlaneProfile": {
49
+
"kubernetesVersion": "1.28.9",
50
+
...
51
+
"upgrades": [
52
+
{
53
+
"isPreview": null,
54
+
"kubernetesVersion": "1.29.4"
55
+
},
56
+
{
57
+
"isPreview": null,
58
+
"kubernetesVersion": "1.29.2"
59
+
}
60
+
]
61
+
},
50
62
...
51
-
"upgrades": [
52
-
{
53
-
"isPreview": null,
54
-
"kubernetesVersion": "1.27.1"
55
-
},
56
-
{
57
-
"isPreview": null,
58
-
"kubernetesVersion": "1.27.3"
59
-
}
60
-
]
61
-
},
62
-
...
63
-
}
63
+
}
64
64
```
65
65
66
66
### [Azure PowerShell](#tab/azure-powershell)
@@ -136,30 +136,46 @@ You can either [manually upgrade your cluster](#manually-upgrade-cluster) or [co
136
136
--kubernetes-version KUBERNETES_VERSION
137
137
```
138
138
139
+
* You will be prompted to confirm the upgrade operation, and to confirm that you want to upgrade the control plane *and* all the node pools to the selected version of Kubernetes:
140
+
141
+
```console
142
+
Are you sure you want to perform this operation? (y/N): y
143
+
Since control-plane-only argument is not specified, this will upgrade the control plane AND all nodepools to version 1.29.2. Continue? (y/N): y
144
+
```
145
+
139
146
> [!NOTE]
140
147
> You can only upgrade one minor version at a time. For example, you can upgrade from *1.14.x* to *1.15.x*, but you can't upgrade from *1.14.x* to *1.16.x* directly. To upgrade from *1.14.x* to *1.16.x*, you must first upgrade from *1.14.x* to *1.15.x*, then perform another upgrade from *1.15.x* to *1.16.x*.
141
148
142
-
The following example output shows the result of upgrading to *1.27.3*. Notice the `kubernetesVersion` now shows *1.27.3*:
149
+
The following example output shows the result of upgrading to *1.29.2*. Notice the `kubernetesVersion` now shows *1.29.2*:
@@ -174,12 +190,12 @@ You can either [manually upgrade your cluster](#manually-upgrade-cluster) or [co
174
190
> [!NOTE]
175
191
> You can only upgrade one minor version at a time. For example, you can upgrade from *1.14.x* to *1.15.x*, but you can't upgrade from *1.14.x* to *1.16.x* directly. To upgrade from *1.14.x* to *1.16.x*, first upgrade from *1.14.x* to *1.15.x*, then perform another upgrade from *1.15.x* to *1.16.x*.
176
192
177
-
The following example output shows the result of upgrading to *1.27.3*. Notice the `KubernetesVersion` now shows *1.27.3*:
193
+
The following example output shows the result of upgrading to *1.29.2*. Notice the `KubernetesVersion` now shows *1.29.2*:
178
194
179
195
```output
180
196
ProvisioningState : Succeeded
181
197
MaxAgentPools : 100
182
-
KubernetesVersion : 1.27.3
198
+
KubernetesVersion : 1.29.2
183
199
PrivateFQDN :
184
200
AgentPoolProfiles : {default}
185
201
Name : myAKSCluster
@@ -255,10 +271,13 @@ AKS regularly provides new node images. Linux node images are updated weekly, an
255
271
The following example output shows some of the above events listed during an upgrade:
256
272
257
273
```output
274
+
LAST SEEN TYPE REASON OBJECT MESSAGE
258
275
...
259
-
default 2m1s Normal Drain node/aks-nodepool1-96663640-vmss000001 Draining node: [aks-nodepool1-96663640-vmss000001]
260
-
...
261
-
default 9m22s Normal Surge node/aks-nodepool1-96663640-vmss000002 Created a surge node [aks-nodepool1-96663640-vmss000002 nodepool1] for agentpool %!s(MISSING)
276
+
5m Normal Drain node/aks-nodepool1-96663640-vmss000000 Draining node: aks-nodepool1-96663640-vmss000000
277
+
5m Normal Upgrade node/aks-nodepool1-96663640-vmss000000 Deleting node aks-nodepool1-96663640-vmss000000 from API server
278
+
4m Normal Upgrade node/aks-nodepool1-96663640-vmss000000 Successfully reimaged node: aks-nodepool1-96663640-vmss000000
279
+
4m Normal Upgrade node/aks-nodepool1-96663640-vmss000000 Successfully upgraded node: aks-nodepool1-96663640-vmss000000
280
+
4m Normal Drain node/aks-nodepool1-96663640-vmss000000 Draining node: aks-nodepool1-96663640-vmss000000
262
281
...
263
282
```
264
283
@@ -277,7 +296,7 @@ AKS regularly provides new node images. Linux node images are updated weekly, an
277
296
```output
278
297
Name Location ResourceGroup KubernetesVersion CurrentKubernetesVersion ProvisioningState Fqdn
0 commit comments