Skip to content

Commit b2066dd

Browse files
authored
docs(k8s): add warning to documentation (#5725)
* docs(k8s): add warning to documentation * fix(k8s): close message
1 parent 00b0747 commit b2066dd

File tree

1 file changed

+9
-3
lines changed

1 file changed

+9
-3
lines changed

pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: How to upgrade a Kapsule cluster to the new node image system
33
description: Learn how to upgrade a Kapsule cluster to the new node image system.
44
tags: kubernetes kapsule node image
55
dates:
6-
validation: 2025-09-04
6+
validation: 2025-10-28
77
posted: 2025-09-04
88
categories:
99
- containers
@@ -17,7 +17,7 @@ Upgrades will also be faster, as nodes will be replaced instead of rebooted.
1717

1818
## Technical specifications of the upgrade process
1919

20-
* **Node replacement**: During upgrade, nodes will be replaced with new ones, which may have implications for data stored locally on nodes (e.g., `hostPath`). Data stored in persistent volumes (PV) will not be affected.
20+
* **Node replacement**: During upgrade, nodes will be replaced with new ones, **any local data will be lost**. Data stored in Persistent Volumes (PV) will not be affected.
2121
* **New IP addresses**: The new replacement nodes will have new IP addresses (both public and private), which could impact IP filtering configurations.
2222
* **GPU pool upgrade**: The upgrade of GPU pools may result in a partial downtime due to a limitation in the GPU operator, which cannot handle mixed Ubuntu versions (22.04 vs 24.04). The operator will install incorrect drivers on new nodes until the upgrade is complete, after which it will recover automatically.
2323

@@ -30,6 +30,12 @@ Upgrades will also be faster, as nodes will be replaced instead of rebooted.
3030

3131
You can upgrade your Scaleway Kubernetes Kapsule cluster to the new image system using either the console or the CLI.
3232

33+
<Message type="important">
34+
During the upgrade process, all cluster nodes will be replaced with new ones.
35+
Any data stored locally on the nodes (for example, using `hostPath`) will be **permanently lost**.
36+
Data stored in **Persistent Volumes (PVs)** will **not** be affected.
37+
</Message>
38+
3339
### Console upgrade
3440

3541
1. Navigate to **Kubernetes** under the **Containers** section of the [Scaleway console](https://console.scaleway.com/) side menu. The Kubernetes dashboard displays.
@@ -48,5 +54,5 @@ Example of commands:
4854
```
4955
* Migrate a specific pool of a cluster to new images:
5056
```
51-
scw k8s pool migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111 pools.0=22222222-2222-2222-2222-222222222222
57+
scw k8s pool migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111 pools-ids.0=22222222-2222-2222-2222-222222222222
5258
```

0 commit comments

Comments
 (0)