Concepts Pour: utilisateurs, développeurs

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.

États d'alimentation d'une machine virtuelle Une machine virtuelle est hors tension, sous tension ou suspendue. Mettre sous tension la fait passer de hors tension ou de suspendue à sous tension, mettre hors tension la ramène à hors tension, et suspendre la fait passer de sous tension à suspendue. Chaque action s'exécute comme une tâche. Hors tension Sous tension Suspendue Mettre sous tension Mettre hors tension Suspendre Mettre sous tension Une action est une tâche

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 reconfigure ou POST /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érationAutorisée lorsque la machine virtuelle est
Mettre sous tensionhors tension, suspendue ou en pause
Mettre hors tension (brutalement)sous tension, suspendue ou en pause
Arrêter l'invitésous tension
Réinitialisersous tension
Suspendresous tension
Supprimer, désinscrire, convertir en modèle, changer le datastore d'un disquehors 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émentLimite
vCPU1 à 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émoire0,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 disque1 à 65 536 Gio dans l'assistant ; les disques grandissent et ne rétrécissent jamais
Disques et cartes réseau ensemble23
Lecteurs CD/DVD6
Nom1 à 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.

Version 0.1. Dernière modification : 2026-11-13