Tag 10: Eine eigene Appliance
Ziel: Aus einer vorbereiteten VM ein eigenes Image machen, das notes-api schon enthält, und ein Template, das damit ohne Paketinstallation startet. · Dauer: ca. 60 min · Voraussetzung: Tag 9
Briefing
- Bisher installiert jede notes-VM beim Start Podman und lädt das Container-Image. Das kostet Zeit und braucht Internet.
- Besser: einmal eine VM einrichten, ihre Platte als neues Image
speichern (
disk-saveas) und aus diesem Image starten. Das Startskript konfiguriert dann nur noch. - Das ist der Weg vom „Startskript-Appliance“ zur „Image-Appliance“. Fertige Appliances im Marketplace sind genau so gebaut.
Template alpine ─► VM bau ─(apk add podman, podman pull)─► poweroff
└─ disk-saveas ─► Image notes-basis
Template notes-schnell (Image notes-basis, kurzes Startskript) ─► VM in ~60 s
Drill 1: Die Bau-VM
onetemplate instantiate alpine --name bau --user-inputs GRUSS=bauNach einer Minute:
IP=$(onevm show bau | grep -o 'ETH0_IP="[0-9.]*' | cut -d'"' -f2)
ssh $IP "apk add -q podman && rc-update add cgroups && rc-service cgroups start >/dev/null \
&& podman pull -q ghcr.io/thomaszachmann/notes-api:0.7.1 && rm -rf /var/cache/apk/* \
&& podman images && df -h / | tail -1"Erwartet (gekürzt):
* For running rootless Podman you need to:
...
* service cgroups added to runlevel default
eb5553ddb0cff5727bf122a2650b5574ba2cf00f61f9d38f2627eb249c1b469f
REPOSITORY TAG IMAGE ID CREATED SIZE
ghcr.io/thomaszachmann/notes-api 0.7.1 eb5553ddb0cf 9 days ago 11.9 MB
/dev/vda 474M 214M 234M 48% /
rc-update add cgroupsträgt den Dienst dauerhaft ein. Im Image startet er dann von selbst.rm -rf /var/cache/apk/*hält das Image klein. Alles, was hier liegen bleibt, steckt in jeder künftigen VM.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Die Platte speichern
Gespeichert wird bei ausgeschalteter VM, sonst ist das Dateisystem mitten im Schreiben:
onevm poweroff bauWenn onevm list poff zeigt:
onevm disk-saveas bau 0 notes-basisErwartet:
Image ID: 9
0 ist die Platten-ID des Betriebssystems. Eine halbe
Minute später:
oneimage list | grep -E 'ID|notes-basis'Erwartet (gekürzt):
ID USER GROUP NAME DATASTORE SIZE TYPE PER STAT RVMS
9 oneadmin oneadmin notes-basis default 512M OS No rdy 0
Die Bau-VM hat ihren Zweck erfüllt:
onevm terminate bauFortschritt speichern? Kostenlos registrieren
Drill 3: Das schnelle Template
Das Startskript schrumpft auf das Wesentliche, ohne apk
und ohne cgroups:
mkdir -p ~/one-lab/tag10
cd ~/one-lab/tag10
cat > notes-schnell.sh <<'EOF'
#!/bin/sh
# notes-api aus dem fertigen Image: nur noch warten und starten
. /run/one-context/one_env
until nc -z -w2 "$DB_HOST" 5432; do sleep 5; done
URL="postgres://notes:$DB_PASSWORD@$DB_HOST:5432/notes?sslmode=disable"
IMG="ghcr.io/thomaszachmann/notes-api:$NOTES_VERSION"
podman run --rm --network host -e NOTES_DB_URL="$URL" "$IMG" migrate
podman rm -f notes
podman run -d --name notes --network host -e NOTES_API_KEY="$API_KEY" -e NOTES_DB_URL="$URL" "$IMG"
EOFDas Template entsteht aus dem von Tag 6, mit anderem Namen, anderem Image und neuem Skript:
sed -e 's/^NAME = "notes"/NAME = "notes-schnell"/' \
-e 's/IMAGE = "Alpine Linux 3.20"/IMAGE = "notes-basis"/' \
-e 's|START_SCRIPT_BASE64 = "[^"]*"|START_SCRIPT_BASE64 = "SKRIPT"|' \
../tag06/notes.tpl > notes-schnell.tpl
sed -i "s|SKRIPT|$(base64 -w0 notes-schnell.sh)|" notes-schnell.tpl
grep -E '^NAME|IMAGE =' notes-schnell.tpl
onetemplate create notes-schnell.tplErwartet:
NAME = "notes-schnell"
DISK = [ IMAGE = "notes-basis", IMAGE_UNAME = "oneadmin" ]
ID: 7
Fortschritt speichern? Kostenlos registrieren
Drill 4: Der Vergleich
Die Datenbank des OneFlow-Service aus Tag 9 läuft und hat die IP 10.10.10.20. Zwei zusätzliche notes-VMs dürfen sich dort anmelden. Die Stoppuhr läuft vom Befehl bis zur ersten Antwort:
T0=$(date +%s)
onetemplate instantiate notes-schnell --name schnell \
--user-inputs DB_PASSWORD=lab-db-pass-123,API_KEY=lab-api-key-123,NOTES_VERSION=0.7.1
sleep 15
IP=$(onevm show schnell | grep -o 'ETH0_IP="[0-9.]*' | cut -d'"' -f2)
until curl -s -m2 $IP:8080/version >/dev/null; do sleep 2; done
echo "Sekunden: $(( $(date +%s) - T0 ))"Erwartet (ungefähr):
VM ID: 32
Sekunden: 62
Dasselbe mit dem alten Template:
T0=$(date +%s)
onetemplate instantiate notes --name langsam \
--user-inputs DB_PASSWORD=lab-db-pass-123,API_KEY=lab-api-key-123,NOTES_VERSION=0.7.1
sleep 15
IP=$(onevm show langsam | grep -o 'ETH0_IP="[0-9.]*' | cut -d'"' -f2)
until curl -s -m2 $IP:8080/version >/dev/null; do sleep 2; done
echo "Sekunden: $(( $(date +%s) - T0 ))"Erwartet (ungefähr):
VM ID: 33
Sekunden: 72
Zehn Sekunden schneller, das klingt nach wenig. Den Großteil der
Minute brauchen Kopieren der Platte, Booten und one-context. Wichtiger
ist etwas anderes: notes-schnell lädt beim Start nichts aus
dem Internet. Fällt die Paketquelle oder die Container-Registry aus,
startet es trotzdem, und jede VM hat garantiert dieselbe Software.
onevm terminate --hard schnell
onevm terminate --hard langsamFortschritt speichern? Kostenlos registrieren
Kontrollpunkt
oneimage list | grep notes-basisErwartet: notes-basis, Typ OS,
STAT rdy.
diff ~/one-lab/tag10/notes-schnell.sh ~/one-lab/code/loesung/tag10/notes-schnell.shErwartet: keine Ausgabe.
Challenge
Team blau soll notes-api selbst starten können. Gib ihm
notes-schnell frei und lass blau-dev eine VM
anlegen. Was kann das Team danach im Netz intern erreichen,
und ist das ein Problem?
Lösung
onetemplate chmod notes-schnell 604
oneimage chmod notes-basis 604
A="--user blau-dev --password lab-blau-pass-123"
onetemplate instantiate notes-schnell --name blau-notes \
--user-inputs DB_PASSWORD=x,API_KEY=y,NOTES_VERSION=0.7.1 $A
onevm list $AErwartet (gekürzt):
VM ID: 34
ID USER GROUP NAME STAT CPU MEM HOST TIME
34 blau-dev team-bla blau-notes prol 0.5 384M localhost 0d 00h00
Es klappt, und genau das ist das Problem: Die VM hängt im Netz
intern, denn das Template sagt es so, und die ACL aus Tag 8
erlaubt Team blau alle Netze. Damit erreicht das Team Port 5432 der
Datenbank. Nur das Passwort schützt sie noch.
Mandanten gehören in eigene Netze. Im Lab nimmst du die Freigabe zurück:
onevm terminate --hard blau-notes $A
onetemplate chmod notes-schnell 600
oneimage chmod notes-basis 600Dauerhaft löst das ein eigener VDC, der Team blau nur das Netz
vnet gibt (Tag 8, Enterprise-Notiz), oder eine Netz-ACL nur
für vnet.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Images bauen statt klicken: Im Betrieb entstehen
Appliance-Images reproduzierbar, etwa mit Packer und dem
OpenNebula-Plugin oder mit den Werkzeugen aus dem Repository
one-apps, mit denen OpenNebula seine eigenen Appliances baut. - Aufräumen vor dem Speichern: Ein gespeichertes
Image enthält alles: SSH-Host-Keys, Logs,
machine-id, Shell-Historie. Vordisk-saveasgehört das weg, damit nicht alle VMs dieselben Host-Keys haben. - Eigene Marketplaces: Images lassen sich über einen
privaten Marketplace (HTTP oder S3) zwischen Zonen und Standorten
teilen.
onemarketapp createlädt ein Image dort hoch,onemarketapp exportholt es an einem anderen Standort.