Différences

Ci-dessous, les différences entre deux révisions de la page.

--- article:gestion_a_distance_d_un_vm_qemu [2026/10/06 16:24] – bernard.rolland
+++ article:gestion_a_distance_d_un_vm_qemu [2026/10/06 16:50] (Version actuelle) – bernard.rolland
@@ Ligne 3: / Ligne 3: @@
 Ce guide regroupe les commandes essentielles pour administrer nos machines virtuelles en ligne de commande (CLI) via SSH, en remplacement de **virt-manager**.
-===== 1. Informations et Statut =====
+===== 1. Installation de l'environnement (Serveur Headless) =====
+Si le serveur Debian hôte est installé sans environnement de bureau (sans KDE/Gnome), voici les paquets requis pour faire fonctionner le moteur de virtualisation et les outils CLI :
+<code>
+sudo apt update
+sudo apt install qemu-system-x86 libvirt-daemon-system libvirt-clients virtinst
+</code>
+* **libvirt-clients** : Fournit la commande ''virsh''.
+* **virtinst** : Fournit la commande ''virt-install'' (création) et ''virt-clone'' (clonage).
+===== 2. Informations et Statut =====
 ==== Lister les machines virtuelles ====
@@ Ligne 23: / Ligne 32: @@
 </code>
-===== 2. Gestion de l'alimentation =====
+===== 3. Gestion de l'alimentation =====
 ==== Démarrer une VM ====
@@ Ligne 49: / Ligne 58: @@
 //Pour désactiver : ajouter l'option ''--disable'' à la fin de la commande.//
-===== 3. Gestion de la Configuration (XML) =====
+===== 4. Gestion de la Configuration (XML) =====
 ==== Afficher la configuration XML complète ====
@@ Ligne 68: / Ligne 77: @@
 </code>
-===== 4. Ressources Matérielles (Évolution) =====
+===== 5. Ressources Matérielles (Évolution) =====
 ^ Type ^ Commande ^ Note ^
@@ Ligne 85: / Ligne 94: @@
 . Rallumer la VM et étendre la partition à l'intérieur du système invité.
-===== 5. Réseau et Stockage =====
+===== 6. Réseau et Stockage =====
 ==== Lister les disques attachés à une VM ====
@@ Ligne 97: / Ligne 106: @@
 </code>
-===== 6. Création d'une VM depuis un ISO (virt-install) =====
+===== 7. Création et Duplication de VM =====
-Pour créer une VM sans interface graphique depuis votre terminal SSH, utilisez l'outil **virt-install**.
-==== Commande type d'installation ====
-Cette commande va instancier la VM, créer son disque dur virtuel au format QCOW2 et l'allumer sur l'ISO d'installation pour démarrer le processus.
+==== Créer une VM depuis un ISO (virt-install) ====
+Cette commande instancie la VM, crée son disque dur au format QCOW2 et boot sur l'ISO.
 <code>
 sudo virt-install \
@@ Ligne 116: / Ligne 122: @@
   --noautoconsole
 </code>
+//Note pour le réseau : Remplacer ''network=default'' par ''network=routeur_nat'' si vous souhaitez la lier à votre routeur virtuel.//
+==== Dupliquer / Cloner une VM (virt-clone) ====
+Permet de créer une copie conforme d'une VM existante (comme un modèle) vers une nouvelle instance, en générant de nouvelles adresses MAC et de nouveaux disques pour éviter les conflits. **La VM source doit être éteinte.**
+<code>
+sudo virt-clone --original ynh_modèle --name nouvelle-instance.fr --auto-copy
+</code>
+===== 8. Instantanés (Snapshots) =====
+Les snapshots nécessitent que les disques des VM soient au format **QCOW2**. Idéal avant une mise à jour critique de YunoHost.
+==== Créer un instantané ====
+<code>
+sudo virsh snapshot-create-as <nom_de_la_vm> nom-du-snapshot "Ma description ici"
+</code>
+//Astuce : Ajoutez l'option ''--live'' si la VM est allumée et que vous voulez aussi figer l'état exact de la RAM.//
+==== Lister les instantanés d'une VM ====
+<code>
+sudo virsh snapshot-list <nom_de_la_vm>
+</code>
+==== Restaurer un instantané (Retour en arrière) ====
+**Il est recommandé d'éteindre la VM avant la restauration.**
+<code>
+sudo virsh snapshot-revert <nom_de_la_vm> nom-du-snapshot
+</code>
+==== Supprimer un instantané ====
+À faire une fois la mise à jour validée pour libérer de l'espace disque et conserver de bonnes performances.
+<code>
+sudo virsh snapshot-delete <nom_de_la_vm> nom-du-snapshot
+</code>
+===== 9. Accès graphique à distance (Tunnel SSH + VNC) =====
+Le port VNC de l'hôte n'étant pas accessible directement depuis l'extérieur pour des raisons de sécurité, il faut faire passer le flux graphique à l'intérieur d'un **tunnel SSH chiffré**.
+==== Étape 1 : Identifier le port VNC utilisé ====
+Sur le serveur distant, vérifiez le numéro d'affichage ou le port de la VM en cours d'exécution :
+<code>
+sudo virsh vncdisplay ma-nouvelle-vm
+</code>
+* Si le résultat est '':0'', le port réel est **5900**.
+* Si le résultat est '':1'', le port réel est **5901**, etc.
+==== Étape 2 : Créer le tunnel depuis votre machine locale ====
+Ouvrez un **nouveau terminal sur votre PC local** (pas sur le serveur distant) et exécutez la commande suivante :
+<code>
+ssh -L 5900:127.0.0.1:5900 utilisateur@adresse_ip_du_serveur
+</code>
+//Note : Si à l'étape 1 la VM affichait ":1", remplacez le port de destination par 5901 (ex: 5900:127.0.0.1:5901).//
-==== Détails importants des options ====
+**Laissez ce terminal ouvert**, c'est lui qui maintient le pont sécurisé.
-^ Option ^ Rôle ^
-| ''--os-variant'' | Optimise les pilotes virtuels (virtio) pour l'OS choisi. Utilisez ''osinfo-query os'' pour voir la liste des distributions supportées. |
+==== Étape 3 : Se connecter avec un visionneur VNC ====
-| ''--network'' | Configure la carte réseau. \\ **''network=default''** : Utilise le réseau NAT standard de Libvirt. \\ **''network=routeur_nat''** : Si vous voulez la brancher directement derrière votre VM routeur personnalisée. |
+. Ouvrez votre logiciel VNC local (Remmina, TigerVNC, Vinagre, etc.).
-| ''--graphics vnc,listen=0.0.0.0'' | Active un serveur VNC sur l'hôte Debian. Cela vous permettra de vous connecter graphiquement à l'installateur de l'OS depuis votre PC local via un tunnel SSH (ex: sur le port 5900). |
+. Dans le champ d'adresse, connectez-vous sur : **''127.0.0.1:5900''**
-| ''--noautoconsole'' | Empêche la commande de bloquer votre terminal SSH en essayant d'ouvrir une console texte immédiatement. |
+. L'écran graphique de l'installateur ou du bureau Debian de la VM distante s'affiche.