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
fix: Update Shoot rolling upgrades guide in light of new Monitoring tab
When bringing Shoot details into view, we now have a new tab
labeled "Monitoring". We update all relevant screenshots with
newer versions that have this new tab. We also augment the
prose a bit, due to a new screenshot.
Copy file name to clipboardExpand all lines: docs/howto/kubernetes/gardener/rolling-upgrades.md
+14-10
Original file line number
Diff line number
Diff line change
@@ -18,20 +18,24 @@ In the central pane, you will see all your {{k8s_management_service}} clusters,
18
18
If a Kubernetes upgrade is available for a shoot cluster, in the *Version* column, you will notice a blue :fontawesome-solid-circle-arrow-up: icon together with the current Kubernetes version.
19
19
Additionally, if there is a new machine image version for the cluster nodes, then in the *Worker Groups* column, you will also notice a blue :fontawesome-solid-circle-arrow-up: icon --- but no version number.
20
20
21
-

21
+

22
22
23
23
To get more information about the current machine image, click on the cluster row to bring its details into full view, then select the *Worker Groups* tab.
24
24
There, you will see the version of the current machine image.
25
25
To start the upgrade process, click any of the two :fontawesome-solid-arrow-up: icons.
26
26
27
-

27
+

28
28
29
29
The upgrade process starts immediately and takes some time to complete.
30
+
The animated icon at the left-hand side of the cluster row marks the progress.
31
+
32
+

33
+
30
34
A little before and after it is done, there is no icon in the *Worker Groups* column, and the new image version is displayed in the
31
35
*Image* row of the *Worker Groups* tab.
32
36
Since we have not upgraded Kubernetes yet, an icon is still in the *Version* column.
33
37
34
-

38
+

35
39
36
40
## Upgrading Kubernetes
37
41
@@ -40,13 +44,13 @@ In the pop-up menu that appears, there is an option named *Kubernetes Patch Avai
40
44
That one is not always there, and when it is, it acts as yet another indicator of an available Kubernetes upgrade.
A new pop-up window named *Upgrade Kubernetes Version for: <cluster_name>* appears.
46
50
From the *Version* drop-down menu, you may select the new Kubernetes version you want your cluster to upgrade to.
47
51
When ready, click the blue *Upgrade* button.
48
52
49
-

53
+

50
54
51
55
You will realize that the upgrade doesn't start right away.
52
56
Instead, you are informed that the cluster is indeed ready for it, but there are some notes you might want to read up on *before* the actual process begins.
@@ -55,26 +59,26 @@ The gist of the notes differs depending on whether you're upgrading a shoot with
55
59
In summary, the notes inform you that any existing static kubeconfig will stop working after the upgrade to Kubernetes 1.27, and you will not be able to create a new static kubeconfig.
56
60
You will, however, be able to create [a new certificate-based kubeconfig](kubectl.md).
57
61
58
-

62
+

59
63
60
64
To disable support for static kubeconfigs for the existing cluster and thus prepare the shoot for the upgrade, click the blue button labeled *Prepare cluster upgrade*.
61
65
Another pop-up window appears, indicating that the preparation is underway.
62
66
Keep in mind that this might take up to ten minutes to complete.
63
67
64
-

68
+

65
69
66
70
When the shoot is ready for the upgrade, yet another window appears.
67
71
It lets you know that the shoot is now ready for the upgrade, reminds you that any existing static kubeconfig will not work after the upgrade is complete, and points out that you will not be able to create a new static kubeconfig.
68
72
69
-

73
+

70
74
=== "Shoot with Kubernetes 1.27 or higher"
71
75
The notes link to the official Kubernetes changelog of the version you are about to upgrade to.
72
76
You may want to copy that link, paste it into a new browser window or tab, and take the time to read the changelog.
73
77
74
-

78
+

75
79
76
80
Click the *Upgrade* button --- which is now green --- to start the upgrade process.
77
81
After some minutes, the upgrade will be over.
78
82
The new Kubernetes version will be visible in the *Version* column of the cluster row.
0 commit comments