Gérer des invités KVM avec virsh : lister, démarrer, shutdown ou destroy, et autostart

Objectif

Inspecter, démarrer et arrêter des invités KVM gérés par libvirt, et configurer leur démarrage automatique, avec virsh, sans corrompre la définition persistante du domaine.

Prérequis

Être root ou membre du groupe libvirt sur l'hôte hyperviseur, avec le service libvirtd (ou virtqemud activé par socket) en cours d'exécution. Exécuté en root, virsh se connecte à qemu:///system ; exécuté par un utilisateur ordinaire, il utilise par défaut la session privée de cet utilisateur, qemu:///session (sauf si LIBVIRT_DEFAULT_URI ou la configuration du client en décide autrement), qui n'affiche pas les invités du système. Indiquez explicitement -c qemu:///system et vérifiez avec virsh uri.

Étapes

1. Lister les invités : virsh list --all affiche tous les domaines définis et leur état (running, shut off, paused). virsh list seul n'affiche que ceux qui sont en cours d'exécution.
2. Inspecter un invité : virsh dominfo <name> affiche l'état, le nombre de CPU, la mémoire, l'indicateur d'autostart et la persistance. virsh domstate <name> n'affiche que l'état.
3. Démarrer un invité défini mais arrêté : virsh start <name>.
4. Arrêt propre : virsh shutdown <name> demande au système d'exploitation invité de s'arrêter et rend la main immédiatement ; le succès n'est pas garanti et la durée est variable. Avec QEMU, l'hyperviseur choisit la méthode (normalement un événement ACPI de bouton d'alimentation, que le système invité doit savoir traiter) ; --mode agent utilise à la place l'agent invité QEMU, s'il tourne dans l'invité. Interrogez régulièrement virsh domstate <name> jusqu'à ce qu'il indique shut off.
5. Arrêt forcé : virsh destroy <name> met fin au domaine immédiatement, sans laisser au système invité la moindre possibilité de réagir, ce qui équivaut à débrancher le câble d'alimentation ; les écritures de l'invité non encore vidées sur disque peuvent être perdues. Ne l'utilisez que si shutdown n'aboutit pas après une attente raisonnable. La commande ne supprime aucun disque, et un domaine persistant peut être redémarré ; un domaine transitoire disparaît une fois arrêté, avec les métadonnées de ses snapshots.
6. Activer ou désactiver le démarrage au boot d'un domaine persistant : virsh autostart <name> (libvirt démarre l'invité au démarrage de l'hôte) et virsh autostart --disable <name> pour le retirer.
7. Accès à la console : virsh console <name> se connecte à une console série définie dans le XML de l'invité (nécessite un périphérique <console type='pty'> et un getty configuré dans l'invité) ; quittez avec Ctrl+].
8. Les définitions de domaine résident sous forme de XML dans /etc/libvirt/qemu/<name>.xml ; ne modifiez pas ces fichiers à la main, car libvirt ne prend pas en compte de telles modifications. Utilisez virsh edit <name>, qui ouvre la définition persistante (inactive) dans $VISUAL/$EDITOR, la vérifie et redéfinit le domaine à l'enregistrement ; pour un invité en cours d'exécution, la modification ne prend effet qu'à son prochain démarrage. Faites d'abord une sauvegarde avec virsh dumpxml --inactive <name> > <name>.xml ; virsh dumpxml <name> affiche la définition en cours d'exécution.

Résultat attendu

virsh dominfo <name> reflète immédiatement le nouvel état ou le nouveau réglage d'autostart ; virsh list --all affiche shut off après un destroy ou une fois qu'un shutdown est terminé (pas nécessairement au moment où virsh shutdown rend la main).

Limites et base de vérification

Le comportement dépend de la réaction du système invité à la demande d'arrêt ; un invité qui ne traite pas l'événement ACPI de bouton d'alimentation (par exemple une image minimale où rien n'écoute cet événement, ou un invité Windows dont la politique du bouton d'alimentation est réglée sur « ne rien faire ») ne répondra pas et nécessite un arrêt depuis l'invité, --mode agent ou destroy. Ce module ne couvre ni l'installation de libvirt ni la configuration des réseaux ou des pools de stockage, au-delà de ce qui est cité.