diff --git a/menu/navigation.json b/menu/navigation.json index 8226620326..7d28e1cc9b 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -1451,12 +1451,8 @@ "slug": "create-an-instance" }, { - "label": "Create a Block Storage volume", - "slug": "create-a-block-volume" - }, - { - "label": "Manage Block Storage volumes", - "slug": "manage-volumes" + "label": "Manage Instance storage", + "slug": "manage-storage" }, { "label": "Connect to an Instance", @@ -1494,22 +1490,11 @@ "label": "Use placement groups", "slug": "use-placement-groups" }, - { - "label": "Create an image", - "slug": "create-a-backup" - }, - { - "label": "Create a snapshot", - "slug": "create-a-snapshot" - }, + { "label": "Create an image from a snapshot", "slug": "create-image-from-snapshot" }, - { - "label": "Use the snapshot import/export feature", - "slug": "snapshot-import-export-feature" - }, { "label": "Migrate volumes and snapshots to Scaleway SBS", "slug": "migrate-volumes-snapshots-to-sbs" @@ -4578,6 +4563,58 @@ "label": "Object Storage", "slug": "object-storage" }, + { + "items": [ + { + "label": "Overview", + "slug": "../local-storage" + }, + { + "label": "Concepts", + "slug": "concepts" + }, + { + "label": "Quickstart", + "slug": "quickstart" + }, + { + "items": [ + { + "label": "Create a volume", + "slug": "create-volume" + }, + { + "label": "Attach a volume", + "slug": "attach-volume" + }, + { + "label": "Create a snapshot of a Local Storage volume", + "slug": "create-snapshot" + }, + { + "label": "Create a Local Storage volume from a snapshot", + "slug": "create-volume-from-snapshot" + }, + { + "label": "Detach a volume", + "slug": "detach-volume" + }, + { + "label": "Delete a snapshot", + "slug": "delete-snapshot" + }, + { + "label": "Delete a volume", + "slug": "delete-volume" + } + ], + "label": "How to", + "slug": "how-to" + } + ], + "label": "Local Storage", + "slug": "local-storage" + }, { "items": [ { diff --git a/pages/block-storage/faq.mdx b/pages/block-storage/faq.mdx index 7e9ca10601..ed2a973a06 100644 --- a/pages/block-storage/faq.mdx +++ b/pages/block-storage/faq.mdx @@ -79,7 +79,7 @@ Although there is no direct way to change the storage class of a volume while pr While this approach allows you to transition to a Block Storage Low Latency volume, it is only a workaround. -1. [Create a snapshot of your Block Storage legacy volume](/instances/how-to/create-a-snapshot/). +1. [Create a snapshot of your Block Storage legacy volume](/block-storage/how-to/create-a-snapshot/). 2. [Export the snapshot](/instances/api-cli/snapshot-import-export-feature/#exporting-snapshots). 3. [Import the snapshot into a new Low Latency volume](https://www.scaleway.com/en/developers/api/block/#path-snapshot-import-a-snapshot-from-a-scaleway-object-storage-bucket). diff --git a/pages/instances/api-cli/snapshot-import-export-feature.mdx b/pages/instances/api-cli/snapshot-import-export-feature.mdx index 6e3bd93897..5f07468619 100644 --- a/pages/instances/api-cli/snapshot-import-export-feature.mdx +++ b/pages/instances/api-cli/snapshot-import-export-feature.mdx @@ -28,7 +28,7 @@ More information on the QCOW2 file format, and how to use it can be found in the - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization - An [Instance](/instances/how-to/create-an-instance/) with [Block Storage volumes](/block-storage/how-to/create-a-volume/) - A valid [API key](/iam/how-to/create-api-keys/) -- A [snapshot](/instances/how-to/create-a-snapshot/) +- A [snapshot](/block-storage/how-to/create-a-snapshot/) - An [Object Storage bucket](/object-storage/how-to/create-a-bucket/) ## Exporting snapshots @@ -38,7 +38,7 @@ More information on the QCOW2 file format, and how to use it can be found in the You need an Object Storage bucket to export your QCOW2 file into. Any bucket that belongs to the same project as the snapshot can be used. However, if you do not have one already, you can [create it](/object-storage/how-to/create-a-bucket/) in the console. 2. Create a snapshot from a volume. - To use this functionality, you must [create a snapshot](/instances/how-to/create-a-snapshot/#how-to-create-a-snapshot) from the volume you want to export. + To use this functionality, you must [create a snapshot](/block-storage/how-to/create-a-snapshot/#how-to-create-a-snapshot) from the volume you want to export. 3. Call the `export` snapshot API endpoint to initiate the snapshot export. For example, using curl: diff --git a/pages/instances/concepts.mdx b/pages/instances/concepts.mdx index 1f2edc5343..bb83843ba8 100644 --- a/pages/instances/concepts.mdx +++ b/pages/instances/concepts.mdx @@ -154,7 +154,7 @@ Security groups allow you to [create rules to drop or allow public traffic comin ## Snapshot -A snapshot takes a picture of a specific volume at one point in time. For example, you may have a server with one volume containing the OS and another containing the application data and want to use different snapshot strategies on both volumes. [Creating snapshots of your volumes](/instances/how-to/create-a-snapshot/) gives you total freedom of which volumes you want to back up, while [images](#image) are more convenient for full backups of your Instance. +A snapshot takes a picture of a specific volume at one point in time. For example, you may have a server with one volume containing the OS and another containing the application data and want to use different snapshot strategies on both volumes. [Creating snapshots of your volumes](/block-storage/how-to/create-a-snapshot/) gives you total freedom of which volumes you want to back up, while [images](#image) are more convenient for full backups of your Instance. ## Snapshot type @@ -180,6 +180,6 @@ Tags allow you to organize, sort, filter, and monitor your cloud resources using Volumes are the storage space of your Instances. Two types of volumes exist: -* **Local volumes**: The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). +* **[Local volumes](/local-storage/)**: The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). -* **Block volumes**: Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. Block volumes behave like regular disks and can be used to increase the storage of an Instance. \ No newline at end of file +* **[Block volumes*](/block-storage/)*: Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. Block volumes behave like regular disks and can be used to increase the storage of an Instance. \ No newline at end of file diff --git a/pages/instances/faq.mdx b/pages/instances/faq.mdx index f472222a5c..197b67095e 100644 --- a/pages/instances/faq.mdx +++ b/pages/instances/faq.mdx @@ -15,7 +15,7 @@ productIcon: InstanceProductIcon ### How can I create an image? -You must [create at least one snapshot](/instances/how-to/create-a-snapshot/) before creating an image. +You must [create at least one snapshot](/block-storage/how-to/create-a-snapshot/) before creating an image. See the documentation on [creating an image from scratch](/instances/how-to/create-image-from-snapshot/). diff --git a/pages/instances/how-to/create-a-backup.mdx b/pages/instances/how-to/create-a-backup.mdx index 95c0fd58ea..7900292cfd 100644 --- a/pages/instances/how-to/create-a-backup.mdx +++ b/pages/instances/how-to/create-a-backup.mdx @@ -7,7 +7,7 @@ content: paragraph: This page explains how to create an image of your Instance tags: instance image backup dates: - validation: 2025-03-11 + validation: 2025-03-24 posted: 2021-05-26 categories: - compute @@ -18,7 +18,7 @@ The image feature lets you create an image of your Instance, which contains all This feature is available on Instance types. Creating images of your Instance is free. However, keep in mind that as the image feature creates snapshots of your volumes, you will be billed for these snapshots. - This creates an image that is a complete backup of your Instance including **all** of its volumes. The [snapshot](/instances/concepts/#snapshot) feature, on the other hand, creates snapshots of specific volumes. Consider [creating a snapshot](/instances/how-to/create-a-snapshot/) if you want to use different snapshot strategies for different volumes of your Instance, e.g., if it has one volume containing the OS and another containing application data. + This creates an image that is a complete backup of your Instance including **all** of its volumes. The [snapshot](/instances/concepts/#snapshot) feature, on the other hand, creates snapshots of specific volumes. Consider [creating a snapshot](/block-storage/how-to/create-a-snapshot/) if you want to use different snapshot strategies for different volumes of your Instance, e.g., if it has one volume containing the OS and another containing application data. @@ -32,13 +32,13 @@ This feature is available on Instance types. Creating images of your Instance is 1. Click **Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays. 2. Click the Instance you want to back up. -3. Click the **Images** tab. -4. Click **+ Create image**. A pop-up displays asking you to confirm the action. +3. Go to the **Images** section of the Instace's overview page. +4. Click **Create image from Instance**. A pop-up displays asking you to confirm the action. 5. Click **Create image from Instance**. - You are returned to the **Images** tab, where your new image now displays. + You are returned to the **Storage** tab, where your new image now displays. - When you create an image, each of the Instance's volumes are snapshotted. You will be able to see the snapshot of each volume via the [**Snapshots**](https://console.scaleway.com/instance/snapshots) tab of your Instance dashboard. + When you create an image, each of the Instance's volumes are snapshotted. You will be able to see the snapshot of each volume via the **Storage** tab of your Instance dashboard. @@ -56,9 +56,9 @@ A new Instance is created from your image. 1. Click **Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays. 2. Click the Instance you created an image of. -3. Click the **Images** tab. +3. Click the **Storage** tab and scroll down to the **Images** section of the page. 4. Click next to the Instance's image. -5. Select **Create Instance from image** on the drop-down list. You are redirected to the Instance Creation wizard, where the image has been preselected for you at step 2. +5. Select **Create Instance** on the drop-down list. You are redirected to the Instance creation wizard, where the image has been preselected for you at step 2. 6. Finish configuring the Instance according to your requirements, and click **Create Instance**. A new Instance is created from your image. @@ -66,7 +66,8 @@ A new Instance is created from your image. ## How to manage your images 1. Click **Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays. -2. Click the **Images** tab. A list of your images displays. +2. Click the **Storage** tab. A list of your storage resources displays. +3. Scroll to the **Images** section of the page. 3. Click next to the relevant image. - Select **More info** to view more information about the image, including its name, status, location, size, type, ID, and creation date. - Select **Delete** to delete the image if you no longer need it, and confirm via the pop-up window when prompted. diff --git a/pages/instances/how-to/create-a-block-volume.mdx b/pages/instances/how-to/create-a-block-volume.mdx deleted file mode 100644 index 68b6263fc6..0000000000 --- a/pages/instances/how-to/create-a-block-volume.mdx +++ /dev/null @@ -1,47 +0,0 @@ ---- -meta: - title: How to create a Block Storage volume - description: This page explains how to create Block Storage volumes in Scaleway -content: - h1: How to create a Block Storage volume - paragraph: This page explains how to create Block Storage volumes in Scaleway -tags: create volume add -dates: - validation: 2025-02-25 - posted: 2023-11-23 -categories: - - instances - - compute ---- - - - -- A Scaleway account logged into the [console](https://console.scaleway.com) -- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization - - - This procedure refers to legacy block volumes. To low latency block volumes, refer to the [dedicated documentation](/block-storage/how-to/create-a-volume/). - - -- -1. Click **Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays. -2. Click the **Volumes** tab to display a list of all your current volumes. -3. Click **Create volume** to create a volume that can be attached to any of your Instances. -4. Choose an Availability Zone for the volume. - - The volume must be in the same Availability Zone as the Instance you want to connect it to. - -5. Enter the volume name and select a size. -6. Configure the volume type. You can either create a **Block Storage** or **Local Storage** volume. - - To use **[Block Storage Low Latency](/block-storage/) 15k**, your Instance must have at least **3 GiB/s of block bandwidth**. - You can verify if an Instance type meets this requirement by consulting the [Scaleway Instances internet and Block Storage bandwidth overview](/instances/reference-content/instances-bandwidth-overview/) documentation. - - Alternatively, use the [Instances API](https://www.scaleway.com/en/developers/api/instance/#path-instance-types-list-instance-types) to check the `block_bandwidth` field at `/instance/v1/zones/{zone}/products/servers`. - This field provides detailed information about block bandwidth for each Instance type, helping you ensure compatibility with high-performance storage. - -7. Click **Create volume** to confirm. - - - You can also [create](/block-storage/how-to/create-a-volume/) Block Storage volumes from the [Block Storage console section](https://console.scaleway.com/block-storage/). - \ No newline at end of file diff --git a/pages/instances/how-to/create-a-snapshot.mdx b/pages/instances/how-to/create-a-snapshot.mdx deleted file mode 100644 index 25f6877098..0000000000 --- a/pages/instances/how-to/create-a-snapshot.mdx +++ /dev/null @@ -1,69 +0,0 @@ ---- -meta: - title: How to create a snapshot - description: Learn how to create a volume snapshot for a Scaleway Instance with this easy-to-follow guide. -content: - h1: How to create a snapshot - paragraph: Learn how to create a volume snapshot for a Scaleway Instance with this easy-to-follow guide. -tags: snapshot instance -dates: - validation: 2025-01-02 - posted: 2021-05-26 -categories: - - compute ---- - -The snapshot feature allows you to create an image of a specific [volume](/instances/concepts/#volumes) of your Instance. A snapshot is a full-volume copy stored in our secure data centers. They are usually used to recover volume data or to create a copy of a volume. - -Several options are available to create snapshots from your Instance: - -* **LSSD (Local Storage):** This snapshot type can be created from local volumes. LSSD snapshots can be converted to local volumes only. -* **BSSD (Block Storage):** This snapshot type can be created from block volumes. BSSD snapshots can be converted to block volumes only. - - - The snapshot feature creates backups of specific volumes only. If you wish to create a backup image that is a complete backup of your Instance including **all** of its volumes, check out our documentation on [how to create an image](/instances/how-to/create-a-backup/). - - - - -- A Scaleway account logged into the [console](https://console.scaleway.com) -- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization -- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/) -- An [Instance](/instances/how-to/create-an-instance/) - -## How to create a snapshot - -1. Click **Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays. -2. Click the **Snapshots** tab. - -3. Click the **+ Create snapshot** button. You are directed to the snapshot creation wizard. -4. Complete the following steps in the wizard: - - Choose a **name** for the snapshot, or use the default suggested name. - - Select the **volume** you wish to snapshot. All of your Instances' volumes will be shown on the drop-down list, grouped by Availability Zone. - - Select the **snapshot type**. The available types of snapshots depend on your volume type and can either be LSSD or BSSD. - - Check the **Estimated cost**. -5. Click **Create snapshot** to finish. You are redirected to the **Snapshots** tab, where your new snapshot now appears in the list. - -## How to create a volume from a snapshot - -You can create a [volume](/instances/concepts/#volumes) from a snapshot as follows: - -1. Click **Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays. -2. Click the **Snapshots** tab. -3. Click next to the snapshot you want to create an image from. A drop-down menu displays. -4. Click **Volume from snapshot**. A pop-up displays. - -5. Enter a name for the volume (or use the default suggested name), select the volume type, and click **Create volume from Snapshot**. - - The available volume types may change according to the type of snapshot you select. - - - The volume is created, and can be viewed in the [Volumes tab](https://console.scaleway.com/instance/volumes). Check out our documentation on [attaching volumes](/block-storage/how-to/attach-a-volume/) and [mounting volumes](/block-storage/api-cli/managing-a-volume/#mounting-and-using-a-block-storage-volume) to learn how to use the volume with your Instances. - -## How to create an Instance from a snapshot - -Follow the instructions for [creating an Instance](/instances/how-to/create-an-instance/). At the **Choose an image** step of the creation wizard, click the **My snapshots** tab, and select the desired snapshot. - - - -You can see the snapshotted volume in the Instance's volumes at **step 4** of the creation wizard. \ No newline at end of file diff --git a/pages/instances/how-to/create-image-from-snapshot.mdx b/pages/instances/how-to/create-image-from-snapshot.mdx index 3bbb3dfe9b..546d34d8c8 100644 --- a/pages/instances/how-to/create-image-from-snapshot.mdx +++ b/pages/instances/how-to/create-image-from-snapshot.mdx @@ -18,7 +18,7 @@ categories: - A Scaleway account logged into the [console](https://console.scaleway.com) - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization - An [Instance](/instances/how-to/create-an-instance/) -- At least one [snapshot](/instances/how-to/create-a-snapshot/) +- At least one [snapshot](/block-storage/how-to/create-a-snapshot/) ## Creating an image from a snapshot via the Scaleway console diff --git a/pages/instances/how-to/manage-storage.mdx b/pages/instances/how-to/manage-storage.mdx new file mode 100644 index 0000000000..0ac854167d --- /dev/null +++ b/pages/instances/how-to/manage-storage.mdx @@ -0,0 +1,101 @@ +--- +meta: + title: How to manage Instance storage + description: This page explains how to manage Instance storage +content: + h1: How to manage Instance storage + paragraph: This page explains how to manage Instance storage +tags: attach link connect block volume block-storage +dates: + validation: 2025-03-24 + posted: 2025-03-24 +categories: + - compute +--- + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization + +## Storage resources overview +You can manage the storage resources attached to your Instances directly from the Scaleway console. These include: + +- **[Volumes](#managing-volumes)**: Storage spaces used by your Instances. Multiple volumes can be attached to an Instance. +- **[Snapshots](#managing-snapshots)**: Backups capturing the state of a volume at a specific time, including OS, configuration, and stored files. +- **[Images](#managing-images)**: Full backups of Instances, useful for restoring data or deploying multiple Instances with a predefined configuration. + +## Managing volumes +Volumes are the primary storage solution for your Instances. Scaleway Instances support either **Local Storage** or **Block Storage**, depending on the Instance type. + + + If a volume is missing, check the [Block Storage](https://console.scaleway.com/block-storage/volumes) or [Local Storage](https://console.scaleway.com/local-storage/volumes) sections in the Scaleway console. + + +### Viewing and managing volumes +1. Click **Instances** in the left menu. +2. Select the Instance you want to manage. +3. Go to the **Storage** tab. +4. Scroll to the **Volumes** section to view attached volumes. +5. Click next to a volume for options: + - View volume details + - [Increase volume size](/block-storage/how-to/increase-block-volume/) + - [Detach volume](/block-storage/how-to/detach-a-volume/) + - [Create a snapshot](/block-storage/how-to/create-a-snapshot/) + - [Delete volume](/block-storage/how-to/delete-a-volume/) + +### Adding a volume +1. Navigate to **Instances** in the left menu. +2. Select the Instance you want to configure. +3. Open the **Storage** tab. +4. Click **+ Create volume** in the **Volumes** section. +5. Enter a volume name and choose its size (GB). +6. Select a storage type: + - **Block Storage**: A network-based block device with 5,000 or 15,000 IOPS. + - **Local Storage**: Storage located on the physical hypervisor, tied to compute resources. +7. Click **Add volume** to attach it to the Instance. + +## Managing snapshots +Snapshots preserve the state of a volume at a specific time, allowing for data recovery. + +### Viewing and managing snapshots +1. Click **Instances** in the left menu. +2. Select the Instance you want to configure. +3. Go to the **Storage** tab. +4. Scroll to the **Snapshots** section. +5. Click for snapshot options: + - View details + - [Create an image from snapshot](/instances/how-to/create-image-from-snapshot/) + - [Create a volume from snapshot](/block-storage/how-to/create-volume-from-snapshot/) + - [Copy to an Object Storage bucket](/block-storage/how-to/create-volume-from-snapshot/) + - [Delete snapshot](/block-storage/how-to/delete-a-snapshot/) + +### Creating a snapshot +1. Click **Instances** in the left menu. +2. Select the Instance you want to configure. +3. Open the **Storage** tab. +4. Click **+ Create snapshot** in the **Snapshots** section. +5. Choose a volume from the dropdown. +6. Enter a snapshot name. +7. Click **Create snapshot** to proceed. + +## Managing images +Images are full backups of Instances, useful for restoring data or deploying multiple Instances. + +### Viewing and managing images +1. Click **Instances** in the left menu. +2. Select the Instance you want to configure. +3. Open the **Storage** tab. +4. Scroll to the **Images** section. +5. Click for options: + - View details + - Create an Instance from the image + - Delete the image + +### Creating an image +1. Click **Instances** in the left menu. +2. Select the Instance you want to configure. +3. Open the **Storage** tab. +4. Click **+ Create image** in the **Images** section. +5. Enter a name for the image. +6. Click **Create image** to proceed. diff --git a/pages/instances/how-to/manage-volumes.mdx b/pages/instances/how-to/manage-volumes.mdx deleted file mode 100644 index 1a627890fc..0000000000 --- a/pages/instances/how-to/manage-volumes.mdx +++ /dev/null @@ -1,90 +0,0 @@ ---- -meta: - title: How to manage Block Storage volumes - description: This page explains how to manage Block Storage volumes -content: - h1: How to manage Block Storage volumes - paragraph: This page explains how to manage Block Storage volumes -tags: attach link connect block volume block-storage -dates: - validation: 2024-12-09 - posted: 2023-11-23 -categories: - - compute ---- - - - -- A Scaleway account logged into the [console](https://console.scaleway.com) -- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization -- A [Block Storage volume](/block-storage/how-to/create-a-volume/) - -## How to attach a volume - - - You must have created a [volume](/block-storage/how-to/create-a-volume/) that is not attached to any of your Instances before proceeding with the steps below. - - -1. Click **Instances** from the left side menu. The Instances section displays. -2. Click the **Volumes** tab to display a list of all your current volumes. -3. Click **Attach to Instance** under the **Linked Instance** section. -4. Select the Instance to which you want to attach your volume from the drop-down. -5. Click **Attach volume to Instance**. - - - Find out [how to mount a Block Storage volume to your Instance](/block-storage/api-cli/managing-a-volume/#mounting-and-using-a-block-storage-volume). - - - To use **[Block Storage Low Latency](/block-storage/) 15k**, your Instance must have at least **3 GiB/s of block bandwidth**. - You can verify if an Instance type meets this requirement by consulting the [Scaleway Instances internet and Block Storage bandwidth overview](/instances/reference-content/instances-bandwidth-overview/) documentation. - - Alternatively, use the [Instances API](https://www.scaleway.com/en/developers/api/instance/#path-instance-types-list-instance-types) to check the `block_bandwidth` field at `/instance/v1/zones/{zone}/products/servers`. - This field provides detailed information about block bandwidth for each Instance type, helping you ensure compatibility with high-performance storage. - -## How to increase the volume size - -1. Click the [Volumes tab](https://console.scaleway.com/instance/volumes) on the Instance information page of the Scaleway console. A list of your volumes displays. -2. Click next to the volume you want to increase and then click **Increase Volume**. -3. Increase the size according to your preference with the button. -4. Click **Increase volume** to confirm. - - Currently, only the **increase** of a Block Storage volume is supported. The maximum size of a Block Storage volume is 10 TB. - - - - Refer to our [dedicated documentation](/block-storage/api-cli/managing-a-volume/#increasing-the-partition-size-of-the-volume-with-growpart) to find out how to increase the partition size of your volume. - - -## How to detach a volume - -You can detach a Block Storage volume from your Instance at any time. It is important to [unmount (detach) the device](/block-storage/api-cli/unmounting-a-volume/) from the operating system before detaching the Block Storage volume to avoid data loss. - - - -- A Scaleway account logged into the [console](https://console.scaleway.com) -- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization -- A [Block Storage volume](/block-storage/concepts/#block-device) attached to a Scaleway Instance - -1. Click **Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays. -2. Click the Instance with the volume you want to detach. The Instance information page displays. -3. Click the **Attached volumes** tab. A list of all volumes attached to the Instance displays. -4. Click next to the volume you want to detach, then click **Detach**. A pop-up displays. -5. Click **Detach volume from Instance** to confirm. - -## How to delete a volume - - - You must detach a Block Storage volume from an Instance to delete it. Refer to our [documentation](/block-storage/how-to/detach-a-volume/) to find out how to do so. - - -1. Click **Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays. -2. Click the **Volumes** tab to view a list of your volumes. -3. Click next to the volume that you want to delete. -4. Click **Delete**. A pop-up displays. -5. Type `DELETE` to confirm. -6. Click **Delete volume** to remove the volume from your account. - - All data on the volume will be removed when you delete it. Make sure you have a backup of your data before removing the volume. - - - 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 5cdc84e18f..96ed106892 100644 --- a/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx +++ b/pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx @@ -298,7 +298,7 @@ To convert your unified volumes and snapshots, you can use the snapshot export/i Follow the procedure below: -1. [Create a snapshot of your Block Storage legacy volume](/instances/how-to/create-a-snapshot/). +1. [Create a snapshot of your Block Storage legacy volume](/block-storage/how-to/create-a-snapshot/). 2. [Export the snapshot](/instances/api-cli/snapshot-import-export-feature/#exporting-snapshots). 3. [Import the snapshot into a new Low Latency volume](https://www.scaleway.com/en/developers/api/block/#path-snapshot-import-a-snapshot-from-a-scaleway-object-storage-bucket). diff --git a/pages/instances/how-to/snapshot-import-export-feature.mdx b/pages/instances/how-to/snapshot-import-export-feature.mdx index 1f41a8fb3c..4db258e4a3 100644 --- a/pages/instances/how-to/snapshot-import-export-feature.mdx +++ b/pages/instances/how-to/snapshot-import-export-feature.mdx @@ -7,7 +7,7 @@ content: paragraph: This page explains how to import/export snapshots of Instances using the Scaleway console. tags: snapshot, import, export, instance, availability zone, qcow2 dates: - validation: 2025-02-17 + validation: 2025-03-25 posted: 2021-07-27 categories: - compute @@ -33,10 +33,10 @@ More information on the QCOW2 file format and how to use it can be found in the For this guide, we assume you have an Instance running in the `fr-par-1` AZ, your Object Storage bucket is located in the region `fr-par`, and you want to create a new Instance in the `fr-par-2` AZ. -1. Click the [Instances section](https://console.scaleway.com/instance/servers) of the Scaleway console, then click the **Snapshots** tab. -2. Click **+ Create snapshot**. The snapshot creation wizard appears. Enter a name and select the volume to snapshot. Then click **Create snapshot**. The snapshot is created, and the list of all your snapshots displays. - -3. Click next to the relevant snapshot, and select **Copy to bucket**. A pop-up displays. Enter the file name for your exported snapshot copy and select the destination bucket. Then click **Copy snapshot to bucket**. +1. Click the [Instances section](https://console.scaleway.com/instance/servers) of the Scaleway console, then click the Instance you want to snapshot. +2. The Instance overview displays. Click the **Storage** tab to display the storage resources attached to the Instance. Scroll to the **Snapshots** section of the page. +3. Click the name of the snapshot you want to export. The snapshot overview displays. +4. Click **Actions** then select **Copy to bucket**. A pop-up displays. Enter the file name for your exported snapshot copy and select the destination bucket. Then click **Copy snapshot to bucket**. ## Importing the snapshot into the destination AZ diff --git a/pages/instances/reference-content/cost-optimized.mdx b/pages/instances/reference-content/cost-optimized.mdx index a145218e29..76cf345384 100644 --- a/pages/instances/reference-content/cost-optimized.mdx +++ b/pages/instances/reference-content/cost-optimized.mdx @@ -70,7 +70,7 @@ The table below displays the technical specifications of COP-ARM Instances: To help build and manage your applications, consider complementing your Instance with the following compatible services: - [Learn how to back up your Instance](/instances/how-to/create-a-backup/) -- [Learn how to create snapshots of your Instance for specific volumes](/instances/how-to/create-a-snapshot/) +- [Learn how to create snapshots of your Instance for specific volumes](/block-storage/how-to/create-a-snapshot/) - [Learn how to migrate your data from one Instance to another](/instances/how-to/migrate-instances/) ## Matching use cases diff --git a/pages/instances/reference-content/learning.mdx b/pages/instances/reference-content/learning.mdx index d63ce85a32..7278a210f6 100644 --- a/pages/instances/reference-content/learning.mdx +++ b/pages/instances/reference-content/learning.mdx @@ -39,7 +39,7 @@ Scaleway's **Learning** range includes our Stardust Instances. Stardust Instance To help build and manage your applications, consider complementing your Stardust Instance with the following compatible services: - [Learn how to back up your Instance](/instances/how-to/create-a-backup/) -- [Learn how to create snapshots of your Instance for specific volumes](/instances/how-to/create-a-snapshot/) +- [Learn how to create snapshots of your Instance for specific volumes](/block-storage/how-to/create-a-snapshot/) - [Learn how to migrate your data from one Instance to another](/instances/how-to/migrate-instances/) ## Matching use cases diff --git a/pages/instances/reference-content/production-optimized.mdx b/pages/instances/reference-content/production-optimized.mdx index fc121a3233..17e086b303 100644 --- a/pages/instances/reference-content/production-optimized.mdx +++ b/pages/instances/reference-content/production-optimized.mdx @@ -64,7 +64,7 @@ See below the technical specifications of Production-Optimized Instances: ## Complementary services To help build and manage your applications, consider complementing your Production-Optimized Instances with the following compatible services: - [Learn how to back up your Instance](/instances/how-to/create-a-backup/) -- [Learn how to create snapshots of your Instance for specific volumes](/instances/how-to/create-a-snapshot/) +- [Learn how to create snapshots of your Instance for specific volumes](/block-storage/how-to/create-a-snapshot/) - [Learn how to migrate your data from one Instance to another](/instances/how-to/migrate-instances/) ## Matching use cases diff --git a/pages/instances/reference-content/workload-optimized.mdx b/pages/instances/reference-content/workload-optimized.mdx index 1f7a22c69d..429168ab5f 100644 --- a/pages/instances/reference-content/workload-optimized.mdx +++ b/pages/instances/reference-content/workload-optimized.mdx @@ -40,7 +40,7 @@ See below the technical specifications of Workload-Optimized Instances: ## Complementary services To help build and manage your applications, consider complementing your Workload-Optimized Instance with the following compatible services: - [Learn how to back up your Instance](/instances/how-to/create-a-backup/) -- [Learn how to create snapshots of your Instance for specific volumes](/instances/how-to/create-a-snapshot/) +- [Learn how to create snapshots of your Instance for specific volumes](/block-storage/how-to/create-a-snapshot/) - [Learn how to migrate your data from one Instance to another](/instances/how-to/migrate-instances/) ## Matching use cases diff --git a/pages/instances/troubleshooting/bootscript-eol.mdx b/pages/instances/troubleshooting/bootscript-eol.mdx index b8699f0ee2..37019e46f8 100644 --- a/pages/instances/troubleshooting/bootscript-eol.mdx +++ b/pages/instances/troubleshooting/bootscript-eol.mdx @@ -92,7 +92,7 @@ If your Instance is using the bootscript option to boot in normal mode you are i #### Create a snapshot of the volume(s) and export it to Object Storage to retrieve the data - 1. [Create a snapshot](/instances/how-to/create-a-snapshot/) of the volume using the **l_ssd** type of snapshot. + 1. [Create a snapshot](/block-storage/how-to/create-a-snapshot/) of the volume using the **l_ssd** type of snapshot. 2. [Export](/instances/how-to/snapshot-import-export-feature/) the snapshot to an Object Storage bucket in the same region as the Instance. 3. Retrieve your data from the Object Storage bucket and reuse it at your convenience. 4. Delete the old Instance that was using a bootscript once you have recovered your data. diff --git a/pages/local-storage/concepts.mdx b/pages/local-storage/concepts.mdx new file mode 100644 index 0000000000..3517999cc4 --- /dev/null +++ b/pages/local-storage/concepts.mdx @@ -0,0 +1,40 @@ +--- +meta: + title: Local Storage - Concepts + description: This page explains all the concepts related to Scaleway Local Storage +content: + h1: Local Storage - Concepts + paragraph: This page explains all the concepts related to Scaleway Local Storage +tags: local storage +dates: + validation: 2025-03-24 +categories: + - storage +--- + +## Block volumes + +Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. From a user's point of view, block volumes behave like regular disks and can be used to increase the storage of an Instance. + +## Boot-on-Block + +Some Instance types do not use local volumes and instead boot directly on block volumes. + +## Local volumes + +The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). In any case, it is always possible to increase the storage of an Instance by adding additional block volumes. + +## Power-off mode + +The power-off mode shuts down an Instance by transferring all data on the local volume of the Instance to a volume store. The physical node is released back to the pool of available machines. The reserved flexible IP of the Instance remains available in the account. + +## Standby mode + +Standby mode is a way to stop an Instance temporarily. When you put an Instance in standby mode, the server is halted, but the Instance remains allocated to your account, and all data remains on the Local Storage of the Instance. + +## Volumes + +Volumes are the storage space of your Instances. Two types of volumes exist: + +- **[Local volumes](/local-storage/)**: The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). +- **[Block volumes](/block-storage/)**: Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. Block volumes behave like regular disks and can be used to increase the storage of an Instance. diff --git a/pages/local-storage/how-to/attach-volume.mdx b/pages/local-storage/how-to/attach-volume.mdx new file mode 100644 index 0000000000..17dbd4639d --- /dev/null +++ b/pages/local-storage/how-to/attach-volume.mdx @@ -0,0 +1,36 @@ +--- +meta: + title: How to attach a Local Storage volume to an Instance + description: This guide explains how to attach a Local Storage volume to a Scaleway Instance. Follow simple steps to manage your storage efficiently. +content: + h1: How to attach a Local Storage volume to an Instance + paragraph: This guide explains how to attach a Local Storage volume to a Scaleway Instance. Follow simple steps to manage your storage efficiently. +tags: attach block storage volume +dates: + validation: 2025-03-24 + posted: 2023-11-23 +categories: + - block-storage + - storage +--- + +You can attach a Local Storage volume to your Instance at any time, as long as they are both in the same [Availability Zone](/instances/concepts/#availability-zone). + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- Created a [Block Storage volume](/block-storage/how-to/create-a-volume/) +- At least one [Instance](/instances/how-to/create-an-instance/) with Local Storage capabilities + + +1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. Your Local Storage volumes display. +2. Click **Attach to Instance** next to the volume of your choice. A pop-up displays. +3. Select the Instance to which you want to attach your volume from the drop-down. +4. Click **Attach volume to Instance**. + + + * You can attach up to 15 volumes at a time to a single Instance. + * Local Storage resources are limited and bound to the characteristics of your Instance (vCPU/RAM). Alternatively, you can use [Block Storage](/block-storage/quickstart/) to increase the storage capacity of your Instance. + + diff --git a/pages/local-storage/how-to/create-snapshot.mdx b/pages/local-storage/how-to/create-snapshot.mdx new file mode 100644 index 0000000000..758cba987e --- /dev/null +++ b/pages/local-storage/how-to/create-snapshot.mdx @@ -0,0 +1,59 @@ +--- +meta: + title: How to create a Local Storage snapshot + description: Learn how to create a Local Storage snapshot for a Scaleway Instance with this easy-to-follow guide. +content: + h1: How to create a Local Storage snapshot + paragraph: Learn how to create a Local Storage snapshot for a Scaleway Instance with this easy-to-follow guide. +tags: snapshot instance local-storage +dates: + validation: 2025-03-24 + posted: 2025-03-24 +categories: + - storage +--- + +The snapshot feature allows you to create an image of a specific Local Storage volume of your Instance. A snapshot is a full-volume copy stored in our secure data centers. They are usually used to recover volume data or to create a copy of a volume. + + + * This documentation refers to the creation of snapshots for Local Storage volumes. Refer to [How to create a snapshot of a Block Storage volume](/block-storage/how-to/create-a-snapshot/) to find information on how to create snapshots of Block Storage volumes. + * The snapshot feature creates backups of specific volumes only. If you wish to create a backup image that is a complete backup of your Instance including **all** of its volumes, check out our documentation on [how to create an image](/instances/how-to/create-a-backup/). + + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/) +- An [Instance](/instances/how-to/create-an-instance/) + +## How to create a snapshot + +1. Click **Local Storage** in the **Storage** section of the side menu. The [Local Storage overview](https://console.scaleway.com/instance/servers) displays. +2. Click the **Snapshots** tab. +3. Click the **+ Create snapshot** button. You are directed to the snapshot creation wizard. +4. Complete the following steps in the wizard: + - Choose a **name** for the snapshot, or use the default suggested name. + - Select the **volume** you wish to snapshot. All of your Instances' volumes will be shown on the drop-down list, grouped by Availability Zone. + - Check the **Estimated cost**. +5. Click **Create snapshot** to finish. You are redirected to the **Snapshots** tab, where your new snapshot now appears in the list. + +## How to create a volume from a snapshot + +You can create a [volume](/instances/concepts/#volumes) from a snapshot as follows: + +1. Click **Local Storage** in the **Storage** section of the side menu. The [Local Storage page](https://console.scaleway.com/instance/servers) displays. +2. Click the **Snapshots** tab. +3. Click next to the snapshot you want to create an image from. A drop-down menu displays. +4. Click **Volume from snapshot**. A pop-up displays. +5. Enter a name for the volume (or use the default suggested name) and click **Create volume from Snapshot**. + + The volume is created, and displays in the list of your Local Storage volumes. Check out our documentation on [attaching volumes](/block-storage/how-to/attach-a-volume/) and [mounting volumes](/block-storage/api-cli/managing-a-volume/#mounting-and-using-a-block-storage-volume) to learn how to use the volume with your Instances. + +## How to create an Instance from a snapshot + +Follow the instructions for [creating an Instance](/instances/how-to/create-an-instance/). At the **Choose an image** step of the creation wizard, click the **My snapshots** tab, and select the desired snapshot. + + + +You can see the snapshotted volume in the Instance's volumes at **step 4** of the creation wizard. \ No newline at end of file diff --git a/pages/local-storage/how-to/create-volume-from-snapshot.mdx b/pages/local-storage/how-to/create-volume-from-snapshot.mdx new file mode 100644 index 0000000000..805718ce52 --- /dev/null +++ b/pages/local-storage/how-to/create-volume-from-snapshot.mdx @@ -0,0 +1,31 @@ +--- +meta: + title: How to create a Local Storage volume from a snapshot + description: Discover how to efficiently create a Local Storage volume from a snapshot with our comprehensive step-by-step guide. Optimize your storage workflow effortlessly. +content: + h1: How to create a Local Storage volume from a snapshot + paragraph: Discover how to efficiently create a Local Storage volume from a snapshot with our comprehensive step-by-step guide. Optimize your storage workflow effortlessly. +tags: create snapshot local storage volume +dates: + validation: 2025-03-24 + posted: 2025-03-24 +categories: + - local-storage + - storage +--- + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- Created a [Local Storage volume](/local-storage/how-to/create-a-volume/) +- Created a [snapshot](/local-storage/how-to/create-a-snapshot/) + + +1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. The Local Storage page displays. +2. Click the **Snapshots** tab. +3. Click > **Create volume** next to the snapshot of your choice. A pop-up displays. +4. Enter a name for the new volume, or leave the suggested name. +5. Click **Create volume from snapshot**. + +The new volume appears in your Local Storage volumes list. diff --git a/pages/local-storage/how-to/create-volume.mdx b/pages/local-storage/how-to/create-volume.mdx new file mode 100644 index 0000000000..fc4cac6d29 --- /dev/null +++ b/pages/local-storage/how-to/create-volume.mdx @@ -0,0 +1,37 @@ +--- +meta: + title: How to create a Local Storage volume + description: Learn how to efficiently create a Local Storage volume with our detailed step-by-step guide. Enhance your storage performance seamlessly. +content: + h1: How to create a Local Storage volume + paragraph: Learn how to efficiently create a Local Storage volume with our detailed step-by-step guide. Enhance your storage performance seamlessly. +tags: create Local storage volume add +dates: + validation: 2025-03-24 + posted: 2025-03-24 +categories: + - local-storage + - storage +--- + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization + +1. Click **Local Storage** in the **Storage** section of the [Scaleway console](https://console.scaleway.com) side menu. The Local Storage page displays. +2. Click **+ Create volume**. +3. Follow the steps in the creation wizard: + - Choose an [Availability Zone](/instances/concepts/#availability-zone). + - Configure the volume: + - Enter a name for your volume or leave the automatically generated name. + - Define a volume size. + + The volume size must be at least 1 GB. + + - Select an Instance from the drop-down to attach your volume. This step is optional. + - Check the estimated cost. +4. Click **Create volume**. The volumes overview page displays. + + The volume must be in the same Availability Zone as the Instance you want to connect it to. + diff --git a/pages/local-storage/how-to/delete-snapshot.mdx b/pages/local-storage/how-to/delete-snapshot.mdx new file mode 100644 index 0000000000..dc8e70d4f3 --- /dev/null +++ b/pages/local-storage/how-to/delete-snapshot.mdx @@ -0,0 +1,31 @@ +--- +meta: + title: How to delete a Local Storage volume snapshot + description: This guide explains the steps to safely delete a volume snapshot from your Scaleway account. +content: + h1: How to delete a Local Storage volume snapshot + paragraph: This guide explains the steps to safely delete a Local Storage volume snapshot from your Scaleway account. +tags: delete snapshot local volume storage +dates: + validation: 2025-03-24 + posted: 2025-03-24 +categories: + - local-storage + - storage +--- + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- Created a [Local Storage volume](/local-storage/how-to/create-a-volume/) + + +1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. A list of your volumes displays. +2. Click the **Snapshots** tab. +3. Click > **Delete** next to the snapshot of your choice. A pop-up displays. +4. Type `DELETE` to confirm. +5. Click **Delete this snapshot**. + + This action permanently deletes your snapshot and all the data it contains. If you do not want to lose this data, make a backup before deleting the snapshot. + diff --git a/pages/local-storage/how-to/delete-volume.mdx b/pages/local-storage/how-to/delete-volume.mdx new file mode 100644 index 0000000000..9978c34480 --- /dev/null +++ b/pages/local-storage/how-to/delete-volume.mdx @@ -0,0 +1,33 @@ +--- +meta: + title: How to delete a Local Storage volume + description: This guide explains the steps to safely delete a Local Storage volume from your Scaleway account. +content: + h1: How to delete a Local Storage volume + paragraph: This guide explains the steps to safely delete a Local Storage volume from your Scaleway account. +tags: delete cancel terminate local volume storage +dates: + validation: 2025-03-24 + posted: 2025-03-24 +categories: + - local-storage + - storage +--- + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- Created a [Local Storage volume](/local-storage/how-to/create-a-volume/) + + + - You must detach your volume from the Instance it is attached to before deleting the volume. Refer to our documentation to find out [how to do so](/local-storage/how-to/detach-volume/). + + +1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. A list of your volumes displays. +2. Click the icon next to the volume of your choice, then click **Delete**. A pop-up displays. +3. Read the information regarding the delete action and type `DELETE` to confirm. +4. Click **Delete volume**. + + This action permanently deletes your volume and all the data it contains. If you do not want to lose this data, make a backup before deleting the volume. + diff --git a/pages/local-storage/how-to/detach-volume.mdx b/pages/local-storage/how-to/detach-volume.mdx new file mode 100644 index 0000000000..165745692a --- /dev/null +++ b/pages/local-storage/how-to/detach-volume.mdx @@ -0,0 +1,32 @@ +--- +meta: + title: How to detach a Local Storage volume + description: Learn how to safely detach a Local Storage volume from your Scaleway Instance. +content: + h1: How to detach a Local Storage volume + paragraph: Learn how to safely detach a Local Storage volume from your Scaleway Instance. +tags: detach unlock disconnect Local storage volume +dates: + validation: 2025-03-24 + posted: 2020-01-10 +categories: + - local-storage + - storage +--- + +You can detach a Local Storage volume from your Instance when it is powered off. It is important to [unmount the volume](/Local-storage/api-cli/unmounting-a-volume/) from the operating system before detaching it to avoid data loss. + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- Created a [Local Storage volume](/local-storage/how-to/create-volume/) that is [attached](/local-storage/how-to/attach-volume/) to an Instance + + + + Your Instance must be [powered-off](/instances/how-to/power-off-instance/) before you can detach any Local Storage volume from it. + + +1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. The Local Storage page displays. +2. Click > **Detach** next to the volume of your choice. A pop-up displays. +3. Click **Detach volume** to confirm. diff --git a/pages/local-storage/index.mdx b/pages/local-storage/index.mdx new file mode 100644 index 0000000000..1a4c891333 --- /dev/null +++ b/pages/local-storage/index.mdx @@ -0,0 +1,47 @@ +--- +meta: + title: Local Storage Documentation + description: Dive into Scaleway Local Storage with our quickstart guides, how-tos, tutorials and more. +--- + + + +## Getting Started + + + + + + + + diff --git a/pages/local-storage/quickstart.mdx b/pages/local-storage/quickstart.mdx new file mode 100644 index 0000000000..dda8973fab --- /dev/null +++ b/pages/local-storage/quickstart.mdx @@ -0,0 +1,66 @@ +--- +meta: + title: Local Storage - Quickstart + description: Get started with Scaleway Local Storage. This guide covers creating, attaching, and mounting Block Storage volumes to your Instances for efficient data management. +content: + h1: Local Storage - Quickstart + paragraph: Get started with Scaleway Local Storage. This guide covers creating, attaching, and mounting Block Storage volumes to your Instances for efficient data management. +tags: local storage overview get started +dates: + validation: 2025-03-24 + posted: 2025-03-24 +categories: + - local-storage + - storage +--- + +Scaleway Local Storage is a storage solution integrated directly into some of Scaleway's cloud Instances. The storage capacity varies by Instance type, with a maximum of 600 GB. +Local Storage is tied to the lifespan of the Instance; data stored locally will be lost if the Instance is terminated. +For persistent storage needs, Scaleway offers [Block Storage](/block-storage/), which provides scalable, network-attached storage that remains intact independently of the Instance's state. + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization + +## How to create a Local Storage volume + +1. Click **Local Storage** in the **Storage** section of the [Scaleway console](https://console.scaleway.com) side menu. The Local Storage page displays. +2. Click **+ Create volume**. +3. Follow the steps in the creation wizard: + - Choose an [Availability Zone](/instances/concepts/#availability-zone). + - Configure the volume: + - Enter a name for your volume or leave the automatically generated name. + - Define a volume size. + + The volume size must be at least 1 GB. + + - Select an Instance from the drop-down to attach your volume. This step is optional. + - Check the estimated cost. +4. Click **Create volume**. The volumes overview page displays. + + The volume must be in the same Availability Zone as the Instance you want to connect it to. + + +## How to attach a Local Storage volume + +1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. Your Local Storage volumes display. +2. Click **Attach to Instance** next to the volume of your choice. A pop-up displays. +3. Select the Instance to which you want to attach your volume from the drop-down. +4. Click **Attach volume to Instance**. + + + * You can attach up to 15 volumes at a time to a single Instance. + * Local Storage resources are limited and bound to the characteristics of your Instance (vCPU/RAM). Alternatively, you can use [Block Storage](/block-storage/quickstart/) to increase the storage capacity of your Instance. + + +## How to delete a Local Storage volume + +1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. A list of your volumes displays. +2. Click the **Snapshots** tab. +3. Click > **Delete** next to the snapshot of your choice. A pop-up displays. +4. Type `DELETE` to confirm. +5. Click **Delete this snapshot**. + + This action permanently deletes your snapshot and all the data it contains. If you do not want to lose this data, make a backup before deleting the snapshot. + diff --git a/tutorials/create-openwrt-image-for-scaleway/index.mdx b/tutorials/create-openwrt-image-for-scaleway/index.mdx index 81a870d6a9..99dc9082ba 100644 --- a/tutorials/create-openwrt-image-for-scaleway/index.mdx +++ b/tutorials/create-openwrt-image-for-scaleway/index.mdx @@ -22,7 +22,7 @@ It introduces the basic needs and actions to create a custom image, but each ope The procedure introduced in this tutorial is specific to OpenWrt, an open-source project for embedded operating systems based on Linux. It is primarily used to route network traffic. -To create a custom image, you need to build a [QCOW2 image](https://www.linux-kvm.org/page/Qcow2) and [create a snapshot](/instances/how-to/create-a-snapshot/) from it. +To create a custom image, you need to build a [QCOW2 image](https://www.linux-kvm.org/page/Qcow2) and [create a snapshot](/block-storage/how-to/create-a-snapshot/) from it. The following steps are required to create the image: diff --git a/tutorials/deploy-meilisearch-instance/index.mdx b/tutorials/deploy-meilisearch-instance/index.mdx index ac8143defd..5f5e580912 100644 --- a/tutorials/deploy-meilisearch-instance/index.mdx +++ b/tutorials/deploy-meilisearch-instance/index.mdx @@ -160,7 +160,7 @@ If you have created your Instance within a **Private Network** or if you are usi - **Secure** your deployment: - Encrypt traffic in transit to Meilisearch by [setting up SSL](https://www.meilisearch.com/docs/learn/configuration/instance_options#ssl-options) - Move your Instance inside a [Private Network](/instances/how-to/use-private-networks/) if you do not want it to be exposed publicly on the internet - - Configure regular data backups using [Meilisearch Snapshots](https://www.meilisearch.com/docs/learn/advanced/snapshots/) or [Instances snapshots](/instances/how-to/create-a-snapshot/) + - Configure regular data backups using [Meilisearch Snapshots](https://www.meilisearch.com/docs/learn/advanced/snapshots/) or [Instances snapshots](/block-storage/how-to/create-a-snapshot/) - **Fine-tune deployment configuration** such as [Instance type or disk size](/instances/reference-content/choosing-instance-type/), from the [Scaleway console](https://console.scaleway.com/instance/servers/), [the Scaleway API](https://www.scaleway.com/en/developers/api/instance/), [CLI](/instances/api-cli/cli-cheatsheet/), [Terraform](https://registry.terraform.io/providers/scaleway/scaleway/latest/docs/resources/instance_server/), or [OpenTofu](https://search.opentofu.org/provider/opentofu/scaleway/latest).