Zum Inhalt springen
Trainingslager IT-Trainingslager

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-install schreibt 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-id entscheidet, 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 ubuntu24

Erwartet:

 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.qcow2

Wie 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
EOF
  • users legt den Benutzer vollständig an: sudo ohne Passwort, Konsolenpasswort, SSH-Schlüssel.
  • packages installiert nginx und den QEMU Guest Agent (kurz Gast-Agent), einen kleinen Dienst, über den libvirt mit dem Gast spricht (Drill 7).
  • runcmd lä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 -20

Erwartet (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-run legt --print-xml die Platte trotzdem schon an. Der echte Aufruf danach findet web1.qcow2 vor und nennt die neue Platte stillschweigend web1-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 --noautoconsole

Erwartet:

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 web1

Erwartet:

 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 --long

Erwartet (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 agent

Erwartet:

 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 --all

Erwartet (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_reboot

Erwartet:

  <on_reboot>restart</on_reboot>

Ausprobiert: Während der „Installation” setzt virt-install in der laufenden Definition on_reboot auf destroy. Normalerweise wartet es auf diesen ersten Neustart, entfernt den Seed und startet die VM neu. Mit --noautoconsole ist virt-install aber längst beendet, und niemand startet die VM wieder. Die gespeicherte Definition ist in Ordnung, ab jetzt gilt wieder restart.

virsh start web1
virsh domblklist web1

Erwartet:

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 --all

Erwartet: 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 status

Erwartet: 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 --noautoconsole

Nach 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 backing

Erwartet:

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.txt und 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.