Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(block-storage): migration documentation #4131

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Conversation

nerda-codes
Copy link
Contributor

Documentation to prepare Block Storage migration from v1 to v2 volumes/snapshots

@nerda-codes nerda-codes added the type: new content New pages or categories label Dec 19, 2024
@nerda-codes nerda-codes self-assigned this Dec 19, 2024
@nerda-codes nerda-codes requested a review from bene2k1 as a code owner December 19, 2024 14:48
@nerda-codes nerda-codes added the do not merge PR that shouldn't be merged before a specific date (eg release) label Dec 19, 2024
```bash
scw instance volume list
```
An output similar to the following whould display:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
An output similar to the following whould display:
An output similar to the following should display:

4. Click the **Snapshot type** drop-down and select the snapshot type(s) to filter for.
5. Optionally, click the <Icon name="more" /> icon next to a specific snapshot to display its information page, and verify the type next to the **Type** field.
6. Click **Clear filters** once you are done.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change


### Underlying hardware

Instance API volumes are built on **older-generation SSDs**, resulting in **slower performance and have a higher latency**, which may impact the responsiveness of applications.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Instance API volumes are built on **older-generation SSDs**, resulting in **slower performance and have a higher latency**, which may impact the responsiveness of applications.
Instance API volumes are built on **older-generation SSDs**, resulting in **slower performance and a higher latency**, which may impact the responsiveness of applications.


Instance API volumes have a **limited performance** due to older SSD technology. They also have a **lower IOPS and slower data processing speed**.

Block Storage API volumes benefit from e**nhanced performance with up to 15K IOPS**.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Block Storage API volumes benefit from e**nhanced performance with up to 15K IOPS**.
Block Storage API volumes benefit from **enhanced performance with up to 15K IOPS**.


Scaleway is transitioning the management of all Block Storage legacy volumes and snapshots from the [Instance API](https://www.scaleway.com/en/developers/api/instance/) to the [Block Storage API](https://www.scaleway.com/en/developers/api/block/). All Block Storage volumes and snapshots created via the [Scaleway console](https://console.scaleway.com) will no longer be available from the [Compute section](https://console.scaleway.com/instance/), but from the [Storage section](https://console.scaleway.com/block-storage).

This change provides you with enhanced performance and advanced storage capabilities. If you have created volumes and snapshots via the Instance API, we **strongly recommend migrating them to the Block Storage API** to benefit from these improvements.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There won't be perf update when migrating API


By migrating your Block Storage volumes and snapshots to the Block Storage API, you take advantage of the following benefits:

- **Low latency**: volumes managed by the Block Storage API leverage modern hardware, ensuring faster access times and smoother performance.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instance API handles bssd volumes which will still be bssd volumes behind the SBS/block API

By migrating your Block Storage volumes and snapshots to the Block Storage API, you take advantage of the following benefits:

- **Low latency**: volumes managed by the Block Storage API leverage modern hardware, ensuring faster access times and smoother performance.
- **Higher IOPS performance**: benefit from up to 5K IOPS (input/output operations per second) with Block Storage Low Latency volumes and 15K IOPS with higher-tier offerings. These performance improvements are ideal for applications requiring rapid data access and high-speed operations.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bssd volumes won't be sbs5k or sbs15k volumes when migrating API


## Differences between volumes managed by the Instance API and the Block Storage API

Volumes created with the Instance API differ from those created with the Block Storage API in both hardware and performance characteristics:
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's more a storage class diff then an APi diff that explains hw/perf diff
Instance API handles only bssd volumes whereas SBS/block API handles bssd+sbs5k+sbs15k volume

- Create a Block Storage Low Latency volume

- Import the data: restore or transfer the data from the backup or intermediary storage into the newly created volume.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I find it weird to split the create and import in 2 steps whereas it is actually a single call performing both

Also should we not say this is a temporary/not ideal solution before being effectively able to change the storage class of a volume while preserving its id ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
do not merge PR that shouldn't be merged before a specific date (eg release) type: new content New pages or categories
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants