Zum Inhalt springen
Trainingslager IT-Trainingslager

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: $NAME ist der Name der VM, $USER[SSH_PUBLIC_KEY] der Schlüssel des Benutzers, $GRUSS eine 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.tpl

Erwartet:

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 alpine

Erwartet: eine Zeile alpine.

diff ~/one-lab/tag04/alpine.tpl ~/one-lab/code/loesung/tag04/alpine.tpl

Erwartet: 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.tpl

Erwartet:

  START_SCRIPT_BASE64 = "IyEvYmluL3NoCmFwayBhZGQgLXEgaHRvcAplY2hvIGZlcnRpZyA+IC9yb290L3N0YXJ0LmxvZwo=" ]
onetemplate create alpine-start.tpl
onetemplate instantiate alpine-start --name start --user-inputs GRUSS=Hallo

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

Fortschritt 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 update ein. 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.