Skip to content

Commit d4f91a1

Browse files
committed
- Updated example output to match current output
- Updated version numbers
1 parent 5ed27cd commit d4f91a1

File tree

1 file changed

+47
-28
lines changed

1 file changed

+47
-28
lines changed

articles/aks/tutorial-kubernetes-upgrade-cluster.md

Lines changed: 47 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Kubernetes on Azure tutorial - Upgrade an Azure Kubernetes Service (AKS) cluster
33
description: In this Azure Kubernetes Service (AKS) tutorial, you learn how to upgrade an existing AKS cluster to the latest available Kubernetes version.
44
ms.topic: tutorial
5-
ms.date: 11/02/2023
5+
ms.date: 06/10/2024
66
author: schaffererin
77
ms.author: schaffererin
88

@@ -40,27 +40,27 @@ If using Azure PowerShell, this tutorial requires Azure PowerShell version 5.9.0
4040
az aks get-upgrades --resource-group myResourceGroup --name myAKSCluster
4141
```
4242
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`:
4444
4545
```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+
},
5062
...
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+
}
6464
```
6565
6666
### [Azure PowerShell](#tab/azure-powershell)
@@ -136,30 +136,46 @@ You can either [manually upgrade your cluster](#manually-upgrade-cluster) or [co
136136
--kubernetes-version KUBERNETES_VERSION
137137
```
138138
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+
139146
> [!NOTE]
140147
> 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*.
141148
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*:
143150
144151
```output
145152
{
153+
...
146154
"agentPoolProfiles": [
147155
{
156+
...
148157
"count": 3,
158+
"currentOrchestratorVersion": "1.29.2",
149159
"maxPods": 110,
150160
"name": "nodepool1",
161+
"nodeImageVersion": "AKSUbuntu-2204gen2containerd-202405.27.0",
162+
"orchestratorVersion": "1.29.2",
151163
"osType": "Linux",
152-
"vmSize": "Standard_DS1_v2",
164+
"vmSize": "Standard_DS2_v2",
165+
...
153166
}
154167
],
168+
...
169+
"currentKubernetesVersion": "1.29.2",
155170
"dnsPrefix": "myAKSClust-myResourceGroup-19da35",
156171
"enableRbac": false,
157172
"fqdn": "myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io",
158173
"id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
159-
"kubernetesVersion": "1.27.3",
174+
"kubernetesVersion": "1.29.2",
160175
"location": "eastus",
161176
"name": "myAKSCluster",
162177
"type": "Microsoft.ContainerService/ManagedClusters"
178+
...
163179
}
164180
```
165181
@@ -174,12 +190,12 @@ You can either [manually upgrade your cluster](#manually-upgrade-cluster) or [co
174190
> [!NOTE]
175191
> 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*.
176192
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*:
178194
179195
```output
180196
ProvisioningState : Succeeded
181197
MaxAgentPools : 100
182-
KubernetesVersion : 1.27.3
198+
KubernetesVersion : 1.29.2
183199
PrivateFQDN :
184200
AgentPoolProfiles : {default}
185201
Name : myAKSCluster
@@ -255,10 +271,13 @@ AKS regularly provides new node images. Linux node images are updated weekly, an
255271
The following example output shows some of the above events listed during an upgrade:
256272
257273
```output
274+
LAST SEEN TYPE REASON OBJECT MESSAGE
258275
...
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
262281
...
263282
```
264283
@@ -277,7 +296,7 @@ AKS regularly provides new node images. Linux node images are updated weekly, an
277296
```output
278297
Name Location ResourceGroup KubernetesVersion CurrentKubernetesVersion ProvisioningState Fqdn
279298
------------ ---------- --------------- ------------------- ------------------------ ------------------- ----------------------------------------------------------------
280-
myAKSCluster eastus myResourceGroup 1.27.3 1.27.3 Succeeded myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io
299+
myAKSCluster eastus myResourceGroup 1.29.2 1.29.2 Succeeded myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io
281300
```
282301
283302
### [Azure PowerShell](#tab/azure-powershell)

0 commit comments

Comments
 (0)