Tag 4: virt-install und cloud-init
Ziel: Eine VM mit einem einzigen
virt-install-Befehl aus Basis-Image und cloud-init-Dateien erzeugen, die nach dem Start fertig eingerichtet ist. · Dauer: ca. 60 min · Voraussetzung: Tag 3
Briefing
virt-installschreibt die Domain-XML für dich, legt die Platte an, baut den Seed für cloud-init und startet die VM. Was du in Tag 1 bis 3 von Hand gebaut hast, wird ein Befehl.- cloud-init liest zwei Dateien: meta-data sagt,
wer die VM ist (
instance-id, Hostname), user-data sagt, was passieren soll (Benutzer, Pakete, Befehle). - Die
instance-identscheidet, ob cloud-init „zum ersten Mal” läuft. Gleiche ID heißt: schon erledigt.
user-data + meta-data ──► virt-install ──► web1.qcow2 (Overlay auf basis/noble.qcow2)
├─► cloudinit.iso (nur beim ersten Start)
└─► Domain web1 + qemu-guest-agent-Kanal
Drill 1: Was weiß libvirt über Betriebssysteme?
sudo apt-get install -y libosinfo-bin
osinfo-query os | grep ubuntu24Erwartet:
ubuntu24.04 | Ubuntu 24.04 LTS | 24.04 | …
Mit --osinfo ubuntu24.04 wählt virt-install
passende Geräte (virtio, Maschinentyp) und kennt die
Mindestanforderungen des Systems.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Ein Basis-Image für alle
sudo mkdir -p /var/lib/libvirt/images/basis
sudo cp ~/kvm-lab/images/noble-server-cloudimg-amd64.img \
/var/lib/libvirt/images/basis/noble.qcow2
sudo chmod 444 /var/lib/libvirt/images/basis/noble.qcow2Wie in Tag 2 ist die Basis schreibgeschützt. Ab jetzt bekommt jede VM ein dünnes Overlay darauf.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Die cloud-init-Dateien
mkdir -p ~/kvm-lab/tag04 && cd ~/kvm-lab/tag04
cat > user-data <<EOF
#cloud-config
users:
- name: ubuntu
groups: [sudo]
sudo: "ALL=(ALL) NOPASSWD:ALL"
shell: /bin/bash
lock_passwd: false
plain_text_passwd: lab-console-pw-123
ssh_authorized_keys:
- $(cat ~/.ssh/id_ed25519.pub)
package_update: true
packages: [nginx, qemu-guest-agent]
runcmd:
- echo "web1 aus cloud-init" > /var/www/html/index.html
- systemctl enable --now qemu-guest-agent
EOF
cat > meta-data <<'EOF'
instance-id: web1-001
local-hostname: web1
EOFuserslegt den Benutzer vollständig an: sudo ohne Passwort, Konsolenpasswort, SSH-Schlüssel.packagesinstalliert nginx und den QEMU Guest Agent (kurz Gast-Agent), einen kleinen Dienst, über den libvirt mit dem Gast spricht (Drill 7).runcmdläuft einmal, ganz am Ende des ersten Starts.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Erst ansehen, dann bauen
virt-install --name web1 --memory 1024 --vcpus 2 --osinfo ubuntu24.04 --import \
--disk size=10,backing_store=/var/lib/libvirt/images/basis/noble.qcow2 \
--network network=default \
--cloud-init user-data=user-data,meta-data=meta-data \
--graphics none --noautoconsole \
--print-xml --dry-run | head -20Erwartet (gekürzt):
<domain type="kvm">
<name>web1</name>
<uuid>…</uuid>
<metadata>
<libosinfo:libosinfo xmlns:libosinfo="http://libosinfo.org/xmlns/libvirt/domain/1.0">
<libosinfo:os id="http://ubuntu.com/ubuntu/24.04"/>
</libosinfo:libosinfo>
</metadata>
<memory>1048576</memory>
<currentMemory>1048576</currentMemory>
<vcpu>2</vcpu>
<os>
<type arch="x86_64" machine="q35">hvm</type>
<smbios mode="sysinfo"/>
</os>
<features>
<acpi/>
<apic/>
</features>
<cpu mode="host-passthrough"/>
| Option | Bedeutung |
|---|---|
--import |
nichts installieren, die Platte ist schon bootfähig |
--disk size=10,backing_store=… |
neues 10-GB-Overlay web1.qcow2 auf der Basis |
--cloud-init user-data=…,meta-data=… |
Seed bauen und beim ersten Start einlegen |
--graphics none --noautoconsole |
serielle Konsole, nicht automatisch verbinden |
Ausprobiert: Ohne
--dry-runlegt--print-xmldie Platte trotzdem schon an. Der echte Aufruf danach findetweb1.qcow2vor und nennt die neue Platte stillschweigendweb1-1.qcow2. Zurück bleibt eine verwaiste Datei, die niemand mehr nutzt.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Bauen
Derselbe Befehl ohne die letzte Zeile:
virt-install --name web1 --memory 1024 --vcpus 2 --osinfo ubuntu24.04 --import \
--disk size=10,backing_store=/var/lib/libvirt/images/basis/noble.qcow2 \
--network network=default \
--cloud-init user-data=user-data,meta-data=meta-data \
--graphics none --noautoconsoleErwartet:
WARNING Requested memory 1024 MiB is less than the recommended 3072 MiB for OS ubuntu24.04
Starting install...
Allocating 'virtinst-0ngrwmyt-cloudinit.iso' | 0 B 00:00 ...
Transferring 'virtinst-0ngrwmyt-cloudinit.iso' | 0 B 00:00 ...
Allocating 'web1.qcow2' | 0 B 00:00 ...
Creating domain... | 0 B 00:00
Domain creation completed.
Die Warnung stammt aus der osinfo-Datenbank. Für einen nginx genügt 1 GB.
virsh domblklist web1
sudo qemu-img info -U /var/lib/libvirt/images/web1.qcow2 | grep -E 'virtual|^disk|backing'Erwartet:
Target Source
-----------------------------------------------------------------
vda /var/lib/libvirt/images/web1.qcow2
sda /var/lib/libvirt/boot/virtinst-0ngrwmyt-cloudinit.iso
virtual size: 10 GiB (10737418240 bytes)
disk size: 328 KiB
backing file: /var/lib/libvirt/images/basis/noble.qcow2
-U (force share) erlaubt qemu-img info auf
eine Platte, die gerade in Benutzung ist. Ohne kommt der Sperrfehler aus
Tag 2.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Fertig eingerichtet?
Nach etwa einer Minute hat der Gast eine IP:
virsh domifaddr web1Erwartet:
Name MAC address Protocol Address
-------------------------------------------------------------------------------
vnet4 52:54:00:5e:a8:8a ipv4 192.168.122.110/24
Die Pakete brauchen länger. cloud-init status --wait
wartet, bis alles fertig ist:
ssh -o StrictHostKeyChecking=no [email protected] cloud-init status --wait
ssh [email protected] cloud-init status --longErwartet (gekürzt, nach zwei bis drei Minuten):
……………………………………………
status: done
status: done
extended_status: done
boot_status_code: enabled-by-generator
…
detail: DataSourceNoCloud [seed=dmi,/dev/sr0][dsmode=local]
errors: []
errors: [] ist die wichtigste Zeile. Ein Tippfehler in
user-data landet hier, die VM startet trotzdem.
curl http://192.168.122.110/Erwartet:
web1 aus cloud-init
Fortschritt speichern? Kostenlos registrieren
Drill 7: Der Gast-Agent
virt-install hat der Domain einen Kanal zum Gast-Agenten
eingebaut:
virsh dumpxml web1 | grep -A2 '<channel'Erwartet:
<channel type='unix'>
<source mode='bind' path='/run/libvirt/qemu/channel/7-web1/org.qemu.guest_agent.0'/>
<target type='virtio' name='org.qemu.guest_agent.0' state='connected'/>
state='connected': Der Gast-Agent läuft. Jetzt kann
libvirt den Gast selbst fragen, statt im DHCP-Server nachzusehen:
virsh domifaddr web1 --source agentErwartet:
Name MAC address Protocol Address
-------------------------------------------------------------------------------
lo 00:00:00:00:00:00 ipv4 127.0.0.1/8
- - ipv6 ::1/128
enp1s0 52:54:00:5e:a8:8a ipv4 192.168.122.110/24
- - ipv6 fe80::5054:ff:fe5e:a88a/64
Das funktioniert auch bei festen IPs ohne DHCP. Mehr kann der Agent in Tag 9.
Fortschritt speichern? Kostenlos registrieren
Drill 8: Der erste Neustart
virsh reboot web1
virsh list --allErwartet (nach einigen Sekunden):
Domain 'web1' is being rebooted
Id Name State
------------------------
- erste shut off
- web1 shut off
Aus statt neu gestartet. Warum?
virsh dumpxml --inactive web1 | grep on_rebootErwartet:
<on_reboot>restart</on_reboot>
Ausprobiert: Während der „Installation” setzt
virt-installin der laufenden Definitionon_rebootaufdestroy. Normalerweise wartet es auf diesen ersten Neustart, entfernt den Seed und startet die VM neu. Mit--noautoconsoleistvirt-installaber längst beendet, und niemand startet die VM wieder. Die gespeicherte Definition ist in Ordnung, ab jetzt gilt wiederrestart.
virsh start web1
virsh domblklist web1Erwartet:
Domain 'web1' started
Target Source
----------------------------------------------
vda /var/lib/libvirt/images/web1.qcow2
sda -
Das Laufwerk mit dem Seed ist leer. virt-install hat die
ISO-Datei schon beim Anlegen nur in die laufende Definition gehängt und
danach gelöscht. Gut so, denn sie enthielt das Konsolenpasswort.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
virsh list --allErwartet: web1 mit running.
curl http://192.168.122.110/Erwartet: web1 aus cloud-init. Deine IP steht in
virsh domifaddr web1.
ssh [email protected] cloud-init statusErwartet: status: done.
Challenge
Baue eine zweite VM web2, die
web2 aus cloud-init ausliefert. Prüfe, dass sie sich
dieselbe Basis mit web1 teilt.
Hinweis: Du brauchst eigene Dateien mit eigener
instance-id und eigenem Hostnamen.
Lösung
cd ~/kvm-lab/tag04
cat > meta-data-web2 <<'EOF'
instance-id: web2-001
local-hostname: web2
EOF
cat > user-data-web2 <<EOF
#cloud-config
users:
- name: ubuntu
groups: [sudo]
sudo: "ALL=(ALL) NOPASSWD:ALL"
shell: /bin/bash
lock_passwd: false
plain_text_passwd: lab-console-pw-123
ssh_authorized_keys:
- $(cat ~/.ssh/id_ed25519.pub)
package_update: true
packages: [nginx, qemu-guest-agent]
runcmd:
- echo "web2 aus cloud-init" > /var/www/html/index.html
- systemctl enable --now qemu-guest-agent
EOF
virt-install --name web2 --memory 1024 --vcpus 2 --osinfo ubuntu24.04 --import \
--disk size=10,backing_store=/var/lib/libvirt/images/basis/noble.qcow2 \
--network network=default \
--cloud-init user-data=user-data-web2,meta-data=meta-data-web2 \
--graphics none --noautoconsoleNach zwei bis drei Minuten:
virsh domifaddr web2 --source agent | grep enp
curl http://192.168.122.51/Erwartet:
enp1s0 52:54:00:51:cc:46 ipv4 192.168.122.51/24
web2 aus cloud-init
sudo qemu-img info -U /var/lib/libvirt/images/web2.qcow2 | grep backingErwartet:
backing file: /var/lib/libvirt/images/basis/noble.qcow2
backing file format: qcow2
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- cloud-init ist der Standard: Proxmox, OpenStack, OpenNebula und die großen Clouds verstehen cloud-config. Deine user-data lässt sich weitgehend übernehmen, nur die Datasource unterscheidet sich.
- Keine Geheimnisse in user-data: Die Datei liegt im
Gast unter
/var/lib/cloud/instance/user-data.txtund ist für root lesbar. Passwörter gehören in einen Secret-Store, nicht in die VM-Beschreibung. - Golden Images: Was jede VM braucht (Agent, Monitoring, Härtung), kommt ins Basis-Image, gebaut etwa mit Packer. cloud-init macht nur noch das Individuelle.
- Gast-Agent immer: Backups mit konsistentem Dateisystem, IP-Anzeige und sauberes Herunterfahren hängen an ihm.