Aller au contenu

Champs du Virtumfile ​

Le Virtumfile est un fichier YAML. Exemple commenté : examples/Virtumfile.

Lab ​

ChampRôle
nameNom du lab (obligatoire) ; réseau virtum-lab-<name>
machinesLes machines, par nom (obligatoire)
subnetSous-réseau du lab, a.b.c.0/24 ; sinon calculé depuis le nom. Voir Réseau
networklab (défaut) ou bridge, pour toutes les machines
bridge_interfaceInterface hôte pour le bridge
bindlocal (défaut, 127.0.0.1) ou lan pour les ports:. Voir Ports
mountsDossiers partagés hérités par toutes les machines. Voir Dossiers partagés
ssh_portPort SSH des machines si elles le déplacent (repli sur 22)
restartno, always ou unless-stopped : démarrage au boot de l'hôte
ansibleSection Ansible, ci-dessous

Machine ​

ChampRôle
osImage : debian-12, ubuntu-24.04, ubuntu-26.04 (obligatoire)
ramMémoire en Mo (défaut 2048)
cpuProcesseurs virtuels (défaut 2)
disk_sizeTaille du disque (20G)
portsRedirections "<port hôte>:<port VM>"
bindlocal ou lan, surcharge celui du lab
provisionCommandes shell jouées au premier démarrage
mountsDossiers partagés : <hôte>:<invité>, suffixe :rw pour l'écriture
networklab ou bridge, surcharge celui du lab
bridge_interfaceInterface hôte pour le bridge
ipAdresse fixe sur le réseau du lab
ssh_portPort SSH, surcharge celui du lab
restartSurcharge celui du lab
groupsGroupes de l'inventaire Ansible

apply met à jour sur les VM existantes : ram, cpu, bind, ports, disk_size, mounts, ssh_port, restart, ip.

Section ansible ​

ChampRôle
playbookPlaybook, relatif au dossier du Virtumfile (obligatoire)
requirementsCollections et rôles à installer avec ansible-galaxy
snapshotInstantané pris après le premier provisionnement : un nom, true (défaut, provisioned) ou false

Validation ​

Le Virtumfile est validé avant usage : noms (lab, machines, groupes, instantanés), chemins hôte relatifs et sous le Virtumfile, chemins invité sous /home/virtum, partages non imbriqués.

Un Virtumfile est du code

Lancer le Virtumfile ou le playbook d'un inconnu revient à exécuter son code sur votre machine.