Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 1: QEMU von Hand

Ziel: Eine Ubuntu-VM nur mit qemu-system-x86_64 starten, per Konsole und SSH hineinschauen und sehen, was KVM ausmacht. · Dauer: ca. 60 min · Voraussetzung: Tag 0

Briefing

  • Ohne Verwaltungsschicht ist eine VM ein einziger Befehl: qemu-system-x86_64 mit Optionen für CPU, RAM, Platten und Netz. Wenn der Prozess endet, ist die VM aus.
  • Als Platte nimmst du ein Cloud-Image: ein fertig installiertes Ubuntu ohne Benutzer und Passwort. Beides bekommt der Gast beim ersten Start von cloud-init aus einer kleinen ISO-Datei, dem Seed.
  • -enable-kvm schaltet die Beschleunigung ein. Ohne sie emuliert QEMU jede CPU-Anweisung in Software (TCG, Tiny Code Generator), und das ist zehnmal langsamer und mehr.
 kvm1
 └─ qemu-system-x86_64 (dein Benutzer)
     ├─ vda  erste.qcow2   Kopie des Cloud-Images
     ├─ vdb  seed.iso      user-data für cloud-init
     ├─ Netz: user-mode (10.0.2.15), Port 2222 → 22
     └─ Konsole: dein Terminal (-nographic)

Drill 1: QEMU installieren

sudo apt-get install -y qemu-system-x86 qemu-utils cloud-image-utils
qemu-system-x86_64 --version

Erwartet:

QEMU emulator version 8.2.2 (Debian 1:8.2.2+ds-0ubuntu1.18)
Copyright (c) 2003-2023 Fabrice Bellard and the QEMU Project developers
  • qemu-system-x86 bringt den Emulator für x86-Gäste.
  • qemu-utils enthält qemu-img für Plattendateien (Tag 2).
  • cloud-image-utils enthält cloud-localds, das den Seed baut.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Das Cloud-Image

cd ~/kvm-lab/images
wget -q https://cloud-images.ubuntu.com/noble/current/noble-server-cloudimg-amd64.img
qemu-img info noble-server-cloudimg-amd64.img

Erwartet (gekürzt, Größen weichen bei dir ab):

image: noble-server-cloudimg-amd64.img
file format: qcow2
virtual size: 3.5 GiB (3758096384 bytes)
disk size: 593 MiB
…

Die Datei ist 593 MiB groß, der Gast sieht aber eine Platte mit 3,5 GiB. Das Format qcow2 speichert nur belegte Blöcke. Mehr dazu in Tag 2.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Der Seed für cloud-init

mkdir -p ~/kvm-lab/tag01 && cd ~/kvm-lab/tag01
cat > user-data <<EOF
#cloud-config
hostname: erste
password: lab-console-pw-123
chpasswd: { expire: false }
ssh_authorized_keys:
  - $(cat ~/.ssh/id_ed25519.pub)
EOF
cat user-data

Erwartet (dein Schlüssel weicht ab):

#cloud-config
hostname: erste
password: lab-console-pw-123
chpasswd: { expire: false }
ssh_authorized_keys:
  - ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIKBb5JErN+8f… ubuntu@kvm1
  • password gilt für den Standardbenutzer ubuntu und ist nur für die Konsole da.
  • $(cat …) setzt die Shell beim Schreiben ein, deshalb steht EOF hier ohne Anführungszeichen.
cloud-localds seed.iso user-data
ls -lh seed.iso

Erwartet:

-rw-rw-r-- 1 ubuntu ubuntu 366K Nov 13 12:48 seed.iso

cloud-localds baut eine kleine ISO mit der Datenträgerbezeichnung cidata. cloud-init im Gast sucht beim Start nach genau so einem Laufwerk. Diese Quelle heißt NoCloud.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Die Platte der VM

Das heruntergeladene Image bleibt unberührt. Die VM bekommt eine Kopie, die du auf 10 GB vergrößerst:

cp ../images/noble-server-cloudimg-amd64.img erste.qcow2
qemu-img resize erste.qcow2 10G

Erwartet:

Image resized.

Die Partition im Gast wächst beim ersten Start von selbst mit, das erledigt cloud-init.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Der Start

qemu-system-x86_64 -enable-kvm -cpu host -m 1024 -smp 2 \
  -drive file=erste.qcow2,if=virtio \
  -drive file=seed.iso,if=virtio,format=raw \
  -nic user,hostfwd=tcp::2222-:22 \
  -nographic
Option Bedeutung
-enable-kvm -cpu host KVM nutzen und dem Gast die echte CPU zeigen
-m 1024 -smp 2 1 GB RAM, 2 vCPUs
-drive …,if=virtio Platte als schnelles virtio-Gerät, im Gast /dev/vda
-nic user,hostfwd=… Netz im QEMU-Prozess, Port 2222 auf kvm1 führt zu Port 22 im Gast
-nographic keine Grafik, die serielle Konsole landet in deinem Terminal

Die Bootmeldungen laufen durch. Nach etwa einer Minute erscheint (gekürzt, Zeiten weichen bei dir ab):

erste login: [   46.445286] cloud-init[1047]: Cloud-init v. 26.1-0ubuntu1~24.04.1
running 'modules:final' at Fri, 13 Nov 2026 12:50:08 +0000. Up 46.34 seconds.
[   47.118406] cloud-init[1047]: Cloud-init v. 26.1-0ubuntu1~24.04.1 finished at …
Datasource DataSourceNoCloud [seed=/dev/vdb].  Up 47.08 seconds

Datasource DataSourceNoCloud [seed=/dev/vdb] heißt: cloud-init hat deinen Seed gefunden. Drücke Enter und melde dich als ubuntu mit lab-console-pw-123 an.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Im Gast und daneben

Lass die Konsole offen und öffne eine zweite SSH-Sitzung zu kvm1:

# zweite Sitzung auf kvm1
ssh -p 2222 ubuntu@localhost

Bestätige den Schlüssel mit yes. Im Gast:

# im Gast erste
systemd-detect-virt
lsblk

Erwartet:

kvm
NAME    MAJ:MIN RM  SIZE RO TYPE MOUNTPOINTS
fd0       2:0    1    4K  0 disk 
sr0      11:0    1 1024M  1 rom  
vda     253:0    0   10G  0 disk 
├─vda1  253:1    0    9G  0 part /
├─vda14 253:14   0    4M  0 part 
├─vda15 253:15   0  106M  0 part /boot/efi
└─vda16 259:0    0  913M  0 part /boot
vdb     253:16   0  366K  0 disk 

vda hat 10 GB, und / ist auf 9 GB gewachsen. vdb ist der Seed.

# im Gast erste
ip -br a
exit

Erwartet:

lo               UNKNOWN        127.0.0.1/8 ::1/128 
ens3             UP             10.0.2.15/24 metric 100 …

Im User-Mode-Netz bekommt jeder Gast 10.0.2.15. Er kommt ins Internet, aber von außen erreichst du ihn nur über weitergeleitete Ports. Echte Netze baust du in Tag 6.

Auf kvm1 ist die VM ein ganz normaler Prozess:

# auf kvm1
ps -o pid,rss,etime,cmd -C qemu-system-x86_64

Erwartet (gekürzt):

    PID   RSS     ELAPSED CMD
  30414 672344      01:20 qemu-system-x86_64 -enable-kvm -cpu host -m 1024 -smp 2 …

RSS ist der echte Speicher, den der Prozess belegt, hier gut 650 MB.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Der QEMU-Monitor

Zurück in der ersten Sitzung mit der Konsole. Drücke Strg+A, lass los, dann c. Du landest im Monitor von QEMU, der Steuerzentrale des Prozesses:

(qemu) info kvm
kvm support: enabled
(qemu) info cpus
* CPU #0: thread_id=31419
  CPU #1: thread_id=31420
  • kvm support: enabled bestätigt die Beschleunigung.
  • Jede vCPU ist ein eigener Thread des QEMU-Prozesses. Der Linux-Scheduler verteilt sie wie alle anderen Threads auf die echten Kerne (Tag 10).
(qemu) info block
virtio0 (#block176): erste.qcow2 (qcow2)
    Attached to:      /machine/peripheral-anon/device[0]/virtio-backend
    Cache mode:       writethrough
…

Mit Strg+A, dann c kommst du zurück zur Konsole. Fahre den Gast dort sauber herunter:

# in der Konsole von erste
sudo poweroff

Wenn der Gast aus ist, endet auch der QEMU-Prozess, und dein Prompt auf kvm1 kehrt zurück. Im Notfall beendet Strg+A, dann x QEMU sofort, wie ein gezogener Stecker.

Fortschritt speichern? Kostenlos registrieren

Drill 8: Ohne KVM

Was bringt KVM? Starte eine zweite Kopie mit reiner Emulation (-accel tcg) und miss die Zeit bis zum Login:

cp ../images/noble-server-cloudimg-amd64.img tcg.qcow2
qemu-system-x86_64 -accel tcg -m 1024 -smp 2 \
  -drive file=tcg.qcow2,if=virtio \
  -drive file=seed.iso,if=virtio,format=raw \
  -nographic

Im Monitor (Strg+A, c) zeigt info kvm jetzt kvm support: disabled. Und dann heißt es warten:

Beschleunigung Login-Prompt nach
KVM ca. 46 Sekunden
TCG ca. 600 Sekunden

Ausprobiert: Unter TCG war der Gast so langsam, dass systemd die Geduld verlor: Timed out waiting for device … /dev/disk/by-label/BOOT, danach Dependency failed for boot.mount und der Notfallmodus mit (or press Control-D to continue). Der Start lief trotzdem von selbst weiter, und der Login-Prompt kam nach rund 600 Sekunden. Die VM lief, nur eben zehnmal langsamer. Wenn eine VM auf einem neuen Host ohne erkennbaren Grund in Timeouts läuft, prüfe als Erstes, ob KVM wirklich aktiv ist.

Beende die TCG-VM mit Strg+A, dann x, und räume auf:

rm tcg.qcow2

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

ls ~/kvm-lab/tag01

Erwartet: die Dateien erste.qcow2, seed.iso und user-data.

qemu-img info ~/kvm-lab/tag01/erste.qcow2

Erwartet: virtual size: 10 GiB. Die Zeile disk size ist deutlich kleiner, weil nur belegte Blöcke Platz kosten.

pgrep -a qemu-system

Erwartet: keine Ausgabe. Alle VMs sind aus.

Challenge

Starte erste noch einmal, diesmal mit 2 GB RAM, 4 vCPUs und ohne den Seed. Prüfe per SSH, ob dein Schlüssel noch gilt und wie viele vCPUs der Gast sieht.

Hinweis: cloud-init läuft nur beim allerersten Start vollständig. Seine Ergebnisse stehen in der Platte, nicht im Seed.

Lösung

cd ~/kvm-lab/tag01
qemu-system-x86_64 -enable-kvm -cpu host -m 2048 -smp 4 \
  -drive file=erste.qcow2,if=virtio \
  -nic user,hostfwd=tcp::2222-:22 \
  -nographic

In einer zweiten Sitzung:

ssh -p 2222 ubuntu@localhost nproc

Erwartet:

4

Der Login mit deinem Schlüssel funktioniert weiter, denn Benutzer und Schlüssel liegen jetzt in der Platte. RAM und vCPUs sind keine Eigenschaft der Platte, sondern des QEMU-Aufrufs. Genau diese Trennung verwaltet libvirt ab Tag 3 für dich. Fahre den Gast mit sudo poweroff herunter.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Niemand tippt QEMU-Aufrufe: Im Betrieb erzeugt libvirt, Proxmox (qm showcmd) oder OpenStack diese Befehlszeilen. Sie lesen zu können, hilft beim Debuggen.
  • User-Mode-Netz nur zum Testen: Es ist langsam und von außen nicht erreichbar. Produktive VMs hängen an Bridges (Tag 6).
  • Cloud-Images statt Installation: Alle großen Distributionen bieten sie an. Mit cloud-init steht eine VM in einer Minute, ohne Installer und ohne Klicken.
  • Monitor absichern: Der Monitor kann Platten tauschen und die VM beenden. Im Betrieb spricht nur libvirt mit ihm, über das Protokoll QMP (QEMU Machine Protocol) auf einem Socket mit festen Rechten.