From 371ede022f0be4f6f6f76c71367ae6a283443a5e Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 26 Feb 2025 16:10:26 +0100 Subject: [PATCH 1/7] feat(ins): update doc sbs migration --- .../migrate-volumes-snapshots-to-sbs.mdx | 25 ++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx index a9a03a1065..d50aa17c4a 100644 --- a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx +++ b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx @@ -19,7 +19,7 @@ To facilitate the transition to Scaleway's new Block Storage management, two mai - [Using the Instance API/CLI migration endpoint (Plan and Apply)](#migrating-using-the-instance-apicli-migration-endpoint-plan-and-apply): - **Advantage:** Migration can occur without service interruption, as the volume remains attached to the running Instance and fully accessible. - - **Drawback:** Only the volume's representation is migrated to the SBS API; the data itself does not move. This means the migrated volume will not benefit from low latency or higher IOPS, as it retains the original `b_ssd` characteristics. + - **Drawback:** Only the volume's representation is migrated to the SBS API; the data itself does not move. This means the migrated volume will not benefit from low latency or higher IOPS, as it **retains the original `b_ssd` characteristics**. - [Using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features): - **Advantage:** The migrated volume will fully support low latency, and it is possible to modify the IOPS up to 15k. All existing data of the old volume will be copied to the new Block Storage Low Latency volume. @@ -37,6 +37,19 @@ Each method caters to different needs, balancing uninterrupted service against a This guide offers step-by-step instructions to migrate your volumes and snapshots using either the [Scaleway Command Line Interface (CLI)](/scaleway-cli/quickstart/) tool (recommended) or the [Instances API](https://www.scaleway.com/en/developers/api/instance/#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage). Alternatively, you can use the [snapshot export/import feature](/instances/api-cli/snapshot-import-export-feature/) to migrate your unified volumes and snapshots to Block Storage Low Latency volumes. +## Comparison of Block Storage volume types + +| Volume type | IOPS | Underlying hardware | Latency | Max volume size | Recommended use cases | Availability & resilience | +|-----------------------------------|----------|--------------------------------|---------------------|----------------------|-------------------------|----------------------------| +| `b_ssd` (Block Storage 5K legacy) | 5,000 | Legacy SSDs | Higher | Up to 10 TB | General-purpose workloads that do not demand high IOPS or low latency | Data is replicated three times across multiple disks for high availability and integrity | +| `sbs_5k` (Block Low Latency 5K) | 5,000 | Modern NVMe disks | Low | 5 GB to 10 TB | Development environments, web servers, and applications needing consistent performance | 99.99% SLA, triple-replicated data to safeguard against hardware failures | +| `sbs_15k` (Block Low Latency 15K) | 15,000 | Modern NVMe disks | Very low | 5 GB to 10 TB | High-performance databases, transactional applications, and I/O-intensive workloads | 99.99% SLA, triple-replicated data to safeguard against hardware failures | + +### Additional details: + +- `b_ssd`: These volumes are based on older SSD technology, providing reliable performance but with limitations in terms of speed and latency. +- `sbs_5k`: These volumes use NVMe technology, offering better performance and lower latency. They allow flexibility to adjust storage based on your needs. +- `sbs_15k`: These volumes offer even higher performance, with up to 15,000 IOPS, making them ideal for workloads requiring fast and reliable data access. Volumes **created and managed through Kubernetes** do not fall within the scope of the migration described on this page. Find specific instructions for migrating Kubernetes volumes behind the Scaleway Block Storage API in the [managing storage for Kubernetes documentation](/kubernetes/api-cli/managing-storage/#upgrading-to-csi-version-03). @@ -162,6 +175,11 @@ Alternatively, you can use the [snapshot export/import feature](/instances/api-c + + After the migration, the volume type of your volume remains `b_ssd` (displayed as **Block SSD 5K legacy** in the console). + To benefit from the new features and performance of Scaleway Block Storage, you must create a new volume (`sbs_5k` or `sbs_15k`) the using the snapshot export/import feature. For more information, see [Migrating using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features). + + ### Migrating an existing Block Storage snapshot to Scaleway Block Storage management @@ -255,6 +273,11 @@ Alternatively, you can use the [snapshot export/import feature](/instances/api-c + + After the migration, the volume type of your volume remains `b_ssd` (displayed as **Block SSD 5K legacy** in the console). + To benefit from the new features and performance of Scaleway Block Storage, you must create a new volume (`sbs_5k` or `sbs_15k`) the using the snapshot export/import feature. For more information, see [Migrating using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features). + + ## Migrating using the snapshot export/import features To convert your unified volumes and snapshots, you can use the snapshot export/import features as an alternative solution for transitioning a Block Storage legacy volume into a Block Storage Low Latency volume. From b73893bfe115d13ed4e6066dd717c0ab0750c575 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 26 Feb 2025 16:28:26 +0100 Subject: [PATCH 2/7] feat(ins): update --- .../instances/how-to/migrate-volumes-snapshots-to-sbs.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx index d50aa17c4a..2cd1c09719 100644 --- a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx +++ b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx @@ -45,11 +45,18 @@ Alternatively, you can use the [snapshot export/import feature](/instances/api-c | `sbs_5k` (Block Low Latency 5K) | 5,000 | Modern NVMe disks | Low | 5 GB to 10 TB | Development environments, web servers, and applications needing consistent performance | 99.99% SLA, triple-replicated data to safeguard against hardware failures | | `sbs_15k` (Block Low Latency 15K) | 15,000 | Modern NVMe disks | Very low | 5 GB to 10 TB | High-performance databases, transactional applications, and I/O-intensive workloads | 99.99% SLA, triple-replicated data to safeguard against hardware failures | + +You can attach a maximum of 16 volumes to a single Instance. + + ### Additional details: - `b_ssd`: These volumes are based on older SSD technology, providing reliable performance but with limitations in terms of speed and latency. - `sbs_5k`: These volumes use NVMe technology, offering better performance and lower latency. They allow flexibility to adjust storage based on your needs. - `sbs_15k`: These volumes offer even higher performance, with up to 15,000 IOPS, making them ideal for workloads requiring fast and reliable data access. + + To maximize compatibility with Block Storage Low Latency 15K, select an Instance with at least [3 GiB/s of Block bandwidth](/instances/reference-content/instances-bandwidth-overview/). + Volumes **created and managed through Kubernetes** do not fall within the scope of the migration described on this page. Find specific instructions for migrating Kubernetes volumes behind the Scaleway Block Storage API in the [managing storage for Kubernetes documentation](/kubernetes/api-cli/managing-storage/#upgrading-to-csi-version-03). From 14fd60104a90aaab0928bcda693b3fd95650adac Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 26 Feb 2025 16:37:46 +0100 Subject: [PATCH 3/7] fix(ins): update --- pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx index 2cd1c09719..0e210eb198 100644 --- a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx +++ b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx @@ -45,7 +45,9 @@ Alternatively, you can use the [snapshot export/import feature](/instances/api-c | `sbs_5k` (Block Low Latency 5K) | 5,000 | Modern NVMe disks | Low | 5 GB to 10 TB | Development environments, web servers, and applications needing consistent performance | 99.99% SLA, triple-replicated data to safeguard against hardware failures | | `sbs_15k` (Block Low Latency 15K) | 15,000 | Modern NVMe disks | Very low | 5 GB to 10 TB | High-performance databases, transactional applications, and I/O-intensive workloads | 99.99% SLA, triple-replicated data to safeguard against hardware failures | - +Refer to [Understand the difference between Block Storage volumes and Block Storage Low Latency volumes](/block-storage/reference-content/differences-between-5kiops-volumes/) for more information on the differences between Block Storage 5K legacy volumes and Block Storage Low Latency 5K volumes. + + You can attach a maximum of 16 volumes to a single Instance. From 6e826ad23e9f3084bcb670781dc0686f82f8b1ea Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 26 Feb 2025 16:39:35 +0100 Subject: [PATCH 4/7] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Néda <87707325+nerda-codes@users.noreply.github.com> --- .../instances/how-to/migrate-volumes-snapshots-to-sbs.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx index 0e210eb198..23f3522b96 100644 --- a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx +++ b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx @@ -185,8 +185,8 @@ You can attach a maximum of 16 volumes to a single Instance. - After the migration, the volume type of your volume remains `b_ssd` (displayed as **Block SSD 5K legacy** in the console). - To benefit from the new features and performance of Scaleway Block Storage, you must create a new volume (`sbs_5k` or `sbs_15k`) the using the snapshot export/import feature. For more information, see [Migrating using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features). + After the migration, your volume's type will still be `b_ssd` (displayed as **Block SSD 5K legacy** in the Scaleway console). + To benefit from the new features and performance of Scaleway Block Storage, you must create a new volume (`sbs_5k` or `sbs_15k` displayed as **Block Low Latency 5K** or **Block Low Latency 15K** in the Scaleway console) using the snapshot export/import feature. For more information, see [Migrating using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features). ### Migrating an existing Block Storage snapshot to Scaleway Block Storage management @@ -283,8 +283,8 @@ You can attach a maximum of 16 volumes to a single Instance. - After the migration, the volume type of your volume remains `b_ssd` (displayed as **Block SSD 5K legacy** in the console). - To benefit from the new features and performance of Scaleway Block Storage, you must create a new volume (`sbs_5k` or `sbs_15k`) the using the snapshot export/import feature. For more information, see [Migrating using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features). + After the migration, your volume's type will still be `b_ssd` (displayed as **Block SSD 5K legacy** in the Scaleway console). + To benefit from the new features and performance of Scaleway Block Storage, you must create a new volume (`sbs_5k` or `sbs_15k` displayed as **Block Low Latency 5K** or **Block Low Latency 15K** in the Scaleway console) using the snapshot export/import feature. For more information, see [Migrating using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features). ## Migrating using the snapshot export/import features From 5560aff231599697843954aeebfde4c1b9a79e96 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 26 Feb 2025 16:48:08 +0100 Subject: [PATCH 5/7] feat(ins): update content --- .../how-to/migrate-volumes-snapshots-to-sbs.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx index 23f3522b96..c117b35cc5 100644 --- a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx +++ b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx @@ -27,6 +27,10 @@ To facilitate the transition to Scaleway's new Block Storage management, two mai Each method caters to different needs, balancing uninterrupted service against achieving maximum performance benefits. After migration, these resources will be managed under [Storage](/block-storage/quickstart/) instead of Compute. + + Volumes **created and managed through Kubernetes** do not fall within the scope of the migration described on this page. Find specific instructions for migrating Kubernetes volumes behind the Scaleway Block Storage API in the [managing storage for Kubernetes documentation](/kubernetes/api-cli/managing-storage/#upgrading-to-csi-version-03). + + ## Comparison of migration methods | Migration Method | Advantage | Drawback | @@ -45,10 +49,10 @@ Alternatively, you can use the [snapshot export/import feature](/instances/api-c | `sbs_5k` (Block Low Latency 5K) | 5,000 | Modern NVMe disks | Low | 5 GB to 10 TB | Development environments, web servers, and applications needing consistent performance | 99.99% SLA, triple-replicated data to safeguard against hardware failures | | `sbs_15k` (Block Low Latency 15K) | 15,000 | Modern NVMe disks | Very low | 5 GB to 10 TB | High-performance databases, transactional applications, and I/O-intensive workloads | 99.99% SLA, triple-replicated data to safeguard against hardware failures | -Refer to [Understand the difference between Block Storage volumes and Block Storage Low Latency volumes](/block-storage/reference-content/differences-between-5kiops-volumes/) for more information on the differences between Block Storage 5K legacy volumes and Block Storage Low Latency 5K volumes. +You can attach a maximum of 16 volumes (including the mandatory boot volume) to a single Instance. -You can attach a maximum of 16 volumes to a single Instance. + Refer to [Understand the difference between Block Storage volumes and Block Storage Low Latency volumes](/block-storage/reference-content/differences-between-5kiops-volumes/) for more information on the differences between Block Storage 5K legacy volumes and Block Storage Low Latency 5K volumes. ### Additional details: @@ -60,10 +64,6 @@ You can attach a maximum of 16 volumes to a single Instance. To maximize compatibility with Block Storage Low Latency 15K, select an Instance with at least [3 GiB/s of Block bandwidth](/instances/reference-content/instances-bandwidth-overview/). - - Volumes **created and managed through Kubernetes** do not fall within the scope of the migration described on this page. Find specific instructions for migrating Kubernetes volumes behind the Scaleway Block Storage API in the [managing storage for Kubernetes documentation](/kubernetes/api-cli/managing-storage/#upgrading-to-csi-version-03). - - - A Scaleway account logged into the [console](https://console.scaleway.com) From efe89233e3c5fb83e59d8ea439f4d98414729784 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 26 Feb 2025 16:51:02 +0100 Subject: [PATCH 6/7] feat(ins): feature --- .../instances/how-to/migrate-volumes-snapshots-to-sbs.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx index c117b35cc5..72da6a6d54 100644 --- a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx +++ b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx @@ -27,10 +27,6 @@ To facilitate the transition to Scaleway's new Block Storage management, two mai Each method caters to different needs, balancing uninterrupted service against achieving maximum performance benefits. After migration, these resources will be managed under [Storage](/block-storage/quickstart/) instead of Compute. - - Volumes **created and managed through Kubernetes** do not fall within the scope of the migration described on this page. Find specific instructions for migrating Kubernetes volumes behind the Scaleway Block Storage API in the [managing storage for Kubernetes documentation](/kubernetes/api-cli/managing-storage/#upgrading-to-csi-version-03). - - ## Comparison of migration methods | Migration Method | Advantage | Drawback | @@ -41,6 +37,10 @@ Each method caters to different needs, balancing uninterrupted service against a This guide offers step-by-step instructions to migrate your volumes and snapshots using either the [Scaleway Command Line Interface (CLI)](/scaleway-cli/quickstart/) tool (recommended) or the [Instances API](https://www.scaleway.com/en/developers/api/instance/#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage). Alternatively, you can use the [snapshot export/import feature](/instances/api-cli/snapshot-import-export-feature/) to migrate your unified volumes and snapshots to Block Storage Low Latency volumes. + + Volumes **created and managed through Kubernetes** do not fall within the scope of the migration described on this page. Find specific instructions for migrating Kubernetes volumes behind the Scaleway Block Storage API in the [managing storage for Kubernetes documentation](/kubernetes/api-cli/managing-storage/#upgrading-to-csi-version-03). + + ## Comparison of Block Storage volume types | Volume type | IOPS | Underlying hardware | Latency | Max volume size | Recommended use cases | Availability & resilience | From a2c16bb1f825234811bc2b8b96eb0cde1d8b0eab Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 26 Feb 2025 17:24:06 +0100 Subject: [PATCH 7/7] feat(ins): add link --- pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx index 72da6a6d54..5cdc84e18f 100644 --- a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx +++ b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx @@ -25,7 +25,8 @@ To facilitate the transition to Scaleway's new Block Storage management, two mai - **Advantage:** The migrated volume will fully support low latency, and it is possible to modify the IOPS up to 15k. All existing data of the old volume will be copied to the new Block Storage Low Latency volume. - **Drawback:** A snapshot must be manually created, exported, and imported. After importing, the snapshot must be converted into a volume, which must then be attached to the Instance. This process may require downtime. -Each method caters to different needs, balancing uninterrupted service against achieving maximum performance benefits. After migration, these resources will be managed under [Storage](/block-storage/quickstart/) instead of Compute. +Each method caters to different needs, balancing uninterrupted service against achieving maximum performance benefits. After migration, these resources will be managed under [Storage](/block-storage/quickstart/) instead of Compute.
+Learn more about the [advantages of migrating from the Instance API to the Block Storage API for managing block volumes and snapshots](/block-storage/reference-content/advantages-migrating-to-sbs/). ## Comparison of migration methods