Skip to content

Commit

Permalink
Deployed a6a30f5 with MkDocs version: 1.6.1
Browse files Browse the repository at this point in the history
  • Loading branch information
Unknown committed Oct 3, 2024
1 parent fe9ef7c commit 6e1a896
Show file tree
Hide file tree
Showing 17 changed files with 121 additions and 138 deletions.
Binary file modified howto/kubernetes/gardener/assets/shoot-rollupgr-01.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified howto/kubernetes/gardener/assets/shoot-rollupgr-02.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified howto/kubernetes/gardener/assets/shoot-rollupgr-03.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified howto/kubernetes/gardener/assets/shoot-rollupgr-04.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified howto/kubernetes/gardener/assets/shoot-rollupgr-05.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified howto/kubernetes/gardener/assets/shoot-rollupgr-06.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified howto/kubernetes/gardener/assets/shoot-rollupgr-08.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
61 changes: 22 additions & 39 deletions howto/kubernetes/gardener/rolling-upgrades/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4051,26 +4051,28 @@

<h1 id="conducting-rolling-upgrades">Conducting rolling upgrades</h1>
<p>By default, Kubernetes clusters created with Gardener in Cleura Cloud are upgraded automatically.
Those upgrades take place during a specified maintenance window, and you may find out more about <a href="../../../../background/kubernetes/gardener/autoupgrades/">what they involve and how they work</a>.
Those upgrades take place during a specified maintenance window, and you may learn more about <a href="../../../../background/kubernetes/gardener/autoupgrades/">what they involve and how they work</a>.
Besides the automatic upgrades, you may manually apply any upgrades available for your cluster.</p>
<p>In the following two examples, we first show how to manually upgrade the machine image the cluster nodes are based on.
Then, we show how to upgrade the Kubernetes version the cluster uses.</p>
<p>In the following two examples, we first show how to manually upgrade the machine image for cluster nodes.
Then, we show how to upgrade the Kubernetes version the cluster is running.</p>
<h2 id="upgrading-machine-images">Upgrading machine images</h2>
<p>In the left-hand vertical pane of the Cleura Cloud Management Panel, select Containers → <a href="https://cleura.cloud/containers/gardener">Gardener</a>.
In the central pane, you will see all your Gardener clusters, each on its own row.</p>
<p>If a Kubernetes upgrade is available for a shoot cluster, in the <em>Version</em> column, you will notice a blue <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M256 512a256 256 0 1 0 0-512 256 256 0 1 0 0 512m129-297c9.4 9.4 9.4 24.6 0 33.9s-24.6 9.4-33.9 0l-71-71L280 392c0 13.3-10.7 24-24 24s-24-10.7-24-24V177.9l-71 71c-9.4 9.4-24.6 9.4-33.9 0s-9.4-24.6 0-33.9L239 103c9.4-9.4 24.6-9.4 33.9 0z"/></svg></span> icon together with the current Kubernetes version.
Additionally, if there is a new machine image version for the cluster nodes, then in the <em>Worker Groups</em> column, you will also notice a blue <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M256 512a256 256 0 1 0 0-512 256 256 0 1 0 0 512m129-297c9.4 9.4 9.4 24.6 0 33.9s-24.6 9.4-33.9 0l-71-71L280 392c0 13.3-10.7 24-24 24s-24-10.7-24-24V177.9l-71 71c-9.4 9.4-24.6 9.4-33.9 0s-9.4-24.6 0-33.9L239 103c9.4-9.4 24.6-9.4 33.9 0z"/></svg></span> icon &mdash; but no version number.</p>
In the central pane are your Gardener clusters, each on its row.</p>
<p>If a Kubernetes upgrade is available for a shoot cluster, you will notice a blue <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M256 512a256 256 0 1 0 0-512 256 256 0 1 0 0 512m129-297c9.4 9.4 9.4 24.6 0 33.9s-24.6 9.4-33.9 0l-71-71L280 392c0 13.3-10.7 24-24 24s-24-10.7-24-24V177.9l-71 71c-9.4 9.4-24.6 9.4-33.9 0s-9.4-24.6 0-33.9L239 103c9.4-9.4 24.6-9.4 33.9 0z"/></svg></span> icon on the right of the current Kubernetes version.
In our example, the current Kubernetes version is 1.29.9.
Additionally, if there is a new machine image for the cluster nodes, you will also notice a blue <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M256 512a256 256 0 1 0 0-512 256 256 0 1 0 0 512m129-297c9.4 9.4 9.4 24.6 0 33.9s-24.6 9.4-33.9 0l-71-71L280 392c0 13.3-10.7 24-24 24s-24-10.7-24-24V177.9l-71 71c-9.4 9.4-24.6 9.4-33.9 0s-9.4-24.6 0-33.9L239 103c9.4-9.4 24.6-9.4 33.9 0z"/></svg></span> icon on the right of the number of Worker Groups.
In our example, the cluster has 1 Worker Group.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-01.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Garden Linux and Kubernetes upgrades available" src="../assets/shoot-rollupgr-01.png" /></a></p>
<p>To get more information about the current machine image, click on the cluster row to bring its details into full view, then select the <em>Worker Groups</em> tab.
There, you will see the version of the current machine image.
To start the upgrade process, click any of the two <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M214.6 41.4c-12.5-12.5-32.8-12.5-45.3 0l-160 160c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0L160 141.2V448c0 17.7 14.3 32 32 32s32-14.3 32-32V141.3l105.4 105.3c12.5 12.5 32.8 12.5 45.3 0s12.5-32.8 0-45.3l-160-160z"/></svg></span> icons.</p>
To see the newer version of the image available, hover the mouse over any of the two <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M214.6 41.4c-12.5-12.5-32.8-12.5-45.3 0l-160 160c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0L160 141.2V448c0 17.7 14.3 32 32 32s32-14.3 32-32V141.3l105.4 105.3c12.5 12.5 32.8 12.5 45.3 0s12.5-32.8 0-45.3l-160-160z"/></svg></span> icons.
The upgrade process starts by clicking on any one of those.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-02.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="About to start Garden Linux upgrade" src="../assets/shoot-rollupgr-02.png" /></a></p>
<p>The upgrade process starts immediately and takes some time to complete.
The animated icon at the left-hand side of the cluster row marks the progress.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-03.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Garden Linux upgrade in progress" src="../assets/shoot-rollupgr-03.png" /></a></p>
<p>A little before and after it is done, there is no icon in the <em>Worker Groups</em> column, and the new image version is displayed in the
<em>Image</em> row of the <em>Worker Groups</em> tab.
Since we have not upgraded Kubernetes yet, an icon is still in the <em>Version</em> column.</p>
<p>As soon as the upgrade is complete, the new image version is displayed in the <em>Image</em> row of the <em>Worker Groups</em> tab.
Since we have not upgraded Kubernetes yet, there is still a blue <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M256 512a256 256 0 1 0 0-512 256 256 0 1 0 0 512m129-297c9.4 9.4 9.4 24.6 0 33.9s-24.6 9.4-33.9 0l-71-71L280 392c0 13.3-10.7 24-24 24s-24-10.7-24-24V177.9l-71 71c-9.4 9.4-24.6 9.4-33.9 0s-9.4-24.6 0-33.9L239 103c9.4-9.4 24.6-9.4 33.9 0z"/></svg></span> icon on the right of the current Kubernetes version.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-04.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Garden Linux upgraded" src="../assets/shoot-rollupgr-04.png" /></a></p>
<h2 id="upgrading-kubernetes">Upgrading Kubernetes</h2>
<p>To get the Kubernetes upgrade process going, click the orange <span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a10 10 0 0 1 10 10 10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2m0 8.5a1.5 1.5 0 0 0-1.5 1.5 1.5 1.5 0 0 0 1.5 1.5 1.5 1.5 0 0 0 1.5-1.5 1.5 1.5 0 0 0-1.5-1.5m-5.5 0A1.5 1.5 0 0 0 5 12a1.5 1.5 0 0 0 1.5 1.5A1.5 1.5 0 0 0 8 12a1.5 1.5 0 0 0-1.5-1.5m11 0A1.5 1.5 0 0 0 16 12a1.5 1.5 0 0 0 1.5 1.5A1.5 1.5 0 0 0 19 12a1.5 1.5 0 0 0-1.5-1.5"/></svg></span> icon on the right-hand side of the cluster row.
Expand All @@ -4079,37 +4081,18 @@ <h2 id="upgrading-kubernetes">Upgrading Kubernetes</h2>
Please select the option by clicking on it.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-05.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Kubernetes patch available" src="../assets/shoot-rollupgr-05.png" /></a></p>
<p>A new pop-up window named <em>Upgrade Kubernetes Version for: &lt;cluster_name&gt;</em> appears.
From the <em>Version</em> drop-down menu, you may select the new Kubernetes version you want your cluster to upgrade to.
From the <em>Version</em> drop-down menu, you may select the new Kubernetes version for your shoot cluster.
When ready, click the blue <em>Upgrade</em> button.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-06.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="About to start a Kubernetes upgrade" src="../assets/shoot-rollupgr-06.png" /></a></p>
<p>You will realize that the upgrade doesn&rsquo;t start right away.
Instead, you are informed that the cluster is indeed ready for it, but there are some notes you might want to read up on <em>before</em> the actual process begins.
The gist of the notes differs depending on whether you&rsquo;re upgrading a shoot with Kubernetes 1.26, or a shoot with Kubernetes 1.27 or higher.</p>
<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">Shoot with Kubernetes 1.26</label><label for="__tabbed_1_2">Shoot with Kubernetes 1.27 or higher</label></div>
<div class="tabbed-content">
<div class="tabbed-block">
<p>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.
You will, however, be able to create <a href="../kubectl/">a new certificate-based kubeconfig</a>.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-07-26-01.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Upgrade notes are available" src="../assets/shoot-rollupgr-07-26-01.png" /></a></p>
<p>To disable support for static kubeconfigs for the existing cluster and thus prepare the shoot for the upgrade, click the blue button labeled <em>Prepare cluster upgrade</em>.
Another pop-up window appears, indicating that the preparation is underway.
Keep in mind that this might take up to ten minutes to complete.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-07-26-02.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Upgrade notes are available" src="../assets/shoot-rollupgr-07-26-02.png" /></a></p>
<p>When the shoot is ready for the upgrade, yet another window appears.
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.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-07-26-03.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Upgrade notes are available" src="../assets/shoot-rollupgr-07-26-03.png" /></a></p>
</div>
<div class="tabbed-block">
<p>The notes link to the official Kubernetes changelog of the version you are about to upgrade to.
You may want to copy that link, paste it into a new browser window or tab, and take the time to read the changelog.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-07-27-01.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Upgrade notes are available" src="../assets/shoot-rollupgr-07-27-01.png" /></a></p>
</div>
</div>
</div>
<p>The upgrade doesn&rsquo;t start right away.
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.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-07.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Upgrade notes are available" src="../assets/shoot-rollupgr-07.png" /></a></p>
<p>Click the <em>Upgrade</em> button &mdash; which is now green &mdash; to start the upgrade process.
After some minutes, the upgrade will be over.
The new Kubernetes version will be visible in the <em>Version</em> column of the cluster row.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-08.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Kubernetes successfully upgraded" src="../assets/shoot-rollupgr-08.png" /></a></p>
The animated icon at the left-hand side of the cluster row indicates the progress of the whole upgrade process.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-08.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Kubernetes upgrade in progress" src="../assets/shoot-rollupgr-08.png" /></a></p>
<p>After some minutes, the upgrade will be over.
The new Kubernetes version will be visible on the right of the shoot cluster name.</p>
<p><a class="glightbox" href="../assets/shoot-rollupgr-09.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Kubernetes successfully upgraded" src="../assets/shoot-rollupgr-09.png" /></a></p>



Expand All @@ -4132,7 +4115,7 @@ <h2 id="upgrading-kubernetes">Upgrading Kubernetes</h2>
<span class="md-icon" title="Last update">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
</span>
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-03-22</span>
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-10-03</span>
</span>


Expand Down
2 changes: 1 addition & 1 deletion search/search_index.json

Large diffs are not rendered by default.

Loading

0 comments on commit 6e1a896

Please sign in to comment.