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.

Sign up for GitHub

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

feat(block-storage): migration documentation #4131

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
966266e
docs(bls): first batch
nerda-codes Dec 16, 2024
44c430d
docs(bls): second batch
nerda-codes Dec 19, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions compute/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,9 @@ During migration, unified snapshots will be converted into [Block Storage Low La

This guide offers step-by-step instructions to migrate your volumes and snapshots using either the [Scaleway Command Line Interface (CLI)](/developer-tools/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).

<Message type="tip">
The easiest way to migrate your Block Storage volumes and snapshots is by using the [Scaleway Command Line Interface (CLI)](/developer-tools/scaleway-cli/quickstart/) tool.
<Message type="note">
- The easiest way to migrate your Block Storage volumes and snapshots is by using the [Scaleway Command Line Interface (CLI)](/developer-tools/scaleway-cli/quickstart/) tool
- If you encounter an error about quota limitations during the migration process, [contact our support team](https://console.scaleway.com/support/tickets/create) for assistance.
</Message>

<Macro id="requirements" />
Expand Down Expand Up @@ -91,7 +92,7 @@ This guide offers step-by-step instructions to migrate your volumes and snapshot
$ scw instance volume apply-migration 369feb53-165f-437d-875e-188725df462b validation-key=30d129ca895c4cd59f4c429e12dab300 zone=fr-par-1
✅ Success
```
The volume migration is complete. You can now manage the migrated volume from the [Block Storage Volumes section](https://console.scaleway.com/block-storage/volumes) in the Scaleway console.
The volume migration is complete. You can now manage the migrated volume from the [Block Storage volumes section](https://console.scaleway.com/block-storage/volumes) in the Scaleway console.
</TabsTab>
<TabsTab label="API">
<Message type="note">
Expand Down
18 changes: 17 additions & 1 deletion faq/blockstorage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,4 +52,20 @@ The Block Storage billing scheme is not the same as for Object Storage. You are

## What other Scaleway resources are compatible with Block Storage?

Block Storage volumes are compatible with [Scaleway Instances](/compute/instances/), [Managed Dabatase for PostgreSQL and MySQL](/managed-databases/postgresql-and-mysql/), and [Kubernetes](/containers/kubernetes/) Kapsule clusters.
Block Storage volumes are compatible with [Scaleway Instances](/compute/instances/), [Managed Dabatase for PostgreSQL and MySQL](/managed-databases/postgresql-and-mysql/), and [Kubernetes](/containers/kubernetes/) Kapsule clusters.

## How can I convert a Block Storage legacy volume into a Block Storage Low Latency volume?

For better performance, you can convert your Block Storage legacy volumes into Block Storage Low Latency volumes.

To convert your volume you need to:

- Export the data: copy or back up the data from the Block storage legacy volume to an external location or intermediary storage (e.g., another temporary volume).

- Create a Block Storage Low Latency 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 ?

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

Find out how to [migrate your Block Storage legacy volumes and snapshots](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) from the Instance API to the Block Storage API.

Find out about the [advantages of migrating the management of your volumes and snapshots](advantages-migrating-to-sbs) from the Instance API to the Block Storage API.
9 changes: 9 additions & 0 deletions macros/storage/block-storage-migration.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
macro: block-storage-migration
---

<Message type="important">
- 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/).
- Find out about the [advantages of migrating the management of your volumes and snapshots](advantages-migrating-to-sbs) from the Instance API to the Block Storage API.
- Find out how to [migrate your Block Storage legacy volumes and snapshots](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) from the Instance API to the Block Storage API.
</Message>
12 changes: 12 additions & 0 deletions menu/navigation.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4559,6 +4559,10 @@
"label": "Create a Block Storage volume from a snapshot",
"slug": "create-volume-from-snapshot"
},
{
"label": "Identify a volume and snapshot type",
"slug": "identify-volume-snapshot-type"
},
{
"label": "Detach a volume",
"slug": "detach-a-volume"
Expand All @@ -4585,6 +4589,10 @@
"label": "Managing a volume",
"slug": "managing-a-volume"
},
{
"label": "Identifying the API managing Block Storage volumes and snapshots",
"slug": "identifying-volume-snapshot-api"
},
{
"label": "Unmounting a volume",
"slug": "unmounting-a-volume"
Expand All @@ -4598,6 +4606,10 @@
{
"label": "Differences between Block Storage volumes and Block Storage Low Latency volumes",
"slug": "differences-between-5kiops-volumes"
},
{
"label": "Advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage Low Latency",
"slug": "advantages-migrating-to-sbs"
}
],
"label": "Additional Content",
Expand Down
Loading
Loading