Skip to content

Commit b82243a

Browse files
bene2k1bene2k1
committed
feat(ins): add local storage
1 parent 2e9c2d5 commit b82243a

File tree

10 files changed

+215
-154
lines changed

10 files changed

+215
-154
lines changed

‎menu/navigation.json‎

Lines changed: 1 addition & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1490,22 +1490,11 @@
14901490
"label": "Use placement groups",
14911491
"slug": "use-placement-groups"
14921492
},
1493-
{
1494-
"label": "Create an image",
1495-
"slug": "create-a-backup"
1496-
},
1497-
{
1498-
"label": "Create a snapshot",
1499-
"slug": "create-a-snapshot"
1500-
},
1493+
15011494
{
15021495
"label": "Create an image from a snapshot",
15031496
"slug": "create-image-from-snapshot"
15041497
},
1505-
{
1506-
"label": "Use the snapshot import/export feature",
1507-
"slug": "snapshot-import-export-feature"
1508-
},
15091498
{
15101499
"label": "Migrate volumes and snapshots to Scaleway SBS",
15111500
"slug": "migrate-volumes-snapshots-to-sbs"

‎pages/instances/concepts.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -180,6 +180,6 @@ Tags allow you to organize, sort, filter, and monitor your cloud resources using
180180

181181
Volumes are the storage space of your Instances. Two types of volumes exist:
182182

183-
* **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).
183+
* **[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).
184184

185-
* **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.
185+
* **[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.

‎pages/instances/how-to/manage-storage.mdx‎

Lines changed: 73 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -18,87 +18,84 @@ categories:
1818
- A Scaleway account logged into the [console](https://console.scaleway.com)
1919
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
2020

21-
You can manage the storage resources attached to your Instances directly from the Scaleway console.
21+
## Storage resources overview
22+
You can manage the storage resources attached to your Instances directly from the Scaleway console. These include:
2223

23-
Storage resources consist of:
24+
- **[Volumes](#managing-volumes)**: Storage spaces used by your Instances. Multiple volumes can be attached to an Instance.
25+
- **[Snapshots](#managing-snapshots)**: Backups capturing the state of a volume at a specific time, including OS, configuration, and stored files.
26+
- **[Images](#managing-images)**: Full backups of Instances, useful for restoring data or deploying multiple Instances with a predefined configuration.
2427

25-
**Volumes**: Volumes are storage spaces used by your Instances. You can attach several volumes to an Instance.
26-
**Snapshots**: Snapshots contain the data of a specific volume at a particular point in time, giving you total freedom of what you want to back up. Data may include the operating system, configuration information, and files stored in the volume.
27-
**Images**: Images are backups of your Instances. You can use an image to restore your data or create a series of Instances with a predefined configuration.
28-
29-
## Managing volumes
30-
31-
Volumes are the primary storage solution for your Instances. Scaleway Instances support either **Local Storage** or **Block Storage** volumes depending on the Instance type.
28+
## Managing Volumes
29+
Volumes are the primary storage solution for your Instances. Scaleway Instances support either **Local Storage** or **Block Storage**, depending on the Instance type.
3230

3331
<Message type="tip">
34-
Are you missing a volume in the list? Refer to the [Block Storage](https://console.scaleway.com/block-storage/volumes) or [Local Storage](https://console.scaleway.com/local-storage/volumes) sections of the Scaleway console to see a full list of resources allocated to your Project.
32+
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.
3533
</Message>
3634

37-
1. Click **Instances** from the left side menu. The Instances section displays.
38-
2. Click the name of the Instance you want to manage. The Instance overview page displays.
39-
3. Click the **Storage** tab to display a list of all storage resources attached to the Instance.
40-
5. Scroll to the **Volumes** section to see a list of all volumes attached to the Instance.
41-
5. Click <Icon name="more" /> to view a list of options for the volume. Depending on the volume you can:
42-
* Display more information about the volume
43-
* [Increase the volume size](/block-storage/how-to/increase-block-volume/)
44-
* [Detach the volume from the Instance](/block-storage/how-to/detach-a-volume/)
45-
* [Create a snapshot of the volume](/instances/how-to/create-a-snapshot/)
46-
* [Delete the volume](/block-storage/how-to/delete-a-volume/)
47-
48-
### Adding a volume to the Instance
49-
50-
1. Click **Instances** from the left side menu. The Instances section displays.
51-
2. Click the name of the Instance you want to manage. The Instance overview page displays.
52-
3. Click the **Storage** tab to display a list of all storage resources attached to the Instance.
53-
4. Click **+ Create volume** in the **Volumes** section of the page. A pop-up displays.
54-
5. Enter a volume name and choose the volume size in GB.
55-
6. Choose a storage typ. Depending on the Instance type you can choose from:
56-
**Block Storage**: A block device is a storage volume on a network-connected storage system that is exposed to the guest operating system as if it were a physical disk. Scaleway provides Block Volumes with either 5.000 or 15.000 IOPS guaranteed.
57-
**Local Storage**: A fixed amount of storage located on local disks of the pyhsical hypervisor. The amount of local storage is tied to the compute resources allocated.
58-
6. Click **Add volume** to create and attach the volume to the Instance.
59-
60-
## Managing snapshots
61-
62-
Snapshots contain the data of a specific volume at a particular point in time, giving you total freedom of what you want to back up. Data may include the operating system, configuration information, and files stored in the volume.
63-
64-
1. Click **Instances** from the left side menu. The Instances section displays.
65-
2. Click the name of the Instance you want to manage. The Instance overview page displays.
66-
3. Click the **Storage** tab to display a list of all storage resources attached to the Instance.
67-
4. Scroll to the **Snapshots** section to see a list of all snapshots attached to the Instance.
68-
5. Click <Icon name="more" /> to view a list of options for the snapshot. You can either:
69-
* Display more information about the snapshot
70-
* [Create an image from the snapshot](/instances/how-to/create-image-from-snapshot/)
71-
* [Create a volume from the snapshot](/block-storage/how-to/create-volume-from-snapshot/)
72-
* [Copy the snapshot to an Object Storage bucket](/block-storage/how-to/create-volume-from-snapshot/)
73-
* [Delete the snapshot](/block-storage/how-to/delete-a-snapshot/)
74-
75-
### Creating a snapshot from the Instance
76-
77-
1. Click **Instances** from the left side menu. The Instances section displays.
78-
2. Click the name of the Instance you want to manage. The Instance overview page displays.
79-
3. Click the **Storage** tab to display a list of all storage resources attached to the Instance.
80-
4. Click **+ Create snapshot** in the **Snapshots** section of the page. A pop-up displays.
81-
5. Select the volume to snapshot from the drop-down list.
82-
6. Enter a name for the snapshot
83-
7. Click **Create snapshot** to snapshot the volume and attach the snapshot to the Instance.
35+
### Viewing and managing volumes
36+
1. Click **Instances** in the left menu.
37+
2. Select the Instance you want to manage.
38+
3. Go to the **Storage** tab.
39+
4. Scroll to the **Volumes** section to view attached volumes.
40+
5. Click <Icon name="more" /> next to a volume for options:
41+
- View volume details
42+
- [Increase volume size](/block-storage/how-to/increase-block-volume/)
43+
- [Detach volume](/block-storage/how-to/detach-a-volume/)
44+
- [Create a snapshot](/instances/how-to/create-a-snapshot/)
45+
- [Delete volume](/block-storage/how-to/delete-a-volume/)
46+
47+
### Adding a volume
48+
1. Navigate to **Instances** in the left menu.
49+
2. Select the Instance you want to configure.
50+
3. Open the **Storage** tab.
51+
4. Click **+ Create volume** in the **Volumes** section.
52+
5. Enter a volume name and choose its size (GB).
53+
6. Select a storage type:
54+
- **Block Storage**: A network-based block device with 5,000 or 15,000 IOPS.
55+
- **Local Storage**: Storage located on the physical hypervisor, tied to compute resources.
56+
7. Click **Add volume** to attach it to the Instance.
57+
58+
## Managing Snapshots
59+
Snapshots preserve the state of a volume at a specific time, allowing for data recovery.
60+
61+
### Viewing and managing snapshots
62+
1. Click **Instances** in the left menu.
63+
2. Select the Instance you want to configure.
64+
3. Go to the **Storage** tab.
65+
4. Scroll to the **Snapshots** section.
66+
5. Click <Icon name="more" /> for snapshot options:
67+
- View details
68+
- [Create an image from snapshot](/instances/how-to/create-image-from-snapshot/)
69+
- [Create a volume from snapshot](/block-storage/how-to/create-volume-from-snapshot/)
70+
- [Copy to an Object Storage bucket](/block-storage/how-to/create-volume-from-snapshot/)
71+
- [Delete snapshot](/block-storage/how-to/delete-a-snapshot/)
72+
73+
### Creating a snapshot
74+
1. Click **Instances** in the left menu.
75+
2. Select the Instance you want to configure.
76+
3. Open the **Storage** tab.
77+
4. Click **+ Create snapshot** in the **Snapshots** section.
78+
5. Choose a volume from the dropdown.
79+
6. Enter a snapshot name.
80+
7. Click **Create snapshot** to proceed.
8481

8582
## Managing Images
86-
87-
Images are backups of your Instances. You can use an image to restore your data or create a series of Instances with a predefined configuration.
88-
89-
1. Click **Instances** from the left side menu. The Instances section displays.
90-
2. Click the name of the Instance you want to manage. The Instance overview page displays.
91-
3. Click the **Storage** tab to display a list of all storage resources attached to the Instance.
92-
5. Scroll to the **Images** section of the page to see a list of all images attached to the Instance.
93-
5. Click <Icon name="more" /> to view a list of options for the image. You can:
94-
* Display more information about the image
95-
* Create an Instance from the image
96-
* Delete the image.
97-
98-
### Creating an image from the Instance
99-
100-
1. Click **Instances** from the left side menu. The Instances section displays.
101-
2. Click the name of the Instance you want to manage. The Instance overview page displays.
102-
3. Click the **Storage** tab to display a list of all storage resources attached to the Instance.
103-
4. Click **+ Create image** in the **Images** section of the page. A pop-up displays.
104-
5. Enter a name for the image to create.
83+
Images are full backups of Instances, useful for restoring data or deploying multiple Instances.
84+
85+
### Viewing and managing images
86+
1. Click **Instances** in the left menu.
87+
2. Select the Instance you want to configure.
88+
3. Open the **Storage** tab.
89+
4. Scroll to the **Images** section.
90+
5. Click <Icon name="more" /> for options:
91+
- View details
92+
- Create an Instance from the image
93+
- Delete the image
94+
95+
### Creating an image
96+
1. Click **Instances** in the left menu.
97+
2. Select the Instance you want to configure.
98+
3. Open the **Storage** tab.
99+
4. Click **+ Create image** in the **Images** section.
100+
5. Enter a name for the image.
101+
6. Click **Create image** to proceed.

‎pages/instances/how-to/snapshot-import-export-feature.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ content:
77
paragraph: This page explains how to import/export snapshots of Instances using the Scaleway console.
88
tags: snapshot, import, export, instance, availability zone, qcow2
99
dates:
10-
validation: 2025-02-17
10+
validation: 2025-03-25
1111
posted: 2021-07-27
1212
categories:
1313
- compute

‎pages/local-storage/concepts.mdx‎

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,29 @@ categories:
1212
- storage
1313
---
1414

15-
## Local storage
15+
## Block volumes
1616

17-
The local storage 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.
17+
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.
18+
19+
## Boot-on-Block
20+
21+
Some Instance types do not use local volumes and instead boot directly on block volumes.
22+
23+
## Local volumes
24+
25+
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.
26+
27+
## Power-off mode
28+
29+
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.
30+
31+
## Standby mode
32+
33+
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.
34+
35+
## Volumes
36+
37+
Volumes are the storage space of your Instances. Two types of volumes exist:
38+
39+
- **[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).
40+
- **[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.

‎pages/local-storage/how-to/attach-volume.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ categories:
1414
- storage
1515
---
1616

17-
You can attach a Block Storage volume to your Instance at any time, as long as they are both in the same [Availability Zone](/instances/concepts/#availability-zone).
17+
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).
1818

1919
<Macro id="requirements" />
2020

‎pages/local-storage/how-to/delete-volume.mdx‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
meta:
3+
title: How to delete a Local Storage volume
4+
description: This guide explains the steps to safely delete a Local Storage volume from your Scaleway account.
5+
content:
6+
h1: How to delete a Local Storage volume
7+
paragraph: This guide explains the steps to safely delete a Local Storage volume from your Scaleway account.
8+
tags: delete cancel terminate local volume storage
9+
dates:
10+
validation: 2025-03-24
11+
posted: 2025-03-24
12+
categories:
13+
- local-storage
14+
- storage
15+
---
16+
17+
<Macro id="requirements" />
18+
19+
- A Scaleway account logged into the [console](https://console.scaleway.com)
20+
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
21+
- Created a [Local Storage volume](/Local-storage/how-to/create-a-volume/)
22+
23+
<Message type="important">
24+
- 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/).
25+
</Message>
26+
27+
1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. A list of your volumes displays.
28+
2. Click the <Icon name="more" /> icon next to the volume of your choice, then click **Delete**. A pop-up displays.
29+
3. Read the inforformation regarding the delete action and type `DELETE` to confirm.
30+
4. Click **Delete volume**.
31+
<Message type="important">
32+
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.
33+
</Message>
34+

‎pages/local-storage/how-to/detach-volume.mdx‎

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,34 @@
11
---
22
meta:
3-
title: How to delete a Local Storage volume
4-
description: This guide explains the steps to safely delete a Local Storage volume from your Scaleway account.
3+
title: How to detach a Local Storage volume
4+
description: Learn how to safely detach a Local Storage volume from your Scaleway Instance.
55
content:
6-
h1: How to delete a Local Storage volume
7-
paragraph: This guide explains the steps to safely delete a Local Storage volume from your Scaleway account.
8-
tags: delete cancel terminate local volume storage
6+
h1: How to detach a Local Storage volume
7+
paragraph: Learn how to safely detach a Local Storage volume from your Scaleway Instance.
8+
tags: detach unlock disconnect Local storage volume
99
dates:
10-
validation: 2025-03-24
11-
posted: 2025-03-24
10+
validation: 2024-12-19
11+
posted: 2020-01-10
1212
categories:
1313
- local-storage
1414
- storage
1515
---
1616

17+
You can detach a Local Storage volume from your Instance at any time. 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.
18+
1719
<Macro id="requirements" />
1820

1921
- A Scaleway account logged into the [console](https://console.scaleway.com)
2022
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
21-
- Created a [Local Storage volume](/Local-storage/how-to/create-a-volume/)
23+
- Created a [Local Storage volume](/Local-storage/how-to/create-volume/) that is [attached](/Local-storage/how-to/attach-volume/) to an Instance
24+
2225

2326
<Message type="important">
24-
- 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/).
27+
Your Instance must be [powered-off](/instances/how-to/power-off-instance/) before you can detach any Local Storage volume from it.
2528
</Message>
2629

27-
1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. A list of your volumes displays.
28-
2. Click the <Icon name="more" /> icon next to the volume of your choice, then click **Delete**. A pop-up displays.
29-
3. Read the inforformation regarding the delete action and type `DELETE` to confirm.
30-
4. Click **Delete volume**.
31-
<Message type="important">
32-
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.
33-
</Message>
30+
1. Click **Local Storage** in the **Storage** section of the Scaleway console side menu. The Local Storage page displays.
31+
2. Click <Icon name="more" /> > **Detach** next to the volume of your choice. A pop-up displays.
32+
3. Click **Detach volume e** to confirm.
33+
3434

0 commit comments

Comments
 (0)