Skip to content

Commit dc2c426

Browse files
committed
feat(k8s): upgrade node pools
1 parent be41922 commit dc2c426

File tree

1 file changed

+26
-4
lines changed

1 file changed

+26
-4
lines changed

containers/kubernetes/how-to/upgrade-cluster-node-image.mdx

+26-4
Original file line numberDiff line numberDiff line change
@@ -13,19 +13,41 @@ categories:
1313
- kubernetes
1414
---
1515

16-
Kubernetes Kapsule clusters regularly receive updated [node images](/containers/kubernetes/reference-content/kubernetes-node-images/), and it is recommended to regularly upgrade these images to leverage the latest features.
17-
18-
This guide provides instructions on how to upgrade node images in your Kubernetes Kapsule cluster and how to update node pool images without changing the Kubernetes version.
16+
Kubernetes Kapsule clusters benefit from regular updates to their [node images](/containers/kubernetes/reference-content/kubernetes-node-images/). To profit of the latest features, it is important to stay up-to-date by upgrading these images.
17+
This guide outlines the process for upgrading node images in your Kubernetes Kapsule cluster and provides instructions on updating node pool images without changing the Kubernetes version.
1918

2019
<Message type="tip">
21-
If you are interested in upgrading the Kubernetes version of your cluster, refer to the documentation on [Upgrading a Kubernetes Cluster](/containers/kubernetes/how-to/upgrade-kubernets-version/).
20+
If you wish to upgrade the Kubernetes version of your cluster, refer to the documentation on [Upgrading a Kubernetes Cluster](/containers/kubernetes/how-to/upgrade-kubernets-version/).
2221
</Message>
2322

2423
<Message type="requirement">
2524
- You have an account and are logged into the [Scaleway console](https://console.scaleway.com)
2625
- You have [created](/containers/kubernetes/how-to/create-cluster) a Kubernetes Kapsule cluster
2726
</Message>
2827

28+
## Node Image Upgrade Process
29+
30+
### Automatic Upgrade for Kubernetes 1.30 or later
31+
32+
For Kubernetes clusters running version `>=1.30`, the new node image is applied automatically to all clusters created using this version. To upgrade the version of your node image, follow these steps:
33+
34+
1. Click **Kubernetes** under **Containers** on the side menu. A list of your Kubernetes Kapsule clusters displays.
35+
2. Click the cluster name you wish to upgrade the pool. The cluster information page displays.
36+
3. Navigate to the cluster's configuration settings and select the option to upgrade node pools. This process will automatically apply the latest node image to your cluster.
37+
38+
### Hybrid Roll-out Strategy for Kubernetes 1.29 or earlier
39+
40+
For Kubernetes clusters running version `<=1.29`, a hybrid roll-out strategy is implemented. Follow these steps to upgrade node images in such clusters:
41+
42+
* **Automatic deployment for new nodes:**
43+
- Any newly created node is automatically deployed using the new image system.
44+
- Nodes created through auto-scaling are also deployed using the new system.
45+
* **Transition for replaced nodes:**
46+
- Replaced nodes transition to the new image system as part of the upgrade process.
47+
* **New node pool deployment:**
48+
- Any new node pool is deployed using the new node image.
49+
* **Legacy nodes maintenance:**
50+
- Legacy nodes, including upgraded nodes, maintain the older system for retro compatibility.
2951

3052
<Navigation title="See Also">
3153
<PreviousButton to="/containers/kubernetes/how-to/access-kubernetes-dashboard/">How to access the dashboard of a Kubernetes Kapsule cluster</PreviousButton>

0 commit comments

Comments
 (0)