Créer et utiliser votre premier disque
Ce guide vous accompagne dans la création d'un disque de données depuis la console Hikube, son attachement à une machine virtuelle, puis son formatage et son montage dans le système.
Objectifs
À la fin de ce guide, vous aurez :
- Un disque de données de 20 Go dans votre projet
- Ce disque attaché à une VM existante
- Un système de fichiers monté et utilisable dans la VM
Prérequis
- Un compte Hikube et un projet (voir le démarrage rapide Hikube)
- Une VM Linux dans ce projet, accessible en SSH (voir le démarrage rapide des machines virtuelles)
- Un quota de stockage disponible d'au moins 20 Go
- Pour l'onglet API : une clé d'API
admindu projet et les variablesHIKUBE_API,HIKUBE_API_KEYetPROJECT_ID(voir Préparer l'environnement) ; les exemples utilisentcurletjq
Étape 1 : Ouvrir l'assistant de création
- Console
- API
- Connectez-vous à la console Hikube et sélectionnez votre projet.
- Dans le menu latéral, ouvrez Infrastructure → Disques. La page Disques de Stockage s'affiche.
- Cliquez sur Créer un disque.
Avec l'API, il n'y a pas d'assistant. Vérifiez d'abord que la clé donne accès au projet en listant ses disques :
curl -sS "$HIKUBE_API/disk/v1alpha1/projects/$PROJECT_ID/disks" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY"
Résultat attendu : un objet JSON {"totalCount": ..., "disks": [...]}. Une réponse 403 (code 10002) indique une clé invalide, expirée ou rattachée à un autre projet.
Étape 2 : Configurer et créer le disque
- Console
- API
L'assistant Créer un disque comporte quatre étapes.
- Général : saisissez le Nom du disque (un nom est proposé par défaut). Règles : minuscules, chiffres et tirets ; commence par une lettre et se termine par une lettre ou un chiffre ; 16 caractères maximum. Exemple :
data01. - Source : choisissez Disque Vide.
- Configuration (Taille et Sécurité) :
- Taille (Go) :
20(minimum 20 Go). La jauge Usage projet estimé montre l'impact sur le quota du projet ; - Type de réplication : laissez Réplication Asynchrone (Recommandé) ;
- Chiffrement du disque : laissez désactivé pour ce guide.
- Taille (Go) :
- Vérification : contrôlez le nom, la taille, le chiffrement, la réplication et la source, ainsi que le Coût estimé affiché en haut de l'assistant, puis cliquez sur Créer le disque.
La console affiche « Disque créé » et revient à la liste des disques.
Créez un disque vide de 20 Go avec POST /disk/v1alpha1/projects/{projectId}/disks :
curl -sS -X POST "$HIKUBE_API/disk/v1alpha1/projects/$PROJECT_ID/disks" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "data01",
"size": 20,
"encrypted": false,
"asyncReplication": true
}'
name: 16 caractères maximum, en minuscules ; ce nom identifie le disque dans les chemins de l'API ;size: taille en Go, de 20 à 4096 ;asyncReplication:truecorrespond à Réplication Asynchrone ; sans ce champ, la réplication est synchrone ;encrypted: chiffrement du disque, non modifiable après la création.
Pour créer le disque à partir d'une image, ajoutez "data": {"image": {"name": "<image>"}} ; GET /instance/v1alpha1/cloud-images renvoie la liste des images.
La réponse décrit le disque créé, avec son id et son status.
Étape 3 : Vérifier l'état du disque
- Console
- API
Dans la liste Disques de Stockage, le disque apparaît avec le statut En création, puis Prêt.
Cliquez sur le disque (ou menu d'actions → Aperçu) pour ouvrir sa page de détail :
- Configuration : Capacité, Chiffrement, Réplication ;
- Source : image d'origine (N/A pour un disque vide) et Attaché à (Non rattaché pour l'instant).
curl -sS "$HIKUBE_API/disk/v1alpha1/projects/$PROJECT_ID/disks/data01" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq '{name, size, status, attachedTo}'
Résultat attendu : status passe de provisioning à ready, et attachedTo est vide. Les autres valeurs possibles sont downloading (image en cours de copie, avec downloadProgress de 0 à 100), in_use (disque attaché à une VM) et error.
Étape 4 : Attacher le disque à la VM
- Console
- API
- Ouvrez Infrastructure → Instances VM, puis la page de votre VM, et cliquez sur Modifier.
- Dans la section Stockage, cliquez sur Ajouter un disque.
- Sur le nouveau volume, sélectionnez Existant, puis choisissez
data01dans Sélectionner un volume existant. - Cliquez sur Enregistrer.
Le disque n'apparaît dans la VM qu'après son prochain redémarrage. Après l'enregistrement, la console affiche Redémarrage requis : cliquez sur Redémarrer dans la section Actions de la page de la VM. Planifiez l'opération en conséquence.
Une fois l'opération terminée, le disque passe au statut En cours d'utilisation et sa page affiche le nom de la VM dans Attaché à.
Un disque s'attache en modifiant la VM : PATCH /instance/v1alpha1/projects/{projectId}/instances/{name}, une mise à jour partielle où les champs omis sont conservés. La liste disks, elle, remplace la liste actuelle (le disque système reste en première position). Partez donc des disques actuels et ajoutez le disque à la fin :
VM=myvm # nom de votre VM
curl -sS "$HIKUBE_API/instance/v1alpha1/projects/$PROJECT_ID/instances/$VM" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
| jq '{disks: ((.disks | map({name})) + [{name: "data01"}])}' > vm-update.json
curl -sS -X PATCH "$HIKUBE_API/instance/v1alpha1/projects/$PROJECT_ID/instances/$VM" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d @vm-update.json
Un disque existant n'a pas besoin de size : sa taille est conservée.
Comme dans la console, la modification du stockage redémarre la VM.
Une fois l'opération terminée, GET .../disks/data01 renvoie "status": "in_use" et "attachedTo": "myvm".
Étape 5 : Formater et monter le disque dans la VM
Connectez-vous à la VM en SSH, puis identifiez le nouveau disque :
lsblk
Le nouveau disque apparaît sans partition ni point de montage, avec une taille de 20 Go (par exemple vdb). Adaptez le nom de périphérique dans les commandes suivantes.
# Créer un système de fichiers (efface le contenu du disque)
sudo mkfs.ext4 /dev/vdb
# Monter le disque
sudo mkdir -p /mnt/data
sudo mount /dev/vdb /mnt/data
# Monter automatiquement au démarrage
UUID=$(sudo blkid -s UUID -o value /dev/vdb)
echo "UUID=$UUID /mnt/data ext4 defaults,nofail 0 2" | sudo tee -a /etc/fstab
# Tester
echo "hello hikube" | sudo tee /mnt/data/test.txt
df -h /mnt/data
Résultat attendu : df -h affiche un système de fichiers d'environ 20 Go monté sur /mnt/data.
Étape 6 : Dépannage rapide
| Symptôme | Cause probable | Action |
|---|---|---|
| Suivant inactif à l'étape Configuration | Taille inférieure à 20 Go ou quota dépassé | Ajustez la taille ; « La taille dépasse le quota disponible » indique le maximum possible |
| Le disque n'apparaît pas dans Sélectionner un volume existant | Disque déjà attaché à une VM, ou disque système proposé pour un volume de données | Vérifiez Attaché à sur la page du disque ; un disque vide se place sur un volume de données, pas sur le disque système |
Le disque n'apparaît pas dans lsblk | La VM n'a pas encore redémarré | Attendez la fin du redémarrage puis relancez lsblk |
| Statut Erreur | Échec du provisionnement | Contactez le support avec le nom et l'identifiant du disque |
Voir aussi le dépannage complet.
Étape 7 : Nettoyage
- Console
- API
- Dans la VM, démontez le disque et retirez sa ligne de
/etc/fstab:sudo umount /mnt/datasudo sed -i '\|/mnt/data|d' /etc/fstab - Détachez le disque : page de la VM → Modifier → section Stockage, cliquez sur Détacher le disque sur le volume, confirmez avec Détacher, puis cliquez sur Enregistrer. Le disque revient au statut Prêt ; dans la VM, le détachement ne prend effet qu'au prochain redémarrage : cliquez sur Redémarrer, puis attendez quelques minutes avant l'étape suivante. Un disque détaché reste utilisé par la VM jusqu'à son prochain redémarrage, et une suppression trop rapide peut laisser l'espace occupé dans votre quota. Tant que la VM n'a pas redémarré, la console refuse la suppression : « Ce disque a été détaché, mais sa VM l'utilise encore jusqu'à son prochain redémarrage. Redémarrez la VM, puis réessayez. »
- Supprimez le disque : page du disque → Supprimer (ou menu d'actions → Supprimer dans la liste), saisissez son nom exact dans Nom de la ressource à confirmer, puis cliquez sur Supprimer définitivement.
- Dans la VM, démontez le disque et retirez sa ligne de
/etc/fstab:sudo umount /mnt/datasudo sed -i '\|/mnt/data|d' /etc/fstab - Détachez le disque en renvoyant la liste des disques de la VM sans lui :
Le disque revient au statutcurl -sS "$HIKUBE_API/instance/v1alpha1/projects/$PROJECT_ID/instances/$VM" \-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \| jq '{disks: (.disks | map(select(.name != "data01")) | map({name}))}' > vm-update.jsoncurl -sS -X PATCH "$HIKUBE_API/instance/v1alpha1/projects/$PROJECT_ID/instances/$VM" \-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \-H "Content-Type: application/json" \-d @vm-update.json
ready. - Supprimez le disque :
Une réponsecurl -sS -X DELETE "$HIKUBE_API/disk/v1alpha1/projects/$PROJECT_ID/disks/data01" \-H "X-Hikube-Api-Key: $HIKUBE_API_KEY"
200avec un objet vide{}confirme la suppression.
La suppression d'un disque est irréversible : toutes ses données sont perdues. Un disque attaché à une VM ne peut pas être supprimé ; détachez-le d'abord, puis redémarrez la VM.