You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pages/block-storage/api-cli/managing-a-volume.mdx
+23-23Lines changed: 23 additions & 23 deletions
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ content:
7
7
paragraph: Master Block Storage with our comprehensive guide. Learn to format, mount, transfer data, and expand partitions efficiently. Perfect for all skill levels.
8
8
tags: volume block-storage block mount format use
9
9
dates:
10
-
validation: 2024-12-06
10
+
validation: 2025-06-09
11
11
posted: 2019-11-29
12
12
categories:
13
13
- block-storage
@@ -20,7 +20,6 @@ This documentation only explains how to mount **additional block volumes to your
20
20
21
21
- A Scaleway account logged into the [console](https://console.scaleway.com)
22
22
-[Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
23
-
- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/)
24
23
- An [Instance](/instances/concepts/#instance)
25
24
-[Attached](/block-storage/how-to/attach-a-volume/) an additional Block Storage volume to your Instance
26
25
@@ -29,7 +28,6 @@ This documentation only explains how to mount **additional block volumes to your
29
28
In order to mount and use your Block Storage volume, you need to connect to the Instance it is attached to, via SSH.
30
29
Then, check that the volume is available, format it, and mount it following the instructions below.
31
30
32
-
33
31
### Verifying device availability
34
32
35
33
1. Connect to your Instance with `ssh`.
@@ -41,8 +39,7 @@ Then, check that the volume is available, format it, and mount it following the
41
39
lsblk
42
40
```
43
41
44
-
45
-
You should see an output similar to the following. The root Block volume `sda`, runs your OS. The Block volume named `sdb` is the one we will be mounting to the Instance.
42
+
You should see an output similar to the following. The root Block volume `sda`, contains your OS. The Block volume named `sdb` is the one we will be mounting to the Instance.
46
43
47
44
```sh no-copy
48
45
root@scw-festive-agnesi:~# lsblk
@@ -58,8 +55,6 @@ Then, check that the volume is available, format it, and mount it following the
58
55
The Scaleway ecosystem uses [GB](https://en.wikipedia.org/wiki/Gigabyte) to define storage sizes and not [GiB](https://en.wikipedia.org/wiki/Gibibyte) as the default on linux.
59
56
</Message>
60
57
61
-
---
62
-
63
58
### Formatting the Block volume
64
59
65
60
Formatting your volume prepares it for storing files.
@@ -100,19 +95,19 @@ Formatting your volume prepares it for storing files.
100
95
101
96
Once you have created your file system, you need to define where you want to mount your volume, and create a mount point (directory) for it.
102
97
103
-
1. Create the mount point. Feel free to replace `block-volume` with another name for your mount point.
98
+
1. Create the mount point. You can replace `block-volume` with another name for your mount point.
104
99
```
105
100
mkdir /mnt/block-volume
106
101
```
107
102
2. Mount the volume. We recommend that you use the `defaults` option, as in the command below.
108
103
```
109
-
# Make sure that you replace sdX with the name of your volume
104
+
# Replace sdX with the name of your volume
110
105
mount -o defaults /dev/sdX /mnt/block-volume
111
106
```
112
107
113
108
If you want to see all available options, you can run `man mount` on your Instance.
114
109
115
-
3. Run the following command to check if your file system was properly mounted:
110
+
3. Run the following command to check if your volume was properly mounted:
116
111
```
117
112
lsblk
118
113
```
@@ -147,14 +142,14 @@ echo "UUID=$(blkid --output value /dev/sdX | head -n1) /mnt/block-volume ext4 de
147
142
148
143
### Transferring data from your local machine to the remote Block volume
149
144
150
-
You may wish to transfer files from your local machine to your Instance's remote Block volume. This can be achieved with [rsync](https://en.wikipedia.org/wiki/Rsync), a tool for efficiently transferring and copying files. The rsync utility is pre-installed on most Linux distributions and macOS.
145
+
You can transfer files from your local machine to your Instance's remote Block volume with [rsync](https://en.wikipedia.org/wiki/Rsync), a tool for efficiently transferring and copying files. The rsync utility is pre-installed on most Linux distributions and macOS.
151
146
152
147
1. Check that rsync is installed on your local machine with the following command:
153
148
```
154
149
rsync --version
155
150
```
156
151
157
-
You should see an output similar to the following:
152
+
An output similar to the following displays:
158
153
159
154
```sh no-copy
160
155
rsync version 3.1.3 protocol version 31
@@ -176,14 +171,18 @@ You may wish to transfer files from your local machine to your Instance's remote
176
171
- For Linux CentOS/ Fedora, you can use the YUM package manager: `sudo yum install rsync`.
177
172
- On Mac OSX with the Homebrew package manager, you can use `brew install rsync`.
178
173
</Message>
174
+
179
175
2. On your local machine, open a new terminal and use the following command to create a file called `hello-world.txt`:
180
176
```
181
177
nano hello-world.txt
182
178
```
183
179
184
180
3. Enter the text `Hello World!`.
185
-
4. Press `Ctrl O`, `Enter`, and `Ctrl X` to save and exit the file.
181
+
182
+
4. Press `Ctrl+O`, then `Enter`, then `Ctrl+X` to save and exit the file.
183
+
186
184
5. Enter the following command to transfer the file to your Instance's mounted block volume. Ensure that you use your own Instance's IP address:
185
+
187
186
```
188
187
rsync -a hello-world.txt root@<your_instance_ip>:/mnt/block-volume
189
188
```
@@ -194,16 +193,18 @@ The file is now transferred. You can connect to your Instance again, and use the
194
193
195
194
## Increasing the partition size of the volume with growpart
196
195
196
+
`growpart` allows you to resize partitions. If you have increased the size of the partition's underlying volume, for example, you can increase the size of the partition to make use of the additional space.
197
+
197
198
<Messagetype="important">
198
-
-We recommend that you make a backup of your data using the [snapshot](/block-storage/how-to/create-a-snapshot/) feature, before increasing the partition size of your volume. This helps you avoid any potential data loss.
199
-
- You need to have partitioned your volume to follow the procedure below
200
-
- If the partition you want to resize is mounted, you need to[unmount it](/block-storage/api-cli/unmounting-a-volume/) beforehand
199
+
-Make sure to make a backup of your data using the [snapshot](/block-storage/how-to/create-a-snapshot/) feature beforehand to avoid any potential data loss
200
+
- You must have partitioned your volume to follow the procedure below
201
+
- If the partition you want to resize is mounted, you must[unmount it](/block-storage/api-cli/unmounting-a-volume/) beforehand
201
202
</Message>
202
203
203
-
`growpart` allows you to resize partitions. If you have increased the size of the partition's underlying volume, for example, you might want to increase the size of the partition to make use of the additional space.
204
-
205
204
1. Connect to your Instance using [SSH](/instances/how-to/connect-to-instance/).
205
+
206
206
2. Use the `lsblk` command to identify your volume partition. Ensure that the partition is **not mounted before you resize it**. In the following example, we are resizing `sdb1`:
207
+
207
208
```
208
209
root@scw-festive-agnesi:~# lsblk
209
210
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS
@@ -216,20 +217,19 @@ The file is now transferred. You can connect to your Instance again, and use the
216
217
```
217
218
218
219
3. Use `growpart` to increase the partition size of your Block Storage volume (here `sdb1`):
220
+
219
221
```
220
222
# Replace /dev/sdX 1 with the name of your partition
221
223
growpart /dev/sdX 1
222
224
```
223
225
224
-
<Messagetype="tip">
225
-
Make sure that you add a space between the device identifier (`/dev/sdX`) and the partition number (`1`).
226
-
</Message>
226
+
An output similar to the following displays:
227
227
228
-
You should see an output similar to the following:
4. Use `lsblk` to check that the partition was correctly resized. In the following output, you can see in the `SIZE` field that our partition `sbd1` went from `18.6G` (step 2) to `27.9G`.
231
+
232
+
4. Use `lsblk` to check that the partition was correctly resized. In the following output, you can see that our partition `sbd1` went from `18.6G` (step 2) to `27.9G`.
Copy file name to clipboardExpand all lines: pages/block-storage/api-cli/unmounting-a-volume.mdx
+8-11Lines changed: 8 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -7,38 +7,37 @@ content:
7
7
paragraph: Learn how to safely unmount a Block Storage volume from your Instance, and ensure data integrity.
8
8
tags: volume block-storage block unmount
9
9
dates:
10
-
validation: 2024-12-06
10
+
validation: 2025-06-09
11
11
posted: 2023-11-23
12
12
categories:
13
13
- block-storage
14
14
- storage
15
15
---
16
16
17
-
18
17
## Unmounting a Block Storage volume
19
18
20
-
21
19
Unmounting a volume means detaching it from the operating system so it is no longer accessible. You can do this if you want to stop using it, prevent data corruption, or plan to [detach it](/block-storage/how-to/detach-a-volume/) from your Instance and attach it to another. This page shows you how to unmount a volume from the operating system using the `umount` command.
20
+
22
21
<Macroid="requirements" />
23
22
24
23
- A Scaleway account logged into the [console](https://console.scaleway.com)
25
24
-[Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
26
-
- Created an [SSH key](/organizations-and-projects/how-to/create-ssh-key/)
27
25
- Created an [Instance](/instances/how-to/create-an-instance/) with an additional Block Storage volume
28
26
27
+
1. Open a terminal and use the following command to [connect to your Instance](/instances/how-to/connect-to-instance/). Make sure that you replace `<your_instance_ip>` with your Instance's IP. You can also find the SSH command in your Instance's **Overview** tab in the Scaleway console.
29
28
30
-
1. Open a terminal and use the following command to connect to your Instance. Make sure that you replace `<your_instance_ip>` with your Instance's IP. You can also find the SSH command in your Instance's **Overview** tab in the Scaleway console.
31
29
```
32
30
ssh root@<your_instance_ip>
33
31
```
34
-
2. Use `lsblk` to check where your volume is mounted. You should see an output similar to the following:
32
+
33
+
2. Run the `lsblk` command to check where your volume is mounted. You should see an output similar to the following:
35
34
36
35
```
37
36
root@scw-heuristic-shtern:~# lsblk
38
37
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS
39
38
sdb 8:0 0 18.6G 0 disk /mnt/block-volume
40
39
```
41
-
3.Unmount the volume to remove it from your current setup. Replace `/mnt/block-volume` with your mount point.
40
+
3.Run the command below to unmount the volume to remove it from your current setup. Replace `/mnt/block-volume` with your mount point.
42
41
```
43
42
umount /mnt/block-volume
44
43
```
@@ -48,9 +47,7 @@ Unmounting a volume means detaching it from the operating system so it is no lon
48
47
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
49
48
sdb 8:0 0 18.6G 0 disk
50
49
```
51
-
<Messagetype="important">
52
-
Remember to edit the `/etc/fstab` file and delete the line corresponding to your block volume if you have used [Persistent Mounting](/block-storage/api-cli/managing-a-volume/#using-fstab-for-persistent-mounting).
53
-
</Message>
54
50
55
-
Refer to the [dedicated documentation](/block-storage/api-cli/managing-a-volume/) for more information about managing your Block Storage volumes.
51
+
5. If you have used [Persistent Mounting](/block-storage/api-cli/managing-a-volume/#using-fstab-for-persistent-mounting), edit the `/etc/fstab` file and delete the line corresponding to your block volume.
56
52
53
+
Your Block Storage volume is now unmounted from your Instance. Refer to the [dedicated documentation](/block-storage/api-cli/managing-a-volume/) for more information about managing your Block Storage volumes.
Copy file name to clipboardExpand all lines: pages/block-storage/concepts.mdx
+3-2Lines changed: 3 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,8 @@ content:
7
7
paragraph: Explore essential concepts of Block Storage, including block devices, IOPS, SANs, local volumes, and their roles in enhancing storage performance and reliability.
8
8
tags: block storage volumes concept
9
9
dates:
10
-
validation: 2024-11-13
10
+
validation: 2025-06-09
11
+
posted: 2023-11-23
11
12
categories:
12
13
- block-storage
13
14
- storage
@@ -19,7 +20,7 @@ A block device is a storage volume on a network-connected storage system that is
19
20
20
21
## IOPS
21
22
22
-
IOPS or Input/Ouptut Operations Per Second, is a unit of measurement that indicates how many input or output operations a storage device is performing per second.
23
+
IOPS or Input/Ouptut Operations Per Second, is a unit of measurement that indicates how many read/write operations a storage device is performing per second.
23
24
24
25
Scaleway Block Storage Low Latency offers two IOPS limits:
@@ -90,7 +91,7 @@ A multipart upload consists of three steps:
90
91
91
92
- The client initiates the upload to a specific bucket
92
93
- The different parts are uploaded
93
-
- Object Storage constructs the object from the uploaded parts
94
+
- Object Storage builds the object from the uploaded parts
94
95
95
96
## Object
96
97
@@ -116,7 +117,7 @@ Parts are the chunks of data that compose multipart objects.
116
117
117
118
## Prefix
118
119
119
-
A prefix is a string of characters at the beginning of the [object key name](#object). They are often used to organize your data similarly to directories and to manage object [lifecycle](#lifecycle-configuration). However, prefixes are not directories.
120
+
A prefix is a string of characters at the beginning of the [object key name](#object). They are often used to organize your data similarly to directories, and to manage object [lifecycle](#lifecycle-configuration). However, prefixes are not directories.
120
121
121
122
In the context of Scaleway Object Storage, prefixes are used to display folders in the Scaleway console for practical reasons. The `/` character in a prefix is used as a delimiter to allow you to organize your objects hierarchically.
@@ -138,15 +138,15 @@ The Serverless infrastructure manages incoming request traffic. In scenarios lik
138
138
139
139
## Logging
140
140
141
-
Serverless Containers offers a built-in logging system based on Cockpit to track the activity of your resources: see [monitoring Serverless Containers](/serverless-containers/how-to/monitor-container/).
141
+
Serverless Containers offers a built-in logging system based on Cockpit to track the activity of your resources. Refer to [monitoring Serverless Containers](/serverless-containers/how-to/monitor-container/) for more information.
142
142
143
143
## Max scale
144
144
145
-
This parameter sets the maximum number of container instances. You should adjust it based on your container's traffic spikes, keeping in mind that you may wish to limit the max scale to manage costs effectively.
145
+
This parameter sets the maximum number of container instances. You should adjust it based on your container's traffic spikes, keeping in mind that you may wish to limit the maximum scale to manage costs effectively.
146
146
147
147
## Metrics
148
148
149
-
Performance metrics for your Serverless resources are natively available: see [monitoring Serverless Containers](/serverless-containers/how-to/monitor-container/).
149
+
Performance metrics for your Serverless resources are natively available. Refer to [monitoring Serverless Containers](/serverless-containers/how-to/monitor-container/) for more information.
150
150
151
151
## Min scale
152
152
@@ -188,7 +188,7 @@ Refer to the [dedicated FAQ](/serverless-containers/faq/#how-can-i-configure-acc
188
188
A queue trigger is a mechanism that connects a container to a queue created with [Scaleway Queues](/queues/concepts/#scaleway-queues), and invokes the container automatically whenever a message is added to the queue.
189
189
190
190
For each message that is sent to a queue, the trigger reads the message and invokes the associated container with the message as the input parameter.
191
-
The container can then process the message and perform any required actions, such as updating a database or sending a notification.
191
+
The container can then process the message, and perform any required actions, such as updating a database or sending a notification.
192
192
193
193
## Registry endpoint
194
194
@@ -204,11 +204,10 @@ Use cases:
204
204
205
205
## Rolling update
206
206
207
-
When deploying a new version of a Serverless Container, a rolling update is applied by default. This means that the new version of the service is gradually rolled out to your users without downtime.
208
-
Here is how it works:
207
+
When deploying a new version of a Serverless Container, a rolling update is applied by default. The new version of the service is gradually rolled out to your users without downtime, as follows:
209
208
210
209
* When a new version of your container is deployed, the platform automatically starts routing traffic to it incrementally, while still serving requests from the old version until the new one is fully deployed.
211
-
* Once the new version is successfully running, we gradually shift all traffic to it, ensuring zero downtime.
210
+
* Once the new version is successfully running, the platform gradually shifts all traffic to it, ensuring zero downtime.
212
211
* The old version is decommissioned once the new version is fully serving traffic.
213
212
214
213
This process ensures a seamless update experience, minimizing user disruption during deployments. If needed, you can also manage traffic splitting between versions during the update process, allowing you to test new versions with a subset of traffic before fully migrating to it.
@@ -223,7 +222,7 @@ Refer to the [dedicated documentation](/serverless-containers/reference-content/
223
222
224
223
## Scale to zero
225
224
226
-
One of the advantages of Serverless Containers is that when your container is not triggered, it does not consume any resources, which enables great savings.
225
+
When provisioned with a [minimum scale](#min-scale) of `0`, Serverless Containers scale down to zero active instances as long as they are not triggered. While idling, they do not consume any resources, which allows to reduce the cost of your infrastructure.
0 commit comments