Concepts des machines virtuelles
Configuration et état observé, états d'alimentation, tâches, placement sur un hôte, inventaire autour d'une machine virtuelle et limites des périphériques.
Une machine virtuelle est un enregistrement de l'inventaire qui décrit un ordinateur, plus l'instance de celui-ci qui s'exécute sur un hôte. Cette page explique les éléments sur lesquels chaque tâche de cette section s'appuie.
Configuration et état observé
L'enregistrement d'une machine virtuelle a deux moitiés.
- La configuration est ce que vous demandez : le nombre de vCPU, la mémoire, le microprogramme, les disques, les cartes réseau et les lecteurs CD/DVD. Vous la modifiez avec Modifier les paramètres,
kyvernon vm reconfigureouPOST /v1/vms/{id}/reconfigure. - L'état observé est ce que l'hôte signale : l'état d'alimentation, l'hôte sur lequel elle s'exécute, l'heure de la dernière mise sous tension, la mémoire utilisée et, lorsque l'agent invité fonctionne, le nom d'hôte et les adresses de l'invité.
Kyvernon enregistre l'état d'alimentation que vous voulez et l'agent d'hôte y amène la machine virtuelle. Lorsque l'hôte n'y parvient pas, il signale la raison et la tâche qui l'a demandé échoue avec elle.
Deux personnes peuvent modifier la même machine virtuelle en même temps. Chaque modification nomme la version de la configuration dont elle est partie, et Kyvernon fusionne les modifications parties de versions qu'il connaît encore. Lorsqu'une modification ne peut pas être fusionnée, la requête échoue avec error.vm.concurrent_modification ; relisez la machine virtuelle et refaites la modification.
États d'alimentation
Une machine virtuelle est sous tension, hors tension ou suspendue. Une machine sous tension peut aussi être en pause : ses vCPU sont arrêtés et sa mémoire reste en place. L'API signale les états sous les noms powered_on, powered_off, suspended et paused.
| Opération | Autorisée lorsque la machine virtuelle est |
|---|---|
| Mettre sous tension | hors tension, suspendue ou en pause |
| Mettre hors tension (brutalement) | sous tension, suspendue ou en pause |
| Arrêter l'invité | sous tension |
| Réinitialiser | sous tension |
| Suspendre | sous tension |
| Supprimer, désinscrire, convertir en modèle, changer le datastore d'un disque | hors tension |
La mise hors tension arrête la machine virtuelle aussitôt et ne demande rien à l'invité. L'arrêt demande d'abord à l'invité, par l'agent invité puis par le bouton d'alimentation de la machine virtuelle, et met hors tension brutalement lorsque l'invité ne s'est pas arrêté après le délai, 90 secondes par défaut. Sur une machine virtuelle déjà hors tension, les deux réussissent et ne changent rien.
Tâches
Chaque opération qui modifie une machine virtuelle s'exécute comme une tâche. L'API répond avec le statut 202 et l'identifiant de la tâche. La console web suit la tâche pour vous et l'affiche dans le volet du bas. Le client en ligne de commande affiche l'identifiant, et --wait attend la fin de la tâche. Une tâche prend l'état terminée, échouée ou annulée et conserve le nom de l'utilisateur qui l'a lancée.
Placement sur un hôte
Une machine virtuelle s'exécute sur un hôte à la fois. Dans l'assistant de nouvelle machine virtuelle, vous choisissez un cluster, pour laisser Kyvernon choisir un hôte connecté, ou un hôte, pour la placer vous-même. Une machine virtuelle qui n'a pas encore d'hôte est placée lors de sa mise sous tension. Un hôte en mode maintenance ne reçoit aucune nouvelle machine virtuelle. Une machine virtuelle hors tension garde l'hôte sur lequel elle s'est exécutée en dernier jusqu'à sa prochaine mise sous tension ou son déplacement.
Kyvernon vérifie la mémoire avant la mise sous tension. La mémoire de l'hôte, moins une réserve de 2 048 Mio par défaut, moins la mémoire des machines virtuelles qui s'y exécutent déjà, doit couvrir la nouvelle. Les paramètres du contrôleur host_memory_reserve_mib et memory_overcommit_ratio modifient ces vérifications.
Place d'une machine virtuelle dans l'inventaire
Une machine virtuelle se trouve dans un dossier du datacenter et appartient à un groupe de ressources du cluster ou de l'hôte sur lequel elle s'exécute. Vous choisissez le dossier dans l'assistant, et la ressource de calcul dans la même étape. Les objets ont des identifiants tels que vm-42, host-3, datastore-1, group-v5 pour un dossier de machines virtuelles et resgroup-7 pour un groupe de ressources. La CLI et l'API prennent ces identifiants.
Pour déplacer des machines virtuelles vers un autre dossier, exécutez kyvernon inventory move-into <folder> --entity <vm> ; cela demande le privilège Folder.Move sur la destination. Pour les déplacer vers un autre groupe de ressources, exécutez kyvernon inventory move-into-pool <pool> --entity <vm> ; cela demande Resource.AssignVMToPool sur la destination. L'arborescence elle-même se lit avec kyvernon inventory roots, children et path, et un client de longue durée suit les changements avec kyvernon inventory changes.
Les développeurs qui utilisent gRPC retrouvent les mêmes objets dans InventoryService, et les opérations de machine virtuelle créer, supprimer, mettre sous tension, mettre hors tension, arrêter, réinitialiser, suspendre et reconfigurer dans VmService.
Limites des périphériques
| Élément | Limite |
|---|---|
| vCPU | 1 à 256 dans l'assistant, et pas plus que les processeurs logiques de l'hôte (ou max_vcpus_per_vm lorsque ce paramètre du contrôleur est supérieur à 0) |
| Mémoire | 0,25 à 4 096 Gio dans l'assistant, et pas plus que la mémoire de l'hôte moins sa réserve |
| Taille d'un disque | 1 à 65 536 Gio dans l'assistant ; les disques grandissent et ne rétrécissent jamais |
| Disques et cartes réseau ensemble | 23 |
| Lecteurs CD/DVD | 6 |
| Nom | 1 à 80 caractères, sans /, \ ni % |
Une machine virtuelle en fonctionnement n'accepte que la croissance : plus de vCPU, plus de mémoire, des disques plus grands. Des valeurs plus petites, un autre microprogramme et un autre nombre de cœurs par socket demandent que la machine virtuelle soit hors tension. Ajouter ou retirer des périphériques pendant son fonctionnement demande un hôte qui prend en charge l'ajout à chaud ; sans lui, la modification est refusée tant que la machine virtuelle n'est pas hors tension.
Tâches liées
Version 0.1. Dernière modification : 2026-11-13