wikinotes

Outils pour utilisateurs

Outils du site

Piste : • sortie-veille-impossible
sysadmin:linux:virtualisation:kvm:creer_une_vm_avec_virt-install

Différences

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

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
sysadmin:linux:virtualisation:kvm:creer_une_vm_avec_virt-install [2023/03/04 15:38] – supprimée - modification externe (Unknown date) 127.0.0.1sysadmin:linux:virtualisation:kvm:creer_une_vm_avec_virt-install [2026/06/20 14:55] (Version actuelle) – yoann
Ligne 1: Ligne 1:
 +{{tag>software virtualisation kvm qemu linux vm}}
  
 +
 +====== Créer une VM avec virt-install ======
 +
 +La CLI **virt-install** est un assistant de création de machine Virtuelle. Elle peut être lancée en mode interactif ou invoquée via un ensemble d'options décrivant la VM à créer.
 +
 +:TODO: bureau distant avec spice
 +
 +===== Installation de virt-install =====
 +
 +<code bash>
 +sudo apt-get install virtinst libosinfo-bin
 +</code>
 +
 +
 +===== A propos des modes d'exécution =====
 +
 +**virt-install** communique avec le service **libvirtd** et peut être invoquée en spécifiant le mode d'exécution souhaité via l'option ''%%--connect%%'' :
 +  * ''%%--connect qemu://session%%'' : exécution en espace utilisateur avec les droits limités de l'utilisateur ;
 +  * ''%%--connect qemu://system%%'' : exécution avec un utilisateur système ''libvirt-qemu'' et des droits étendus.
 +
 +<note>
 +Pour que l'utilisateur puisse interagir en mode ''system'' avec les différents outils virt-install, virsh etc, il doit faire parti des groupes **libvirt** et **libvirt-qemu**.
 +
 +Et vice-versa, selon les options utilisées lors de la création d'une VM en mode ''system'', l'utilisateur système **libvirt-qemu** devra pouvoir accéder aux fichiers disques et aux ISO utilisés lors de la création de la VM pouvant se trouver dans les dossiers de l'utilisateur.
 +</note>
 +
 +Ci-dessous un exemple de retour d'erreur lors d'une tentative de création de VM dans un dossier utilisateur sur lequel l'hyperviseur n'a pas les droits appropriés :
 +
 +<file>
 +WARNING  il se peut que /home/yoann/KVM/install_files/debian-12.5.0-amd64-netinst.iso ne soit pas accessible à l’hyperviseur. Vous devrez fournir à l’utilisateur « libvirt-qemu » des permissions de recherche pour les répertoires suivants : ['/home/yoann', '/home/yoann/KVM', '/home/yoann/KVM/install_files']
 +
 +Début d’installation…
 +ERROR    Cannot access storage file '/home/yoann/KVM/debian12/vda' (as uid:64055, gid:104): Permission non accordée
 +</file>
 +
 +Plusieurs solutions sont possibles via les droits d'accès classiques ou les ACL mais il faudra permettre à l'utilisateur système **libvirt-qemu** d'accéder aux ressources nécessaires à la création de la VM.
 +
 +Pour ajouter l'utilisateur courant au groupe :
 + 
 +<code bash>
 +sudo adduser $( id -un ) libvirt-qemu
 +</code>
 +
 +Ensuite on peut changer le groupe principal de l'utilisateur courant et créer les dossier :
 +<code bash>
 +newgrp libvirt-qemu
 +
 +mkdir -p ~/KVM/maVM
 +</code>
 +
 +Pour définir un processeur de type pentium sur le système invité :
 +<code bash>
 +
 +</code>
 +
 +
 +===== Exemple de création d'une VM =====
 +
 +Plusieurs modes d'installation sont possibles, ici on a choisit de télécharger un ISO et d'installer la VM à partir de celui-ci. virt-install peut créer le fichier disque et le réseau, ici nous choisissons de les créer en amont.
 +
 +lister les réseaux disponibles:
 +<code bash>
 +virsh net-list
 + Name      State    Autostart   Persistent
 +--------------------------------------------
 + default   active   yes         yes
 +
 +# Afficher les caractéristiques du réseau "default"
 +virsh net-info default
 +Name:           default
 +UUID:           af20a5ca-db45-4b5e-a2ee-e50ad4c79264
 +Active:         yes
 +Persistent:     yes
 +Autostart:      yes
 +Bridge:         virbr0
 +</code>
 +
 +Ici il existe un réseau par défaut, le nom du pont est **virbr0**, on l'utilisera pour notre VM.
 +
 +Plusieurs formats sont disponibles pour le fichier disque de la VM. On utilise **qcow2**, il sera provisionné à l'usage.
 +
 +<code bash>
 +# Positionne le groupe libvirt-qemu comme groupe principal de l'utilisateur courant
 +newgrp libvirt-qemu
 +
 +mkdir -p ~/KVM/debian11
 +cd ~/KVM/debian11
 +qemu-img create -f qcow2 vda 5G
 +</code>
 +
 +<note>
 +L'utilisateur **libvirt-qemu** doit avoir accès en lecture/écriture sur le dossier contenant l'image disque.
 +</note>
 +
 +Créons à présent la VM avec virt-install:
 +
 +<code bash>
 +virt-install \
 + -n debian11-amd64 \
 + --description "Debian 11 codename bullseye" \
 + --os-type=Linux \
 + --os-variant=debian9 \
 + --ram=1024 \
 + --vcpus=2 \
 + --disk format=qcow2,path=/home/yoann/KVM/debian11/vda \
 + --vnc \
 + --cdrom /home/yoann/KVM/inst_medias/debian-11.6.0-amd64-netinst.iso \
 + --network bridge:virbr0
 +</code>
 +
 +L'utilisation de l'option **%%--os-variant%%** est fortement recommandée. Elle prépositionne un ensemble d'options permettant d'optimiser la VM. Les valeurs possibles de **%%--os-variant%%** peuvent être obtenues par la commande **%%osinfo-query os%%**
 +
 +<note>
 +Si la commande **%%osinfo-query%%** n'est pas disponible, on peut également invoquer :
 +<code bash>
 +virt-install --osinfo list
 +</code>
 +
 +</note>
 +
 +Cet exemple succinct donne les éléments de base de la syntaxe de virt-install. Des notes plus détaillées sont disponibles :
 +
 +  * [[sysadmin:linux:virtualisation:kvm:installation_invite:creation_vm_debian_12|Création d'une VM Debian 12]]
 +
 +===== A propos d' osinfo-query =====
 +
 +La commande **osinfo-query** s'installe via le paquet ''libosinfo-bin'' :
 +
 +<code bash>
 +apt install -y libosinfo-bin
 +</code>
 +
 +
 +:TODO_DOCUPDATE:
 +
 +La commmande **osinfo-query** s'appuie sur un ensemble de fichiers XML présent dans ''/usr/share/osinfo/os/''. Ils peuvent être mis à jour.
 +
 +
 +===== A propos des processeurs =====
 +
 +On peut spécifier un modèle de processeur pour le système invité via l'option **%%--cpu%%**. La liste des processeurs et des fonctionnalités associées est définie dans des fichiers XML sous ''/usr/share/libvirt/cpu_map/'' :
 +
 +
 +Par exemple le fichier ''/usr/share/libvirt/cpu_map/x86_pentium.xml'' ;
 +<file xml [highlight_lines_extra="2"] >
 +<cpus>
 +  <model name='pentium'>
 +    <decode host='on' guest='on'/>
 +    <feature name='cx8'/>
 +    <feature name='de'/>
 +    <feature name='fpu'/>
 +    <feature name='mce'/>
 +    <feature name='mmx'/>
 +    <feature name='msr'/>
 +    <feature name='pse'/>
 +    <feature name='tsc'/>
 +    <feature name='vme'/>
 +  </model>
 +</cpus>
 +</file>
 +
 +===== Transmettre des options à QEMU =====
 +
 +Pour définir des variables d'environnement ou spécifier des options directement à QEMU, utiliser la syntaxe :
 +
 +<code bash>
 +virt-install --connect qemu:///session \
 +...
 +--qemu-commandline=env=PIPEWIRE_RUNTIME_DIR='/run/user/1000' \
 +--qemu-commandline="-display default,show-cursor=off" \
 +...
 +</code>
 +
 +===== Dépannages =====
 +
 +Lors des premières tentatives de création de VM en espace utilisateur, la connexion de la VM en mode bridge provoquait systématiquement une erreur : confère note [[software:applications:qemu:depannage:failed-to-parse-default-acl-file]]
 +
 +
 +
 +===== Références =====
 +
 +  * https://unix.stackexchange.com/questions/309788/how-to-create-a-vm-from-scratch-with-virsh
 +  * https://www.thegeekstuff.com/2014/10/linux-kvm-create-guest-vm/
 +  * [[https://askubuntu.com/questions/1070500/why-doesnt-osinfo-query-os-detect-ubuntu-18-04|Usages de la commande osinfo-query (askubuntu.com) (en)]]

Outils de la page

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : GNU Free Documentation License 1.3
GNU Free Documentation License 1.3 Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki