Virsh

De wiki.nexiat.fr
Aller à la navigation Aller à la recherche
Fiche express
Type Interface en ligne de commande pour libvirt
Rôle Gestion des machines virtuelles (KVM/QEMU, Xen, LXC...)
Démon associé libvirtd
Documentation libvirt.org/manpages/virsh
Voir aussi KVM · Xen · Xm

virsh (virtualization shell) est l'outil en ligne de commande de libvirt, l'API/démon de gestion de virtualisation le plus répandu sur Linux. Il permet de piloter des machines virtuelles quel que soit l'hyperviseur sous-jacent supporté par libvirt (KVM/QEMU, Xen, LXC, VirtualBox...), ce qui en fait l'outil de référence pour l'administration de KVM en ligne de commande, en alternative à virt-manager.

Lister les VM

virsh list --all
virsh dominfo <nom-vm>
virsh domiflist <nom-vm>

Cycle de vie

virsh start <nom-vm>
virsh shutdown <nom-vm>
virsh reboot <nom-vm>
virsh destroy <nom-vm>          # coupure brutale (équivalent débranchage)
virsh undefine <nom-vm>         # supprime la définition (ne touche pas au disque)
  • Démarrage automatique au boot de l'hôte :
virsh autostart <nom-vm>
virsh autostart --disable <nom-vm>

Console et accès distant

virsh console <nom-vm>          # console série (si configurée dans la VM)
virsh vncdisplay <nom-vm>       # affiche le port VNC alloué

Configuration XML

virsh dumpxml <nom-vm>          # affiche la définition XML complète
virsh edit <nom-vm>             # édite la définition XML (à chaud si le hot-plug le permet)

Réseau virtuel

virsh net-list --all
virsh net-start default
virsh net-destroy default
virsh net-autostart default
virsh net-dhcp-leases default   # baux DHCP distribués par le réseau virtuel

Snapshots

virsh snapshot-create-as <nom-vm> <nom-snapshot>
virsh snapshot-list <nom-vm>
virsh snapshot-revert <nom-vm> <nom-snapshot>
virsh snapshot-delete <nom-vm> <nom-snapshot>

Stockage

virsh pool-list --all
virsh vol-list <pool>
virsh attach-disk <nom-vm> /chemin/disque.qcow2 vdb --config
virsh detach-disk <nom-vm> vdb --config

Voir aussi

  • KVM — guide d'installation et d'usage complet
  • Xen · Xm — hyperviseur Xen et son ancien outil en ligne de commande
  • Proxmox — solution packagée s'appuyant également sur libvirt/QEMU