Skip to content

feat(block storage): improve the storage block creation guide #8006

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 3 commits into
base: develop
Choose a base branch
from
Draft
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
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ This can be useful in cases where:

### The different types of volumes

OVHcloud offers three types of Block Storage volumes, each tailored to specific needs in terms of performance, capacity and cost. These solutions enable you to attach persistent storage volumes to your instances, guaranteeing a high level of reliability and availability.
OVHcloud offers three types of Block Storage volumes, each tailored to specific needs in terms of performance, capacity, and cost. These solutions allow you to attach persistent storage volumes to your instances, ensuring a high level of reliability and availability. If the feature is available, encryption can be enabled when creating a volume, for all volume types except Classic Multi-Attach volumes in 3AZ regions.

/// details | **Classic – 500 IOPS guaranteed**

Expand Down Expand Up @@ -81,6 +81,11 @@ Generation 2 High-Speed volumes are optimized for the most demanding workloads.

![volume_types](images/volume-types.png){.thumbnail}

> [!primary]
>
> All volume types are also available in an encrypted version (LUKS). These volumes ensure data confidentiality without impacting performance. They are available through the OVHcloud Manager as well as via the tools presented in the next section, by specifying the type <volume_type>-luks.
>

### Attaching a new volume

> [!tabs]
Expand All @@ -92,7 +97,7 @@ Generation 2 High-Speed volumes are optimized for the most demanding workloads.
>>
>> ![select project](images/avolume01.png){.thumbnail}
>>
>> Follow the configuration steps in order to select options for location, disk type and disk capacity. Then enter a name for the volume and confirm by clicking on `Create the volume`{.action}.
>> Follow the configuration steps to select the location, disk type, encryption and disk capacity options. Enter a name for the volume and confirm by clicking on `Create volume`{.action}.
>>
>> > [!warning]
>> >
Expand Down Expand Up @@ -120,6 +125,21 @@ Generation 2 High-Speed volumes are optimized for the most demanding workloads.
>> >
>>
> **Via Terraform**
>> > [!warning]
>> >
>> > Please note that the "high-speed-gen2" or "luks" volume types may not be available in all regions.
>> >
>>
>> Types of volumes:
>>
>> - Classic
>> - High-speed
>> - High-speed-gen2
>> - Classic-luks
>> - High-speed-luks
>> - High-speed-gen2-luks
>>
>> The types ending in -luks are encrypted (LUKS).
>>
>> To create a simple block storage volume, you need 3 elements:
>>
Expand All @@ -132,9 +152,10 @@ Generation 2 High-Speed volumes are optimized for the most demanding workloads.
>> ```python
>> # Creation of a block storage volume
>> resource "openstack_blockstorage_volume_v3" "terraform_blockstorage" {
>> name = "terraform_blockstorage" # Name of the block storage volume
>> size = 10 # Volume size
>> region = "GRA11" # Region where the volume must be created
>> name = "terraform_blockstorage" # Name of the block storage volume
>> size = 10 # Volume size
>> region = "GRA11" # Region where the volume must be created
>> volume_type = "volume_type" # classic, high-speed, high-speed-gen2 or equivalent `-luks`
>> }
>> ```
>>
Expand Down Expand Up @@ -178,7 +199,7 @@ Generation 2 High-Speed volumes are optimized for the most demanding workloads.
>> + name = "terraform_blockstorage"
>> + region = "GRA11"
>> + size = 10
>> + volume_type = (known after apply)
>> + volume_type = "high-speed-gen2"
>> }
>>
>> # openstack_compute_volume_attach_v2.volume_attach will be created
Expand Down Expand Up @@ -207,6 +228,74 @@ Generation 2 High-Speed volumes are optimized for the most demanding workloads.
>>
>> Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
>> ```
>>
> **Via the Horizon interface**
>> Go to the `Volumes` drop-down section, click `Volumes`{.action} and then `Create Volume`{.action}.
>>
>> ![create volume block storage](images/horizon_create_volume.png){.thumbnail}
>>
>> Fill in the `Volume Name`{.action} field and select the type of volume you want. Then click on `Create Volume`{.action}
>>
>> > [!warning]
>> >
>> > Please note that if the volume type “high-speed-gen2” or “luks” does not appear in the list, this means that it is not available in this region.
>> >
>>
>> ![create volume block storage 02](images/horizon_create_volume_02.png){.thumbnail width="1000 "not via }
>>
>> To attach this volume to an instance, on your volume line, click on `the arrow`{.action} at the end of the line next to `Edit Volume`. Then click on `Manage Attachments`{.action}
>>
>> ![Attach a block storage volume to an instance](images/horizon_manage_attachments.png){.thumbnail}
>>
>> Select the instance to which you wish to attach your volume, then click on `Attach Volume.`{.action}
>>
>> ![Attach a block storage volume to an instance 02](images/horizon_manage_attachments_display.png){.thumbnail}
>>
> **Via the Openstack CLI**
>> > [!warning]
>> >
>> > Please note that if the volume type “high-speed-gen2” or “luks” does not appear in the list, this means that it is not available in this region.
>> >
>>
>> Types of volumes:
>>
>> - Classic
>> - High-speed
>> - High-speed-gen2
>> - Classic-luks
>> - High-speed-luks
>> - High-speed-gen2-luks
>>
>> The types ending in -luks are encrypted (LUKS).
>>
>> List the volume types available in the region:
>>
>> ```bash
>> openstack volume type list
>> ```
>>
>> Create a volume, specifying at least its size (in GB) and a type from those listed above. You can also specify a name for your volume at the end of the command.
>>
>> ```bash
>> openstack volume create --size 1 --type high-speed-gen2 volumeName # classic, high-speed, high-speed-gen2 or equivalent `-luks`
>> ```
>>
>> To attach a volume to an instance available in the region, use the following command:
>>
>> ```bash
>> openstack server add volume <server-id|server-name> <volume-id|volume-name>
>>
>> +-----------+-------------------------------------+
>> | Field | Value |
>> +-----------+-------------------------------------+
>> | ID | 7d3d670f- ****-****-****-60dd1e6**** |
>> | Server ID | 74317f97-****-****-80cf2d4**** |
>> | Volume ID | 7d3d670f-****-****-****-60dd1e6**** |
>> | Device | /dev/sdb |
>> | Tag | None |
>> +-----------+-------------------------------------+
>> ````
>>

### Configuring the new disk

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Cela peut être utile dans les cas suivants :

### Les différents types de volumes

OVHcloud propose trois types de volumes Block Storage, chacun adapté à des besoins spécifiques en matière de performance, de capacité et de coûts. Ces solutions vous permettent d’attacher des volumes de stockage persistants à vos instances, en garantissant un haut niveau de fiabilité et de disponibilité.
OVHcloud propose trois types de volumes Block Storage, chacun adapté à des besoins spécifiques en matière de performance, de capacité et de coûts. Ces solutions vous permettent d’attacher des volumes de stockage persistants à vos instances, en garantissant un haut niveau de fiabilité et de disponibilité. Si la fonctionnalité est disponible, le chiffrement peut être activé à la création d'un volume, pour tous les types de volumes à l'exception des volumes Classic Multi-Attach dans les régions 3AZ.

/// details | **Classic – 500 IOPS garantis**

Expand Down Expand Up @@ -82,6 +82,11 @@ La génération 2 des volumes High-Speed est optimisée pour les workloads les p

![volumes_types](images/volume-types.png){.thumbnail}

> [!primary]
>
> Tous les types de volumes sont également disponibles en version chiffrée (**LUKS**). Ces volumes assurent la confidentialité des données sans impact sur les performances. Disponibles depuis le Manager OVHcloud ainsi qu’avec les outils présentés dans la section suivante, en spécifiant le type <volume_type>-luks.
>

### Attacher un nouveau volume

> [!tabs]
Expand All @@ -92,7 +97,7 @@ La génération 2 des volumes High-Speed est optimisée pour les workloads les p
>>
>> ![sélectionner le projet](images/avolume01.png){.thumbnail}
>>
>> Suivez les étapes de configuration afin de sélectionner les options d'emplacement, de type de disque et de capacité de disque. Renseignez un nom pour le volume et validez en cliquant sur `Créer le volume`{.action}.
>> Suivez les étapes de configuration afin de sélectionner les options d'emplacement, de type de disque, de chiffrement et de capacité de disque. Renseignez un nom pour le volume et validez en cliquant sur `Créer le volume`{.action}.
>>
>> > [!warning]
>> >
Expand Down Expand Up @@ -120,6 +125,22 @@ La génération 2 des volumes High-Speed est optimisée pour les workloads les p
>> >
>>
> **Via Terraform**
>> > [!warning]
>> >
>> > Veuillez noter que les types de volume « high-speed-gen2 » ou « luks » peuvent ne pas être disponibles dans toutes les régions.
>> >
>>
>> Types de volumes :
>>
>> - Classic
>> - High-speed
>> - High-speed-gen2
>> - Classic-luks
>> - High-speed-luks
>> - High-speed-gen2-luks
>>
>> Les types se terminant par -luks sont chiffrés (LUKS).
>>
>> Pour créer un volume block storage simple, vous avez besoin de 3 éléments :
>>
>> * Le nom du volume
Expand All @@ -134,6 +155,7 @@ La génération 2 des volumes High-Speed est optimisée pour les workloads les p
>> name = "terraform_blockstorage" # Nom du volume block storage
>> size = 10 # Taille du volume
>> region = "GRA11" # Région ou le volume doit être crée
>> volume_type = "volume_type" # classic, high-speed, high-speed-gen2 ou équivalent `-luks`
>> }
>> ```
>>
Expand Down Expand Up @@ -177,7 +199,7 @@ La génération 2 des volumes High-Speed est optimisée pour les workloads les p
>> + name = "terraform_blockstorage"
>> + region = "GRA11"
>> + size = 10
>> + volume_type = (known after apply)
>> + volume_type = "high-speed-gen2"
>> }
>>
>> # openstack_compute_volume_attach_v2.volume_attach will be created
Expand Down Expand Up @@ -206,6 +228,74 @@ La génération 2 des volumes High-Speed est optimisée pour les workloads les p
>>
>> Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
>> ```
>>
> **Via l'interface Horizon**
>> Se rendre dans la section déroulante `Volumes`, cliquez sur `Volumes`{.action} puis sur `Create Volume`{.action}.
>>
>> ![create volume block storage](images/horizon_create_volume.png){.thumbnail}
>>
>> Renseignez le champs `Volume Name`{.action} et sélectionnez le type de volume que vous souhaitez. Cliquez ensuite sur `Create Volume`{.action}
>>
>> > [!warning]
>> >
>> > Veuillez noter que si le type de volume « high-speed-gen2 » ou « luks » n'apparaît pas dans la liste, cela signifie qu'il n'est pas disponible dans cette région.
>> >
>>
>> ![create volume block storage 02](images/horizon_create_volume_02.png){.thumbnail width="1000"pas via }
>>
>> Pour attacher ce volume à une instance, sur la ligne de votre volume, cliquez sur `la flèche`{.action} se trouvant en bout de ligne à côté de `Edit Volume`. Puis cliquez sur `Manage Attachments`{.action}
>>
>> ![Attach a block storage volume to an instance](images/horizon_manage_attachments.png){.thumbnail}
>>
>> Selectionnez l'instance à laquelle vous souhaitez attacher votre colume, puis cliquez sur `Attach Volume.`{.action}
>>
>> ![Attach a block storage volume to an instance 02](images/horizon_manage_attachments_display.png){.thumbnail}
>>
> **Via la CLI Openstack**
>> > [!warning]
>> >
>> > Veuillez noter que si le type de volume « high-speed-gen2 » ou « luks » n'apparaît pas dans la liste, cela signifie qu'il n'est pas disponible dans cette région.
>> >
>>
>> Types de volumes :
>>
>> - Classic
>> - High-speed
>> - High-speed-gen2
>> - Classic-luks
>> - High-speed-luks
>> - High-speed-gen2-luks
>>
>> Les types se terminant par -luks sont chiffrés (LUKS).
>>
>> Lister les types de volumes disponibles dans la région :
>>
>> ```bash
>> openstack volume type list
>> ```
>>
>> Créez un volume en spécifiant au minimum sa taille (en GB) ainsi qu’un type parmi ceux listés précédemment. Vous pouvez également indiquer un nom pour votre volume à la fin de la commande.
>>
>> ```bash
>> openstack volume create --size 1 --type high-speed-gen2 volumeName # classic, high-speed, high-speed-gen2 ou équivalent `-luks`
>> ```
>>
>> Pour attacher un volume à une instance disponible dans la région, utilisez la commande suivante :
>>
>> ```bash
>> openstack server add volume <server-id|server-name> <volume-id|volume-name>
>>
>> +-----------+-------------------------------------+
>> | Field | Value |
>> +-----------+-------------------------------------+
>> | ID | 7d3d670f-****-****-****-60dd1e6**** |
>> | Server ID | 74317f97-****-****-****-80cf2d4**** |
>> | Volume ID | 7d3d670f-****-****-****-60dd1e6**** |
>> | Device | /dev/sdb |
>> | Tag | None |
>> +-----------+-------------------------------------+
>> ```
>>

### Configuration du nouveau disque

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.