Attaching a block storage¶

Voici comment associer votre serveur VPS à votre volume de stockage bloc en utilisant l’interface en ligne de commande (Vultr CLI).

1️⃣ Vérifier que les deux ressources sont dans la même région¶

Le bloc‑storage ne peut être attaché qu’à une instance qui se trouve dans la même zone géographique.

# Liste des serveurs (instances) vultr-cli instance list # Liste des volumes de stockage bloc vultr-cli block-storage list

Repérez :

INSTANCE_ID – l’identifiant de votre VPS.
BLOCK_STORAGE_ID – l’identifiant du volume que vous avez créé.

Assurez-vous que les colonnes region (ou location) affichent la même valeur pour les deux lignes.

2️⃣ Attacher le volume au VPS¶

vultr-cli block-storage attach \ --instance-id <INSTANCE_ID> \ --block-storage-id <BLOCK_STORAGE_ID>

Exemple concret :

vultr-cli block-storage attach \ --instance-id 12345678-90ab-cdef-1234-567890abcdef \ --block-storage-id 98765432-10fe-dcba-4321-098765fedcba

Après l’exécution, la CLI vous renverra un statut attached ou un message de confirmation.

3️⃣ Vérifier l’attachement¶

vultr-cli block-storage list --instance-id <INSTANCE_ID>

Vous devez voir le champ attached_to contenant l’ID de votre instance.

4️⃣ Monter le volume dans le système d’exploitation du VPS¶

a) Connectez‑vous à votre VPS¶

ssh root@<IP_DE_VOTRE_VPS>

b) Identifiez le nouveau disque¶

Sur la plupart des distributions Linux :

lsblk # montre les périphériques block

Le volume apparaît généralement sous /dev/vdb (ou /dev/vdc, …) selon le nombre de disques déjà présents.

c) Créez un système de fichiers (si le volume est vierge)¶

mkfs.ext4 /dev/vdb # choisissez le type de FS souhaité (ext4, xfs, …)

Attention : cette opération efface tout le contenu du disque. Ne lancez pas la commande si le volume contient déjà des données.

d) Créez le point de montage et montez le disque¶

mkdir -p /mnt/block-storage mount /dev/vdb /mnt/block-storage

e) Rendre le montage persistant après redémarrage¶

Ajoutez une ligne dans /etc/fstab :

/dev/vdb /mnt/block-storage ext4 defaults 0 2

(Adaptez le type de système de fichiers si vous avez choisi autre chose.)

5️⃣ Bonnes pratiques & points à surveiller¶

Action	Pourquoi
Vérifier la région	Un volume ne peut pas être attaché à une instance située dans une autre région.
Sauvegarder avant `mkfs`	Si le volume possède déjà des données, le formater les détruirait.
Surveiller l’usage	Vous pouvez consulter la consommation via `df -h` ou `du`.
Dé‑attacher proprement	Avant de supprimer le volume, démontez‑le (`umount /mnt/block-storage`) puis détachez‑le avec `vultr-cli block-storage detach`.

Résumé rapide (commande unique)¶

# 1. Attacher le volume vultr-cli block-storage attach --instance-id <INSTANCE_ID> --block-storage-id <BLOCK_STORAGE_ID> # 2. Sur le VPS (une fois connecté) mkfs.ext4 /dev/vdb # si nécessaire mkdir -p /mnt/block-storage mount /dev/vdb /mnt/block-storage echo "/dev/vdb /mnt/block-storage ext4 defaults 0 2" >> /etc/fstab

Si vous rencontrez une erreur particulière (par ex. « volume already attached », « permission denied », etc.) n’hésitez pas à copier le message exact ici ; je pourrai alors vous aider à diagnostiquer le problème plus en détail.

Block storage detach¶

Voici la procédure complète pour détacher proprement un volume Block Storage de votre VPS lorsqu’il a été attaché avec la Vultr CLI.

1️⃣ Préparer le serveur (dé‑montage)¶

Connectez‑vous à votre VPS

ssh root@<IP_DE_VOTRE_VPS>

Identifier le périphérique

lsblk # repérez le disque (ex. /dev/vdb) mount | grep /mnt/block-storage # vérifie le point de montage actuel
Synchroniser les écritures en cours (optionnel mais recommandé)

sync
Démonter le volume

umount /mnt/block-storage

Si le démontage échoue parce que le disque est occupé, vous pouvez identifier les processus qui l’utilisent :

lsof +D /mnt/block-storage # liste les fichiers ouverts fuser -m /mnt/block-storage # montre les PID

Arrêtez ou déplacez ces processus, puis réessayez umount.
Supprimer l’entrée fstab (si vous en aviez ajouté une)

sed -i '\#/dev/vdb /mnt/block-storage#d' /etc/fstab

(Remplacez /dev/vdb et le point de montage par ceux que vous avez réellement utilisés.)

2️⃣ Détacher le volume avec la Vultr CLI¶

Une fois le disque démonté côté OS, utilisez la CLI pour le détacher de l’instance.

vultr-cli block-storage detach \ --block-storage-id <BLOCK_STORAGE_ID>

<BLOCK_STORAGE_ID> : identifiant du volume que vous avez obtenu avec vultr-cli block-storage list.
La commande renvoie un statut detached ou un message de confirmation.

Astuce : vous pouvez vérifier l’état du volume immédiatement après :

vultr-cli block-storage list --block-storage-id <BLOCK_STORAGE_ID>

Le champ attached_to doit maintenant être vide (null).

3️⃣ Nettoyage optionnel (si vous n’avez plus besoin du volume)¶

Si vous souhaitez supprimer le volume pour libérer l’espace facturé :

vultr-cli block-storage delete \ --block-storage-id <BLOCK_STORAGE_ID>

Confirmez la suppression lorsqu’on vous le demande.

Attention : la suppression est irréversible ; toutes les données stockées seront perdues.

4️⃣ Checklist rapide¶

Étape	Commande	Objectif
Dé‑montage	`umount /mnt/block-storage`	Libérer le disque du système de fichiers
Retirer fstab	`sed -i '\#/dev/vdb /mnt/block-storage#d' /etc/fstab`	Éviter un montage automatique futur
Détachement	`vultr-cli block-storage detach --block-storage-id …`	Découpler le volume de l’instance sur le cloud
(Optionnel) Suppression	`vultr-cli block-storage delete --block-storage-id …`	Supprimer le volume définitivement

Points à retenir¶

Toujours démonter avant de détacher : cela évite la corruption de données et les messages d’erreur du type “device busy”.
Vérifiez la région : le volume doit rester dans la même région que l’instance tant qu’il est attaché, mais le détachement ne dépend pas de la région.
Conservez l’ID du volume : vous en aurez besoin pour le détacher ou le supprimer.
Sauvegardez vos données avant toute suppression définitive.

Si vous rencontrez un problème particulier (par ex. umount: target is busy ou une erreur de la CLI), copiez le message d’erreur exact ici ; je pourrai vous guider plus précisément.