Zum Inhalt springen
Trainingslager IT-Trainingslager

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=bau

Nach 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 cgroups trä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 bau

Wenn onevm list poff zeigt:

onevm disk-saveas bau 0 notes-basis

Erwartet:

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 bau

Fortschritt 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"
EOF

Das 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.tpl

Erwartet:

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 langsam

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

oneimage list | grep notes-basis

Erwartet: notes-basis, Typ OS, STAT rdy.

diff ~/one-lab/tag10/notes-schnell.sh ~/one-lab/code/loesung/tag10/notes-schnell.sh

Erwartet: 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 $A

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

Dauerhaft 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. Vor disk-saveas gehö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 create lädt ein Image dort hoch, onemarketapp export holt es an einem anderen Standort.