Skip to content

Commit 3716f73

Browse files
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.
1 parent d9323db commit 3716f73

22 files changed

+14
-10
lines changed
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading

docs/howto/kubernetes/gardener/rolling-upgrades.md

+14-10
Original file line numberDiff line numberDiff line change
@@ -18,20 +18,24 @@ In the central pane, you will see all your {{k8s_management_service}} clusters,
1818
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.
1919
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.
2020

21-
![Garden Linux and Kubernetes upgrades available](assets/rollupgr-01.png)
21+
![Garden Linux and Kubernetes upgrades available](assets/shoot-rollupgr-01.png)
2222

2323
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.
2424
There, you will see the version of the current machine image.
2525
To start the upgrade process, click any of the two :fontawesome-solid-arrow-up: icons.
2626

27-
![About to start Garden Linux upgrade](assets/rollupgr-02.png)
27+
![About to start Garden Linux upgrade](assets/shoot-rollupgr-02.png)
2828

2929
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+
![Garden Linux upgrade in progress](assets/shoot-rollupgr-03.png)
33+
3034
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
3135
*Image* row of the *Worker Groups* tab.
3236
Since we have not upgraded Kubernetes yet, an icon is still in the *Version* column.
3337

34-
![Garden Linux upgraded](assets/rollupgr-03.png)
38+
![Garden Linux upgraded](assets/shoot-rollupgr-04.png)
3539

3640
## Upgrading Kubernetes
3741

@@ -40,13 +44,13 @@ In the pop-up menu that appears, there is an option named *Kubernetes Patch Avai
4044
That one is not always there, and when it is, it acts as yet another indicator of an available Kubernetes upgrade.
4145
Please select the option by clicking on it.
4246

43-
![Kubernetes patch available](assets/rollupgr-04.png)
47+
![Kubernetes patch available](assets/shoot-rollupgr-05.png)
4448

4549
A new pop-up window named *Upgrade Kubernetes Version for: <cluster_name>* appears.
4650
From the *Version* drop-down menu, you may select the new Kubernetes version you want your cluster to upgrade to.
4751
When ready, click the blue *Upgrade* button.
4852

49-
![About to start a Kubernetes upgrade](assets/rollupgr-05.png)
53+
![About to start a Kubernetes upgrade](assets/shoot-rollupgr-06.png)
5054

5155
You will realize that the upgrade doesn't start right away.
5256
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
5559
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.
5660
You will, however, be able to create [a new certificate-based kubeconfig](kubectl.md).
5761

58-
![Upgrade notes are available](assets/rollupgr-06-01.png)
62+
![Upgrade notes are available](assets/shoot-rollupgr-07-26-01.png)
5963

6064
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*.
6165
Another pop-up window appears, indicating that the preparation is underway.
6266
Keep in mind that this might take up to ten minutes to complete.
6367

64-
![Upgrade notes are available](assets/rollupgr-06-02.png)
68+
![Upgrade notes are available](assets/shoot-rollupgr-07-26-02.png)
6569

6670
When the shoot is ready for the upgrade, yet another window appears.
6771
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.
6872

69-
![Upgrade notes are available](assets/rollupgr-06-03.png)
73+
![Upgrade notes are available](assets/shoot-rollupgr-07-26-03.png)
7074
=== "Shoot with Kubernetes 1.27 or higher"
7175
The notes link to the official Kubernetes changelog of the version you are about to upgrade to.
7276
You may want to copy that link, paste it into a new browser window or tab, and take the time to read the changelog.
7377

74-
![Upgrade notes are available](assets/rollupgr-06.png)
78+
![Upgrade notes are available](assets/shoot-rollupgr-07-27-01.png)
7579

7680
Click the *Upgrade* button --- which is now green --- to start the upgrade process.
7781
After some minutes, the upgrade will be over.
7882
The new Kubernetes version will be visible in the *Version* column of the cluster row.
7983

80-
![Kubernetes successfully upgraded](assets/rollupgr-07.png)
84+
![Kubernetes successfully upgraded](assets/shoot-rollupgr-08.png)

0 commit comments

Comments
 (0)