Disques

Un disque d'une machine virtuelle est un fichier image sur un datastore. Créer, agrandir et détacher un disque modifie la configuration de la machine, voir Modifier le matériel pour les règles qui s'appliquent pendant son exécution. Vous avez besoin d'espace libre sur le datastore pour un disque nouveau ou agrandi.

Dans la console

1. Dans l'inventaire, sélectionnez la machine virtuelle puis Modifier les paramètres. Pour une machine en cours d'exécution, l'action se trouve sous Autres actions. Les disques sont listés sous les processeurs et la mémoire, avec le fichier de chacun.

   (Agrandir)

   Fermer la vue agrandie

2. Pour ajouter un disque, sélectionnez Ajouter un disque dur, saisissez la taille dans Taille du nouveau disque dur N (GiB) et choisissez le datastore dans Datastore du nouveau disque dur N. La console crée le disque en allocation dynamique : il consomme de l'espace à mesure que l'invité écrit.

   (Agrandir)

   Fermer la vue agrandie
3. Pour agrandir un disque, saisissez une valeur plus grande dans Taille du disque dur N (GiB). La taille est en Gio, ne peut pas être inférieure à la taille actuelle, et le disque doit tenir sur son datastore. Une machine en cours d'exécution peut agrandir un disque.
4. Pour détacher un disque, sélectionnez Retirer le disque dur N. La machine doit être hors tension. Le fichier reste sur le datastore, sauf si vous sélectionnez aussi Supprimer les fichiers de disque du datastore, ce qui le supprime.
5. Pour attacher un fichier de disque déjà présent sur un datastore, sélectionnez Attacher un disque existant. Choisissez le datastore ; la liste Fichier du disque existant N propose les images de disque que rien n'utilise, avec leur capacité, et le choix Autre chemin permet de saisir un autre chemin sous le datastore. Vérifiez la Capacité du disque existant N en Gio, reprise de la liste quand le fichier y figure, et choisissez le mode du disque. La console envoie le disque sans créer de fichier. Vous avez besoin du privilège VirtualMachine.Config.AddExistingDisk sur la machine et Datastore.FileManagement sur le datastore ; un fichier qui est le disque d'une autre machine exige aussi VirtualMachine.Provisioning.DiskRandomAccess sur cette machine, et est sinon refusé avec error.disk_owned_by_other_vm.
6. Sélectionnez Enregistrer.

Trouver les images de disque que rien n'utilise

Les images de disque qu'aucune machine virtuelle, aucun modèle, aucun instantané ni aucune bibliothèque de contenu ne nomme occupent de la place. Pour les lister, ouvrez le datastore dans l'inventaire, puis sélectionnez Autres actions et Rechercher les images de disque inutilisées. La boîte de dialogue affiche chaque fichier avec son format, sa taille, sa capacité, son image de base et sa dernière modification, ainsi que les totaux. Les fichiers modifiés depuis quelques minutes sont exclus parce qu'une tâche peut être en train de les créer ; choisissez une autre durée sous Ignorer les fichiers modifiés depuis moins de pour les voir. Le rapport ne modifie rien. Supprimer supprime un fichier après que vous avez saisi son nom ; vérifiez d'abord, car les images téléversées pour créer des disques y figurent aussi. Vous avez besoin du privilège Datastore.Browse pour lire le rapport et Datastore.FileManagement pour supprimer un fichier.

:::screen datastore-orphans

Résultat

La machine affiche ses disques sous Matériel virtuel, avec leurs tailles et leurs datastores. L'invité doit étendre sa partition et son système de fichiers dans un disque plus grand, sauf dans les images cloud qui le font au démarrage.

Automatisation

Avec la CLI

Lisez la configuration, modifiez la liste disks et appliquez-la, comme décrit dans Modifier le matériel :

kyvernon inventory vm <id> --json
kyvernon vm reconfigure <id> --config config.json --wait \
  --create-disk '{"datastore":"datastore-1","path":"web-01/data.qcow2","sizeBytes":10737418240}'

Une entrée de disque de config.json contient key, datastore, path, capacity_bytes et, facultativement, thin, independent et nonpersistent. Utilisez une key libre.

• Créer un disque : ajoutez son entrée et passez --create-disk avec le fichier à créer. Ajoutez sourcePath (et sourceDatastore) pour le démarrer depuis une image, et "linked": true pour un clone lié de l'image sur le même datastore.
• Agrandir un disque : définissez la nouvelle capacity_bytes et passez --grow-disk avec le même chemin de fichier et la nouvelle sizeBytes. Sur une machine en cours d'exécution, le disque s'agrandit immédiatement lorsque l'environnement d'exécution le permet, sinon au démarrage suivant.
• Attacher un fichier existant : ajoutez une entrée dont le path est ce fichier et ne passez pas --create-disk. Vous avez besoin du privilège Datastore.FileManagement sur son datastore. Un fichier qui est le disque d'une autre machine exige VirtualMachine.Provisioning.DiskRandomAccess sur cette machine.
• Détacher un disque : supprimez son entrée. Passez le disque avec --delete-disk pour supprimer aussi le fichier.

Avec l'API

POST /v1/vms/{id}/reconfigure transporte les mêmes données : la config complète avec les disks modifiés, et les listes createDisks, growDisks et deleteDisks. Chaque entrée de liste contient datastore, path et sizeBytes ; les entrées de createDisks prennent aussi sourceDatastore, sourcePath et linked. Les tailles sont en octets. La tâche vérifie l'espace, refuse une réduction avec error.disk.shrink_not_supported et refuse un disque qui appartient à une autre machine avec error.disk_owned_by_other_vm.

Trouver les images de disque inutilisées

Les images de disque qu'aucune machine virtuelle, aucun modèle et aucun instantané n'utilise occupent de l'espace. Le rapport des disques orphelins les liste et ne modifie rien :

kyvernon datastore orphans <datastore> --min-age-seconds 3600

Le rapport liste les images qui ne sont le disque d'aucune machine, d'aucun modèle ni d'aucun instantané, ni une surcouche ou l'image de base d'un disque référencé, ni un fichier d'une bibliothèque de contenu. Il liste aussi les fichiers de suivi des modifications dont l'image a disparu. Les fichiers modifiés durant les --min-age-seconds dernières secondes sont exclus ; la valeur par défaut est 300. Chaque entrée indique son chemin, son format, sa taille et sa capacité. Les images que vous avez téléversées pour en créer des disques sont également listées. Vérifiez chaque fichier avant de le supprimer, voir Fichiers d'un datastore. GET /v1/datastores/{id}/orphan-disks renvoie le même rapport, avec truncated défini lorsque le datastore contient plus de fichiers qu'une analyse n'en renvoie.

Voir aussi

• Modifier le matériel
• Concepts du stockage
• Dépannage du stockage