Tag 4: Templates und Kontextualisierung
Ziel: Ein eigenes Template schreiben, das jede VM mit Hostname, Schlüssel, Netz und Startskript versorgt, und Werte beim Start abfragen. · Dauer: ca. 60 min · Voraussetzung: Tag 3
Briefing
- Ein Template ist eine Textdatei in OpenNebulas
eigener Syntax: einfache Attribute (
MEMORY = "256") und Vektoren in eckigen Klammern (DISK = [ … ]). - Kontextualisierung heißt: Beim Start bekommt die VM ein kleines CD-Laufwerk mit Daten über sich selbst, etwa IP-Adresse, SSH-Schlüssel, Hostname und ein Startskript. Das Paket one-context in der VM liest es und richtet alles ein. Im Alpine aus dem Marketplace ist es schon drin.
- Werte im Template können Variablen enthalten:
$NAMEist der Name der VM,$USER[SSH_PUBLIC_KEY]der Schlüssel des Benutzers,$GRUSSeine eigene Eingabe. - USER_INPUTS fragen beim Instanziieren nach Werten,
in Sunstone als Formular, in der CLI per
--user-inputs.
Template alpine ── instantiate ──► VM
CONTEXT = [ SET_HOSTNAME = "$NAME", … ] CD „CONTEXT“ (sr0)
└─ one-context in der VM:
Hostname, Netz, Schlüssel, Skript
Drill 1: Das Template
mkdir -p ~/one-lab/tag04
cd ~/one-lab/tag04
cat > alpine.tpl <<'EOF'
NAME = "alpine"
CPU = "0.5"
VCPU = "1"
MEMORY = "256"
DISK = [ IMAGE = "Alpine Linux 3.20", IMAGE_UNAME = "oneadmin" ]
NIC = [ NETWORK = "vnet", NETWORK_UNAME = "oneadmin" ]
GRAPHICS = [ TYPE = "vnc", LISTEN = "0.0.0.0" ]
USER_INPUTS = [ GRUSS = "O|text|Begrüßung beim Anmelden||Hallo aus OpenNebula" ]
CONTEXT = [
NETWORK = "YES",
SSH_PUBLIC_KEY = "$USER[SSH_PUBLIC_KEY]",
SET_HOSTNAME = "$NAME",
GRUSS = "$GRUSS",
START_SCRIPT = "echo \"$GRUSS\" > /etc/motd" ]
EOF
onetemplate create alpine.tplErwartet:
ID: 2
| Zeile | Bedeutung |
|---|---|
CPU = "0.5", VCPU = "1" |
die VM sieht einen Kern und bekommt beim Scheduler einen halben angerechnet |
DISK, NIC |
Image und Netz per Name, *_UNAME sagt, wem sie
gehören |
USER_INPUTS |
O optional, text Typ, dann Beschreibung,
leerer Bereich, Standardwert |
NETWORK = "YES" |
one-context richtet IP, Gateway und DNS aus OpenNebula ein |
SET_HOSTNAME |
Hostname der VM, hier ihr Name in OpenNebula |
START_SCRIPT |
ein Skript, das one-context beim Start als root ausführt |
Die einfachen Anführungszeichen um 'EOF' sind wichtig:
Die Shell soll $NAME und $GRUSS nicht selbst
ersetzen, das macht OpenNebula.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Mit Eingabe starten
onetemplate instantiate alpine --name kontext --user-inputs GRUSS="Servus vom Trainingslager"Erwartet (die ID weicht ab):
VM ID: 8
Ohne --user-inputs fragt die CLI interaktiv nach jedem
Wert. Für Skripte gibst du sie deshalb immer mit.
Nach einer Minute:
IP=$(onevm show kontext | grep -o 'ETH0_IP="[0-9.]*' | cut -d'"' -f2)
ssh root@$IP "hostname; cat /etc/motd"Erwartet (gekürzt):
kontext
Servus vom Trainingslager
Der Hostname kommt aus SET_HOSTNAME, die Begrüßung aus
dem Startskript. In Tag 1 hieß die VM in sich selbst noch
localhost.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Was die VM bekommt
OpenNebula ersetzt alle Variablen, bevor es den Kontext auf die CD schreibt:
onevm show kontext | sed -n '/^CONTEXT=/,/]/p' | grep -E 'ETH0_IP=|ETH0_GATEWAY|GRUSS|SET_HOSTNAME|START_SCRIPT'Erwartet:
ETH0_GATEWAY="192.168.150.1",
ETH0_IP="192.168.150.11",
GRUSS="Servus vom Trainingslager",
SET_HOSTNAME="kontext",
START_SCRIPT="echo \"Servus vom Trainingslager\" > /etc/motd",
Die ETH0_*-Werte hat OpenNebula aus dem virtuellen Netz
ergänzt, weil NETWORK = "YES" gesetzt ist. In der VM liegt
das als CD und als Datei:
ssh root@$IP "blkid | grep CONTEXT; grep -E 'GRUSS|SET_HOSTNAME' /run/one-context/one_env"Erwartet:
/dev/sr0: BLOCK_SIZE="2048" UUID="2026-11-12-19-12-02-00" LABEL="CONTEXT" TYPE="iso9660"
export GRUSS="Servus vom Trainingslager"
export SET_HOSTNAME="kontext"
/run/one-context/one_env ist für eigene Skripte gedacht:
. /run/one-context/one_env, und alle Kontext-Werte stehen
als Umgebungsvariablen bereit. Das nutzt Tag 6.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
onetemplate list | grep alpineErwartet: eine Zeile alpine.
diff ~/one-lab/tag04/alpine.tpl ~/one-lab/code/loesung/tag04/alpine.tplErwartet: keine Ausgabe.
Challenge
Ein Startskript in einer Zeile wird schnell unlesbar. Leg ein zweites
Template alpine-start an, das ein mehrzeiliges Skript aus
einer Datei ausführt: htop installieren und in
/root/start.log „fertig“ schreiben.
Hinweis: START_SCRIPT_BASE64 nimmt ein
Skript in Base64 auf. Damit stören weder Anführungszeichen noch
Zeilenumbrüche.
Lösung
cat > start.sh <<'EOF'
#!/bin/sh
apk add -q htop
echo fertig > /root/start.log
EOF
sed -e 's/^NAME = "alpine"/NAME = "alpine-start"/' \
-e 's| START_SCRIPT = .*| START_SCRIPT_BASE64 = "SKRIPT" ]|' alpine.tpl > alpine-start.tpl
sed -i "s|SKRIPT|$(base64 -w0 start.sh)|" alpine-start.tpl
tail -1 alpine-start.tplErwartet:
START_SCRIPT_BASE64 = "IyEvYmluL3NoCmFwayBhZGQgLXEgaHRvcAplY2hvIGZlcnRpZyA+IC9yb290L3N0YXJ0LmxvZwo=" ]
onetemplate create alpine-start.tpl
onetemplate instantiate alpine-start --name start --user-inputs GRUSS=HalloNach gut einer Minute:
IP=$(onevm show start | grep -o 'ETH0_IP="[0-9.]*' | cut -d'"' -f2)
ssh root@$IP "cat /root/start.log; which htop"Erwartet:
fertig
/usr/bin/htop
Das Paket kommt aus dem Internet. Klappt es nicht, prüf die DNS-Korrektur aus Tag 1.
Aufräumen:
onevm terminate --hard kontext
onevm terminate --hard startFortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- cloud-init statt one-context: Fertige Cloud-Images
von Ubuntu oder Debian bringen cloud-init mit. OpenNebula spricht auch
damit, über
CONTEXT=[ USER_DATA = … ]. Wer Images aus dem Marketplace nimmt, hat one-context schon an Bord. - Templates versionieren: Templates sind Textdateien.
Sie gehören in Git, und eine Pipeline spielt sie mit
onetemplate updateein. Noch bequemer geht das mit Terraform (Tag 12). - Geheimnisse im Kontext: Alles im Kontext kann jeder lesen, der die VM sieht, und in der VM jeder Prozess, der das CD-Laufwerk liest. Passwörter gehören dort nur hin, wenn sie kurzlebig sind. Besser holt die VM sie beim Start aus einem Tresor wie OpenBao.