Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion compute/gpu/how-to/create-manage-gpu-instance.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ When you have completed your calculations using the GPU Instance, [deletion can
- **Availability Zone**: Choose the geographical region, represented by the Availability Zone, where your Instance will be deployed.
- **Instance Type (GPU)**: Select the desired GPU Instance type, considering factors such as processing power, memory, storage options, and bandwidth. Refer to our guide on [choosing the right GPU Instance type](/compute/gpu/reference-content/choosing-gpu-instance-type/) for more information.
- **Image**: Pick an operating system image suitable for your GPU Instance. For example, select **Ubuntu Jammy GPU OS 12**, which comes with preinstalled NVIDIA drivers and an NVIDIA Docker environment. You have the flexibility to customize your working environment using Docker with our provided Docker images or your own containers.
- **Volumes**: Optionally, add storage volumes for your Instance. You can adjust settings such as block and local storage volumes according to your requirements.
- **Volumes**: Optionally, add storage volumes for your Instance. You can adjust settings such as Block and Local Storage volumes according to your requirements.
<Message type="note">
* The recommended minimum volume size for GPU OS images is 125 GB.
* If your GPU Instance supports scratch storage, the scratch volume displays but can not be edited. [Learn more about scratch storage.](/compute/gpu/how-to/use-scratch-storage-h100-instances/)
Expand Down
6 changes: 3 additions & 3 deletions compute/gpu/how-to/use-gpu-with-docker.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ We recommend that you map volumes from your GPU Instance to your Docker containe

### How to map local volumes

You can map directories from your GPU Instance's local storage to your Docker container, using the `-v <local_storage>:<container_mountpoint>` flag. See the example command below:
You can map directories from your GPU Instance's Local Storage to your Docker container, using the `-v <local_storage>:<container_mountpoint>` flag. See the example command below:

```
docker run -it --rm -v /root/mydata/:/workspace nvidia/cuda:11.2.1-runtime-ubuntu20.04
Expand Down Expand Up @@ -101,7 +101,7 @@ Below is a list of the most common commands you use when dealing with Docker con
| **docker push** | `docker push <registry_user/docker_image>` | This command is used to push a local image to a remote repository. |
| **docker images** | `docker images` | This command is used to list all available Docker images on the local system. |
| **docker rm** | `docker rm <container_id>` | This command is used to remove a stopped container from the local system. |
| **docker rmi** | `docker rmi <image_id>` | This command is used to delete an image from the local storage. |
| **docker rmi** | `docker rmi <image_id>` | This command is used to delete an image from the Local Storage. |
| docker version| `docker --version` | This command is used to display information about the currently installed version of Docker. |

For more information regarding the `docker run` command, refer to the [official documentation](https://docs.docker.com/engine/reference/run/).
Expand Down Expand Up @@ -129,7 +129,7 @@ docker run --runtime=nvidia -it --rm nvidia/cuda:11.2.1-runtime-ubuntu20.04 nvid
```

<Message type="tip">
You can omit this option if using the “Ubuntu Focal GPU OS11” Operating System image with your GPU Instance (as this option is set by default in the Docker configuration files)
You can omit this option if using the “Ubuntu Focal GPU OS11” Operating System image with your GPU Instance, as this option is set by default in the Docker configuration files.
</Message>

If your Instance has several GPUs, you can specify which GPU(s) to use with the container via the Docker CLI using either the `--gpus` option (starting with Docker 19.03) or using the environment variable `NVIDIA_VISIBLE_DEVICES`.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ categories:
- compute
---

Scaleway H100 and L40S GPU Instances are equipped with additional scratch storage. This form of temporary local storage operates differently from our regular local storage.
Scaleway H100 and L40S GPU Instances are equipped with additional scratch storage. This form of temporary Local Storage operates differently from our regular Local Storage.

Scratch storage temporarily accommodates data during computational or data processing tasks. It is commonly used for storing intermediate results, processing input data, or holding output data before that data is moved to more permanent storage.

Expand Down
2 changes: 1 addition & 1 deletion compute/gpu/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ In addition to this, GPU Instances have all the features of our regular Instance
- **Availability Zone**: Choose the geographical region, represented by the Availability Zone, where your Instance will be deployed.
- **Instance Type (GPU)**: Select the desired GPU Instance type, considering factors such as processing power, memory, storage options, and bandwidth. Refer to our guide on [choosing the right GPU Instance type](/compute/gpu/reference-content/choosing-gpu-instance-type/) for more information.
- **Image**: Pick an operating system image suitable for your GPU Instance. For example, select **Ubuntu Jammy GPU OS 12**, which comes with preinstalled Nvidia drivers and an Nvidia Docker environment. You have the flexibility to customize your working environment using Docker with our provided Docker images or your own containers.
- **Volumes**: Optionally, add storage volumes for your Instance. You can adjust settings such as block and local storage volumes according to your requirements.
- **Volumes**: Optionally, add storage volumes for your Instance. You can adjust settings such as Block and Local Storage volumes according to your requirements.
<Message type="note">
* The recommended minimum volume size for GPU OS images is 125 GB.
* If your GPU Instance supports scratch storage, the scratch volume displays but can not be edited. [Learn more about scratch storage.](/compute/gpu/how-to/use-scratch-storage-h100-instances/)
Expand Down
6 changes: 3 additions & 3 deletions compute/instances/api-cli/migrating-instances.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ To do so, you need the Instance’s ID and a valid API key.
You can retrieve a list of all available Instance types using the command `scw instance server-type list`.
</Message>
<Message type="important">
Ensure that local storage constraints are respected. For example, downgrading from a larger Instance type to a smaller one may not be possible if the smaller Instance type cannot support the existing local storage. Check the Scaleway documentation for specific constraints.
Ensure that Local Storage constraints are respected. For example, downgrading from a larger Instance type to a smaller one may not be possible if the smaller Instance type cannot support the existing Local Storage. Check the Scaleway documentation for specific constraints.
</Message>

3. Power on the Instance.
Expand Down Expand Up @@ -82,7 +82,7 @@ To do so, you need the Instance’s ID and a valid API key.
curl -X PATCH -H "X-Auth-Token: $SCW_SECRET_KEY" -H "Content-Type: application/json" -d '{"commercial_type" : "<NEW_INSTANCE_TYPE>"}' "https://api.scaleway.com/instance/v1/zones/{zone}/servers/{server_id}"
```
<Message type="important">
Local storage constraints must be respected. For example, downgrading a DEV1-L Instance with 80 GB of local SSD storage to a DEV1-S Instance is not possible because the DEV1-S offer only supports a maximum of 20 GB. However, if the DEV1-L Instance is only using block storage (`b_ssd`) without relying on local SSD storage, the downgrade can be performed without any issues.
Local Storage constraints must be respected. For example, downgrading a DEV1-L Instance with 80 GB of local SSD storage to a DEV1-S Instance is not possible because the DEV1-S offer only supports a maximum of 20 GB. However, if the DEV1-L Instance is only using Block Storage (`b_ssd`) without relying on local SSD storage, the downgrade can be performed without any issues.
</Message>

Output:
Expand Down Expand Up @@ -135,4 +135,4 @@ To do so, you need the Instance’s ID and a valid API key.

For more information on using the API, refer to the complete [API documentation](https://www.scaleway.com/en/developers/api/instance/).
</TabsTab>
</Tabs>
</Tabs>
2 changes: 1 addition & 1 deletion compute/instances/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -161,7 +161,7 @@ An image is composed of snapshots of volumes. Snapshots can only be restored to

## Standby mode

Standby mode is a way to stop an Instance temporarily. When you [put an Instance in standby mode](/compute/instances/how-to/use-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.
Standby mode is a way to stop an Instance temporarily. When you [put an Instance in standby mode](/compute/instances/how-to/use-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.

## Stateful security groups

Expand Down
8 changes: 3 additions & 5 deletions compute/instances/how-to/create-a-snapshot.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@ The snapshot feature allows you to create an image of a specific [volume](/compu

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.
* **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.

<Message type="note">
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](/compute/instances/how-to/create-a-backup/).
Expand Down Expand Up @@ -66,6 +66,4 @@ Follow the instructions for [creating an Instance](/compute/instances/how-to/cre

<Lightbox src="scaleway-create-from-snapshot.webp" alt="" />

You can see the snapshotted volume in the Instance's volumes at **step 4** of the creation wizard.


You can see the snapshotted volume in the Instance's volumes at **step 4** of the creation wizard.
4 changes: 1 addition & 3 deletions compute/instances/how-to/create-an-instance.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ Select a tab below for instructions on how to create an Instance via either our
| commercial-type | The commercial Instance type to create (string) | Any valid ID of a Scaleway commercial Instance type, e.g. `"GP1-S"`, `"PRO2-M"`. Use the [List Instance Types](https://www.scaleway.com/en/developers/api/instance/#path-instance-types-list-instance-types) endpoint to get a list of all valid Instance types and their IDs. |
| image | The image to install on the Instance, e.g. a particular OS (string) | Any valid Scaleway image ID, e.g. `"544f0add-626b-4e4f-8a96-79fa4414d99a"` which is the ID for the `Ubuntu 22.04 Jammy Jellyfish` image. Use the [Marketplace API](https://www.scaleway.com/en/developers/api/marketplace/) endpoint to find available images and their IDs. |
| enable_ipv6 | Whether to enable IPv6 on the Instance (boolean) | `true` or `false` |
| volumes | An object that specifies the storage volumes to attach to the Instance. Must respect the volume constraints of the `commercial_type` (i.e. for each type of Instance, a minimum amount of storage is required, and there is also a maximum that cannot be exceeded. Some Instance types support only Block Storage (`b_ssd`), others also support local storage (`l_ssd`) ). These constraints are available at the [List Instance Types](https://www.scaleway.com/en/developers/api/instance/#path-instance-types-list-instance-types) endpoint, via the `volume_constraints` parameter for each type listed in the response | A (dictionary) object with a minimum of one key (`"0"`) whose value is another object containing the parameters `"name"` (a name for the volume), `"size"` (the size for the volume, in bytes), and `"volume_type"` (`"l_ssd"` or `"b_ssd"`). Additional keys for additional volumes should increment by 1 each time (the second volume would have a key of `1`.) Further parameters are available, and it is possible to attach existing volumes rather than creating a new one, or create a volume from a snapshot. For full details see [here](https://www.scaleway.com/en/developers/api/instance/#path-volumes). |
| volumes | An object that specifies the storage volumes to attach to the Instance. Must respect the volume constraints of the `commercial_type` (i.e. for each type of Instance, a minimum amount of storage is required, and there is also a maximum that cannot be exceeded. Some Instance types support only Block Storage (`b_ssd`), others also support Local Storage (`l_ssd`) ). These constraints are available at the [List Instance Types](https://www.scaleway.com/en/developers/api/instance/#path-instance-types-list-instance-types) endpoint, via the `volume_constraints` parameter for each type listed in the response | A (dictionary) object with a minimum of one key (`"0"`) whose value is another object containing the parameters `"name"` (a name for the volume), `"size"` (the size for the volume, in bytes), and `"volume_type"` (`"l_ssd"` or `"b_ssd"`). Additional keys for additional volumes should increment by 1 each time (the second volume would have a key of `1`.) Further parameters are available, and it is possible to attach existing volumes rather than creating a new one, or create a volume from a snapshot. For full details see [here](https://www.scaleway.com/en/developers/api/instance/#path-volumes). |

3. Use the following curl command, replacing the payload with the one you specified in step 2, to create your Instance.

Expand Down Expand Up @@ -224,5 +224,3 @@ Select a tab below for instructions on how to create an Instance via either our
</TabsTab>

</Tabs>


2 changes: 1 addition & 1 deletion compute/instances/how-to/use-standby-mode.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ categories:
- compute
---

[Standby mode](/compute/instances/concepts/#stand-by-mode) temporarily stops an Instance. The Instance remains allocated to your account and all data remains on the local storage of the Instance.
[Standby mode](/compute/instances/concepts/#stand-by-mode) temporarily stops an Instance. The Instance remains allocated to your account and all data remains on the Local Storage of the Instance.

<Macro id="requirements" />

Expand Down
Loading