From 438f08814915edbb9b215168c7ef72e710928abf Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Thu, 3 Jul 2025 16:52:45 +0200 Subject: [PATCH 1/9] feat(k8s): image system --- menu/navigation.json | 4 ++ .../upgrade-kapsule-new-node-image-system.mdx | 44 +++++++++++++++++++ 2 files changed, 48 insertions(+) create mode 100644 pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx diff --git a/menu/navigation.json b/menu/navigation.json index d51d8c9c03..1ca11c7a09 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -1914,6 +1914,10 @@ { "label": "Upgrade the Kubernetes version on a Kapsule cluster", "slug": "upgrade-kubernetes-version" + }, + { + "label": "Upgrade a Kapsule cluster to the new node image systemr", + "slug": "upgrade-kapsule-new-node-image-system" }, { "label": "Use the NVIDIA GPU operator on Kapsule and Kosmos with GPU Instances", diff --git a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx new file mode 100644 index 0000000000..2c548d40b6 --- /dev/null +++ b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx @@ -0,0 +1,44 @@ +--- +meta: + title: How to upgrade a Kapsule cluster to the new node image system + description: Learn how to upgrade a Kapsule cluster to the new node image system. + h1: How to upgrade a Kapsule cluster to the new node image system + paragraph: Learn how to upgrade a Kapsule cluster to the new node image system. +tags: kubernetes kapsule node image +dates: + validation: 2025-07-03 + posted: 2025-07-03 +categories: + - containers +--- + + +Scaleway is introducing a new image system for Kubernetes Kapsule clusters, bringing significant improvements, including reduced boot time, faster autoscaling, and an updated Ubuntu version. + +The advantages of the new image system include improved boot time, reduced from over five minutes to under one minute, and faster autoscaling. The new images are based on Ubuntu 24.04 LTS, replacing the previous 22.04 LTS version. +Upgrades will also be faster, as nodes will be replaced instead of rebooted. + + +## Technical specifics of the upgrade Process + +* **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. +* **New IP addresses**: The new replacement nodes will have new IP addresses (both public and private), which could impact IP filtering configurations. +* **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. + +## Upgrade methods + +You can migrate your Scaleway Kubernetes Kapsule cluster to the new image system using either the console or the CLI: + +### Console upgrade + +1. Navigate to **Kubernetes** under the **Containers** section of the [Scaleway console](https://console.scaleway.com/) side menu. The Kubernetes dashboard displays. +2. Click the Kapsule cluster name you want to manage. The cluster information page displays. +3. Click **Actions** in the top right corner of the cluster information page. A pop-up menu displays. +4. Click **Upgrade cluster nodes image**. A pop-up dispalys. +5. Confirm the upgrade by clicking **Upgrade cluster node image** + +### CLI upgrade : +You can also upgrade the cluster to the new pool image system using the CLI. + +Example command: +* Migrate all pools of a cluster to new images: `scw k8s cluster migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111` From 04476931cc662dc2ccd6e8b561ee55d2b7971920 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Thu, 3 Jul 2025 16:54:40 +0200 Subject: [PATCH 2/9] feat(k8s): new node image system --- menu/navigation.json | 2 +- .../kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/menu/navigation.json b/menu/navigation.json index 1ca11c7a09..ae88405632 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -1915,7 +1915,7 @@ "label": "Upgrade the Kubernetes version on a Kapsule cluster", "slug": "upgrade-kubernetes-version" }, - { + { "label": "Upgrade a Kapsule cluster to the new node image systemr", "slug": "upgrade-kapsule-new-node-image-system" }, diff --git a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx index 2c548d40b6..101d6b61b3 100644 --- a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx +++ b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx @@ -27,7 +27,7 @@ Upgrades will also be faster, as nodes will be replaced instead of rebooted. ## Upgrade methods -You can migrate your Scaleway Kubernetes Kapsule cluster to the new image system using either the console or the CLI: +You can upgrade your Scaleway Kubernetes Kapsule cluster to the new image system using either the console or the CLI: ### Console upgrade From 67a9114ad42ae4afde119cf3d0d4bd6a95f3ba13 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 16 Jul 2025 10:52:53 +0200 Subject: [PATCH 3/9] feat(k8s): update meta data --- menu/navigation.json | 2 +- .../how-to/upgrade-kapsule-new-node-image-system.mdx | 9 +++------ 2 files changed, 4 insertions(+), 7 deletions(-) diff --git a/menu/navigation.json b/menu/navigation.json index ae88405632..9c9319f087 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -1916,7 +1916,7 @@ "slug": "upgrade-kubernetes-version" }, { - "label": "Upgrade a Kapsule cluster to the new node image systemr", + "label": "Upgrade a Kapsule cluster to the new node image system", "slug": "upgrade-kapsule-new-node-image-system" }, { diff --git a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx index 101d6b61b3..2e3f9b354b 100644 --- a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx +++ b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx @@ -1,12 +1,9 @@ --- -meta: - title: How to upgrade a Kapsule cluster to the new node image system - description: Learn how to upgrade a Kapsule cluster to the new node image system. - h1: How to upgrade a Kapsule cluster to the new node image system - paragraph: Learn how to upgrade a Kapsule cluster to the new node image system. +title: How to upgrade a Kapsule cluster to the new node image system +description: Learn how to upgrade a Kapsule cluster to the new node image system. tags: kubernetes kapsule node image dates: - validation: 2025-07-03 + validation: 2025-07-16 posted: 2025-07-03 categories: - containers From ab11718cc0e2925c7cf6dcec1a51d6751a39c5ae Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Tue, 29 Jul 2025 15:10:32 +0200 Subject: [PATCH 4/9] feat(k8s): update cli examples --- .../upgrade-kapsule-new-node-image-system.mdx | 21 ++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx index 2e3f9b354b..a8a2e564e0 100644 --- a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx +++ b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx @@ -8,20 +8,24 @@ dates: categories: - containers --- - +import Requirements from '@macros/iam/requirements.mdx' Scaleway is introducing a new image system for Kubernetes Kapsule clusters, bringing significant improvements, including reduced boot time, faster autoscaling, and an updated Ubuntu version. The advantages of the new image system include improved boot time, reduced from over five minutes to under one minute, and faster autoscaling. The new images are based on Ubuntu 24.04 LTS, replacing the previous 22.04 LTS version. Upgrades will also be faster, as nodes will be replaced instead of rebooted. - ## Technical specifics of the upgrade Process * **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. * **New IP addresses**: The new replacement nodes will have new IP addresses (both public and private), which could impact IP filtering configurations. * **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. + + +- [Created](/kubernetes/how-to/create-cluster/) a Kubernetes Kapsule cluster +- Have installed the [Scaleway CLI](/scaleway-cli/quickstart/) on your local machine + ## Upgrade methods You can upgrade your Scaleway Kubernetes Kapsule cluster to the new image system using either the console or the CLI: @@ -34,8 +38,15 @@ You can upgrade your Scaleway Kubernetes Kapsule cluster to the new image system 4. Click **Upgrade cluster nodes image**. A pop-up dispalys. 5. Confirm the upgrade by clicking **Upgrade cluster node image** -### CLI upgrade : +### CLI upgrade: You can also upgrade the cluster to the new pool image system using the CLI. -Example command: -* Migrate all pools of a cluster to new images: `scw k8s cluster migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111` +Example commands: +* Migrate all pools of a cluster to new images: + ``` + scw k8s cluster migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111 + ``` +* Migrate a specific pool of a cluster to new images: + ``` + scw k8s pool migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111 pools.0=22222222-2222-2222-2222-222222222222 + ``` \ No newline at end of file From 1783896a711c6864d179a68d291d2212655dc271 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Tue, 5 Aug 2025 16:57:21 +0200 Subject: [PATCH 5/9] docs(k8s): update doc --- .../how-to/upgrade-kapsule-new-node-image-system.mdx | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx index a8a2e564e0..c2cd0315e5 100644 --- a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx +++ b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx @@ -3,8 +3,8 @@ title: How to upgrade a Kapsule cluster to the new node image system description: Learn how to upgrade a Kapsule cluster to the new node image system. tags: kubernetes kapsule node image dates: - validation: 2025-07-16 - posted: 2025-07-03 + validation: 2025-08-05 + posted: 2025-08-05 categories: - containers --- @@ -49,4 +49,8 @@ Example commands: * Migrate a specific pool of a cluster to new images: ``` scw k8s pool migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111 pools.0=22222222-2222-2222-2222-222222222222 + ``` +* Create a new pool that uses the new images: + ``` + scw k8s cluster create name=foo pools.0.name=bar pools.0.tags.0=scw-compute-image pools.0.size=1 pools.0.node-type=GP1-M ``` \ No newline at end of file From d1e7f4be1c09ffb03acecc00f1eaf48e8ee4c9e8 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 25 Aug 2025 17:27:13 +0200 Subject: [PATCH 6/9] Apply suggestions from code review Co-authored-by: Tomy Guichard --- .../how-to/upgrade-kapsule-new-node-image-system.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx index c2cd0315e5..1514e6f8b0 100644 --- a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx +++ b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx @@ -35,7 +35,7 @@ You can upgrade your Scaleway Kubernetes Kapsule cluster to the new image system 1. Navigate to **Kubernetes** under the **Containers** section of the [Scaleway console](https://console.scaleway.com/) side menu. The Kubernetes dashboard displays. 2. Click the Kapsule cluster name you want to manage. The cluster information page displays. 3. Click **Actions** in the top right corner of the cluster information page. A pop-up menu displays. -4. Click **Upgrade cluster nodes image**. A pop-up dispalys. +4. Click **Upgrade cluster nodes image**. A pop-up displays. 5. Confirm the upgrade by clicking **Upgrade cluster node image** ### CLI upgrade: @@ -44,7 +44,7 @@ You can also upgrade the cluster to the new pool image system using the CLI. Example commands: * Migrate all pools of a cluster to new images: ``` - scw k8s cluster migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111 + scw k8s pool migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111 ``` * Migrate a specific pool of a cluster to new images: ``` From 28f2bc3689ee09d3c6097cc956518bf0df151b69 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Oc=C3=A9ane?= Date: Thu, 4 Sep 2025 15:19:08 +0200 Subject: [PATCH 7/9] Update pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx --- .../kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx index 1514e6f8b0..6d1a2dea09 100644 --- a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx +++ b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx @@ -28,7 +28,7 @@ Upgrades will also be faster, as nodes will be replaced instead of rebooted. ## Upgrade methods -You can upgrade your Scaleway Kubernetes Kapsule cluster to the new image system using either the console or the CLI: +You can upgrade your Scaleway Kubernetes Kapsule cluster to the new image system using either the console or the CLI. ### Console upgrade From 3c4bf3fd485701d0cc152693b66385824bd89952 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Oc=C3=A9ane?= Date: Thu, 4 Sep 2025 15:19:17 +0200 Subject: [PATCH 8/9] Update pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> --- .../how-to/upgrade-kapsule-new-node-image-system.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx index 6d1a2dea09..6a5f0d0dd0 100644 --- a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx +++ b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx @@ -3,8 +3,8 @@ title: How to upgrade a Kapsule cluster to the new node image system description: Learn how to upgrade a Kapsule cluster to the new node image system. tags: kubernetes kapsule node image dates: - validation: 2025-08-05 - posted: 2025-08-05 + validation: 2025-09-04 + posted: 2025-09-04 categories: - containers --- From 24b0e48be75fe014a32a38d51329d1e8334e7078 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?N=C3=A9da?= <87707325+nerda-codes@users.noreply.github.com> Date: Thu, 4 Sep 2025 15:19:59 +0200 Subject: [PATCH 9/9] Apply suggestions from code review Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> --- .../how-to/upgrade-kapsule-new-node-image-system.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx index 6a5f0d0dd0..02e149d31f 100644 --- a/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx +++ b/pages/kubernetes/how-to/upgrade-kapsule-new-node-image-system.mdx @@ -15,7 +15,7 @@ Scaleway is introducing a new image system for Kubernetes Kapsule clusters, brin The advantages of the new image system include improved boot time, reduced from over five minutes to under one minute, and faster autoscaling. The new images are based on Ubuntu 24.04 LTS, replacing the previous 22.04 LTS version. Upgrades will also be faster, as nodes will be replaced instead of rebooted. -## Technical specifics of the upgrade Process +## Technical specifications of the upgrade process * **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. * **New IP addresses**: The new replacement nodes will have new IP addresses (both public and private), which could impact IP filtering configurations. @@ -24,7 +24,7 @@ Upgrades will also be faster, as nodes will be replaced instead of rebooted. - [Created](/kubernetes/how-to/create-cluster/) a Kubernetes Kapsule cluster -- Have installed the [Scaleway CLI](/scaleway-cli/quickstart/) on your local machine +- Installed the [Scaleway CLI](/scaleway-cli/quickstart/) on your local machine ## Upgrade methods @@ -36,12 +36,12 @@ You can upgrade your Scaleway Kubernetes Kapsule cluster to the new image system 2. Click the Kapsule cluster name you want to manage. The cluster information page displays. 3. Click **Actions** in the top right corner of the cluster information page. A pop-up menu displays. 4. Click **Upgrade cluster nodes image**. A pop-up displays. -5. Confirm the upgrade by clicking **Upgrade cluster node image** +5. Click **Upgrade cluster node image** to confirm. ### CLI upgrade: You can also upgrade the cluster to the new pool image system using the CLI. -Example commands: +Example of commands: * Migrate all pools of a cluster to new images: ``` scw k8s pool migrate-to-new-images cluster-id=11111111-1111-1111-1111-111111111111