Skip to content

Commit 384119f

Browse files
fix: Update Shoot creation guide in light of new Monitoring tab
When bringing Shoot details into view, we now have a new tab offering two buttons for launching Prometheus or Plutono. We update the prose and all screenshots, and add a whole new section with information regarding cluster details and launching monitoring dashboards.
1 parent e289122 commit 384119f

23 files changed

+35
-9
lines changed
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Loading
Loading
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

docs/howto/kubernetes/gardener/create-shoot-cluster.md

+35-9
Original file line numberDiff line numberDiff line change
@@ -20,33 +20,33 @@ In {{k8s_management_service}} terminology, a Kubernetes cluster is referred as a
2020

2121
At the top right-hand side of the central pane, click on *Create Kubernetes cluster*.
2222

23-
![{{k8s_management_service}} page in {{gui}}](assets/gardener_page.png)
23+
![{{k8s_management_service}} page in {{gui}}](assets/create-shoot-00.png)
2424

2525
A new pane named *Create {{k8s_management_service}} Shoot Cluster* slides over from the right-hand side of the browser.
2626
Type in a name for the new shoot cluster, and select a region.
2727
Also, select the version of Kubernetes the new cluster will be running.
2828
In the example below, we have chosen version 1.28.7, which, at the time of writing, was the latest supported in {{brand}}.
2929

30-
!["Create {{k8s_management_service}} Shoot Cluster" panel, showing options to type in a cluster name, select region and Kubernetes version](assets/create-shoot-1.png)
30+
!["Create {{k8s_management_service}} Shoot Cluster" panel, showing options to type in a cluster name, select region and Kubernetes version](assets/create-shoot-01.png)
3131

3232
Next, you may accept the proposed network address (in [CIDR notation](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation)) for the worker nodes, or type in the one you prefer.
3333

34-
![Accept the proposed CIDR network address for the worker nodes or type in the CIDR network address you prefer](assets/create-shoot-1.1.png)
34+
![Accept the proposed CIDR network address for the worker nodes or type in the CIDR network address you prefer](assets/create-shoot-02.png)
3535

3636
Alternatively, click on the drop-down menu at the right-hand side of "Network for worker nodes".
3737
From the available menu items, choose a pre-existing network.
3838
Be sure to select one that has an assigned subnet, and is connected to a router.
3939

40-
![Select a pre-existing network](assets/create-shoot-1.2.png)
40+
![Select a pre-existing network](assets/create-shoot-03.png)
4141

4242
Then, define a new subnet for the worker nodes by typing in a CIDR network address.
4343
If the new subnet overlaps with one of the subnets of the network you just selected, you will see an error message in red.
4444

45-
![Select a pre-existing network](assets/create-shoot-1.3.png)
45+
![Select a pre-existing network](assets/create-shoot-04.png)
4646

4747
Instead, you should define a subnet that does not overlap with any of the subnets of your selected network.
4848

49-
![New, valid subnet for the worker nodes](assets/create-shoot-1.4.png)
49+
![New, valid subnet for the worker nodes](assets/create-shoot-05.png)
5050

5151
Now, scroll down a bit until you bring the *Worker Groups* section into full view.
5252
Make sure there is at least one worker group defined.
@@ -60,18 +60,18 @@ this determines the number of CPU cores and the amount of RAM allocated to them.
6060
* *Autoscaler Max:* The maximum number of worker nodes the cluster automatically scales to, in the event that the current number of nodes cannot handle the deployed workload.
6161
* *Max Surge:* The maximum number of additional nodes to deploy in an autoscaling event.
6262

63-
!["Create {{k8s_management_service}} Shoot Cluster" panel](assets/create-shoot-2.png)
63+
!["Create {{k8s_management_service}} Shoot Cluster" panel](assets/create-shoot-06.png)
6464

6565
For a test cluster, you can leave each parameter at its default value.
6666
Scroll to the bottom of the pane and click the green *Create* button.
6767

68-
!["Create {{k8s_management_service}} Shoot Cluster" panel](assets/create-shoot-3.png)
68+
!["Create {{k8s_management_service}} Shoot Cluster" panel](assets/create-shoot-07.png)
6969

7070
In the list of clusters, you will see your new {{k8s_management_service}} shoot bootstrapping.
7171
The animated icon on the left-hand side of the cluster row marks the progress.
7272
Creating the cluster may take several minutes.
7373

74-
![Shoot cluster bootstrapping](assets/shoot_bootstrapping.png)
74+
![Shoot cluster bootstrapping](assets/create-shoot-08.png)
7575

7676
### A note on quotas
7777

@@ -83,6 +83,32 @@ A 4th node would push your total memory allocation to 64 GiB, violating your qu
8383

8484
If necessary, be sure to request a quota increase via our [{{support}}](https://{{support_domain}}/servicedesk).
8585

86+
## Viewing details and monitoring
87+
88+
After the new shoot cluster finishes bootstrapping, you may click on its row to bring all relevant details into view.
89+
For instance, click the *Details* tab to get networking information about the worker nodes.
90+
91+
![Networking information about the worker nodes](assets/create-shoot-09.png)
92+
93+
Next, go to the *Monitoring* tab.
94+
There, you will notice two orange buttons: one for launching [Prometheus](https://prometheus.io), and one for launching [Plutono](https://github.com/credativ/plutono).
95+
96+
![Monitoring tab for launching Prometheus or Plutono](assets/create-shoot-10.png)
97+
98+
As an example, we have clicked the button for Plutono.
99+
Prior to launching the dashboard, a pop-up window appears.
100+
This shows the default username (`admin`), and the masked generated password.
101+
You get this pop-up every time you click on either of the orange buttons.
102+
In any case, to copy the password into the clipboard, click the related button shown below.
103+
Then, click the orange button labeled *Open Dashboard*.
104+
105+
![Copy the Plutono password](assets/create-shoot-11.png)
106+
107+
After typing in the default username and pasting the password, you get access to the Prometheus or Plutono dashboard for your shoot cluster.
108+
In the example below, we have the Plutono dashboard displaying graphical information regarding the cluster nodes.
109+
110+
![Plutono dashboard displaying information about the worker nodes](assets/create-shoot-12.png)
111+
86112
## Interacting with your cluster
87113

88114
Once your new shoot cluster is operational, you can [start interacting with it](kubectl.md).

0 commit comments

Comments
 (0)