Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 0: Das Trainingsgelände

Ziel: Die Labor-VM anlegen, alle Werkzeuge nach einem festen Prinzip installieren und prüfen und die Demo-Anwendung notes kennenlernen. · Dauer: ca. 60 min · Voraussetzung: keine

Briefing

  • Gearbeitet wird in einer Ubuntu-26.04-VM ct-lab, als User ubuntu in ~/ct-lab. Auf dem Mac legst du sie mit Multipass an.
  • Zwei Wege der Installation: Ubuntu-Paket (apt, signiert über das Archiv) oder Release-Binary von GitHub (selbst mit SHA-256 prüfen, dann nach /usr/local/bin).
  • setup/tools.lock pinnt jedes Binary mit URL und Prüfsumme für amd64 und arm64. Heute installierst du danach alle Werkzeuge, mit den vier Schritten aus Drill 4 in einer kurzen Schleife.
 GitHub                           VM ct-lab (Ubuntu 26.04, arm64)
 ┌──────────────────────┐        ┌──────────────────────────────────────────┐
 │ thomaszachmann/      │  git   │ ~/ct-lab/code   Begleitcode (Original)   │
 │ container-tools-     │ clone  │ ~/ct-lab/setup  env.sh, tools.lock       │
 │ zum-anfassen         │───────►│ ~/ct-lab/notes  notes-api, -web, -worker │
 └──────────────────────┘        │ apt:  podman buildah skopeo jq …         │
 Mac: multipass shell ──────────►│ /usr/local/bin: crane trivy cosign …     │
                                 └──────────────────────────────────────────┘

Drill 1: Die Labor-VM

Auf dem Mac (Multipass von multipass.run):

multipass launch 26.04 --name ct-lab --cpus 2 --memory 4G --disk 40G
multipass shell ct-lab

Ab hier läuft alles in der VM:

grep -E '^(PRETTY_NAME|VERSION_ID)' /etc/os-release
uname -m
nproc && free -h | head -2

Erwartet (gekürzt, Werte weichen bei dir ab):

PRETTY_NAME="Ubuntu 26.04.1 LTS"
VERSION_ID="26.04"
aarch64
2
               total        used        free      shared  buff/cache   available
Mem:           3.9Gi       823Mi       426Mi       5.4Mi       3.0Gi       3.1Gi

aarch64 heißt: Auf einem Mac mit Apple Silicon brauchst du überall die arm64-Variante eines Binaries. Auf einem Intel-Rechner oder in der Cloud steht hier x86_64 (amd64).

Fortschritt speichern? Kostenlos registrieren

Drill 2: Pakete aus Ubuntu

Podman, Buildah und Skopeo stammen aus demselben Projekt (github.com/containers) und sind bei Ubuntu gut gepflegt. Dazu jq für JSON, htpasswd aus apache2-utils und ShellCheck für Shell-Skripte (Tag 12):

sudo apt-get update
sudo apt-get install -y podman buildah skopeo jq apache2-utils shellcheck
podman --version
buildah --version
skopeo --version
jq --version
dpkg -l apache2-utils | tail -1 | awk '{print $2, $3}'
shellcheck --version | sed -n 2p

Erwartet (gekürzt):

podman version 5.7.0
buildah version 1.42.1 (image-spec 1.1.1, runtime-spec 1.2.1)
skopeo version 1.21.0-dev
jq-1.8.1
apache2-utils 2.4.66-2ubuntu2.6
version: 0.11.0

Mitinstalliert werden crun (die OCI-Runtime), passt/pasta (Netz für rootless Container) und conmon. Ein Paket prüft apt selbst: Die Paketlisten sind vom Ubuntu-Archiv signiert, und jedes .deb steht dort mit seiner Prüfsumme.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Begleitcode in die VM

Der Begleitcode liegt öffentlich auf GitHub. Du klonst ihn in der VM nach ~/ct-lab/code:

mkdir -p ~/ct-lab && cd ~/ct-lab
git clone https://github.com/thomaszachmann/container-tools-zum-anfassen.git code
ls code

Erwartet (gekürzt):

Cloning into 'code'...
LICENSE  README.md  anhb  notes  setup  tag01  tag02  tag03  tag04  …

Setup-Dateien und Demo-Anwendung bekommen eigene Kopien, damit du sie verändern kannst, ohne das Original zu verlieren:

cd ~/ct-lab
cp -R code/setup setup && cp -R code/notes notes
ls ~/ct-lab ~/ct-lab/setup
grep -v '^#' setup/env.sh

Erwartet (gekürzt):

/home/ubuntu/ct-lab:
code  notes  setup

/home/ubuntu/ct-lab/setup:
env.sh  tools.lock
export LAB="${LAB:-$HOME/ct-lab}"
export NOTES="$LAB/notes"
export REG_HOST="${REG_HOST:-registry.ct.lab}"
export REG_PORT="${REG_PORT:-5000}"
export REG="$REG_HOST:$REG_PORT"              # eigene Registry ab Tag 7
export REG_USER=lab
export REG_PASS="${REG_PASS:-lab-registry-pw-123}"   # Lab-Wert

env.sh setzt die Variablen, die alle Drills benutzen. $LAB/code bleibt unverändert: Dort holst du dir jeden Morgen den Stand des Vortags ab.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Das Installationsprinzip

Ein Release-Binary installierst du immer in vier Schritten: laden, Prüfsumme prüfen, auspacken, installieren. Am Beispiel crane (Tag 7) aus github.com/google/go-containerregistry:

mkdir -p /tmp/dl && cd /tmp/dl
V=v0.22.1
BASE=https://github.com/google/go-containerregistry/releases/download/$V
curl -fsSLO "$BASE/go-containerregistry_Linux_arm64.tar.gz"
curl -fsSLO "$BASE/checksums.txt"
grep Linux_arm64 checksums.txt
sha256sum -c --ignore-missing checksums.txt

Erwartet:

898c0cff975f…  go-containerregistry_Linux_arm64.tar.gz
go-containerregistry_Linux_arm64.tar.gz: OK
  • -f lässt curl bei HTTP-Fehlern scheitern, statt eine Fehlerseite zu speichern; -L folgt der Weiterleitung von GitHub zum Download-Server.
  • --ignore-missing prüft nur die Dateien aus checksums.txt, die du auch geladen hast.

Dieselbe Prüfsumme steht in tools.lock. Und so sieht es aus, wenn sie nicht passt:

grep '^crane arm64' ~/ct-lab/setup/tools.lock | awk '{print $4}'
echo "$(printf '0%.0s' {1..64})  go-containerregistry_Linux_arm64.tar.gz" \
  | sha256sum -c -; echo "Exit: $?"

Erwartet:

898c0cff975f898a33e8c4580bdafb0e7c02c7faa33374e946762f97c4ab7110
go-containerregistry_Linux_arm64.tar.gz: FAILED
sha256sum: WARNING: 1 computed checksum did NOT match
Exit: 1

Exit-Code 1 – ein Skript bricht hier ab. Erst danach wird ausgepackt und installiert:

tar -tzf go-containerregistry_Linux_arm64.tar.gz
tar -xzf go-containerregistry_Linux_arm64.tar.gz crane krane
sudo install -m 0755 crane krane /usr/local/bin/
crane version && krane version
cd ~ && rm -rf /tmp/dl

Erwartet:

LICENSE
README.md
crane
gcrane
krane
0.22.1
0.22.1

install kopiert, setzt den Modus und ersetzt eine alte Version in einem Schritt. Die Prüfsumme beweist, dass die Datei die ist, die das Projekt veröffentlicht hat – nicht, dass das Projekt vertrauenswürdig ist. Signaturen prüfst du an Tag 14.

Sicherheit: curl … | sudo bash aus einer README überspringt Schritt 2. Im Labor gibt es das nicht.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Alle Werkzeuge installieren

tools.lock hat pro Werkzeug und Architektur eine Zeile: Name, Architektur, URL, SHA-256. Für jede Zeile deiner Architektur machst du die vier Schritte aus Drill 4, in einer Schleife. read zerlegt die Zeile in ihre Felder, exit 1 bricht bei einer falschen Prüfsumme sofort ab. Zuerst die Werkzeuge, die als einzelnes Binary kommen:

A=$(dpkg --print-architecture) && mkdir -p /tmp/dl && cd /tmp/dl
grep -E "^(cosign|ctop|diffoci|hadolint|kind|regctl|regsync) $A " \
  ~/ct-lab/setup/tools.lock | while read -r name _ url sum; do
  curl -fsSLo "$name" "$url"
  echo "$sum  $name" | sha256sum -c || exit 1
  sudo install -m 0755 "$name" /usr/local/bin/
done

Erwartet:

cosign: OK
ctop: OK
diffoci: OK
hadolint: OK
kind: OK
regctl: OK
regsync: OK

Dann die Archive, in denen das Binary so heißt wie das Werkzeug:

grep -E "^(crictl|dive|dockle|grype|ko|lazydocker|oras|syft|trivy) $A " \
  ~/ct-lab/setup/tools.lock | while read -r name _ url sum; do
  curl -fsSLo "$name.tar.gz" "$url"
  echo "$sum  $name.tar.gz" | sha256sum -c || exit 1
  tar -xzf "$name.tar.gz" "$name"
  sudo install -m 0755 "$name" /usr/local/bin/
done

Erwartet (dauert einige Minuten, trivy ist der größte Download):

crictl.tar.gz: OK
dive.tar.gz: OK
dockle.tar.gz: OK
grype.tar.gz: OK
ko.tar.gz: OK
lazydocker.tar.gz: OK
oras.tar.gz: OK
syft.tar.gz: OK
trivy.tar.gz: OK

crane hast du in Drill 4 installiert. Bleibt nerdctl-full, ein Bündel, das komplett nach /usr/local ausgepackt wird:

read -r _ _ url sum < <(grep "^nerdctl-full $A " ~/ct-lab/setup/tools.lock)
curl -fsSLo nerdctl-full.tar.gz "$url"
echo "$sum  nerdctl-full.tar.gz" | sha256sum -c
sudo tar -C /usr/local -xzf nerdctl-full.tar.gz
cd ~ && rm -rf /tmp/dl

Erwartet:

nerdctl-full.tar.gz: OK

nerdctl-full ist ein Bündel: nerdctl, containerd, buildctl/buildkitd, runc und die CNI-Plugins landen unter /usr/local. Gestartet wird davon heute nichts – das kommt an Tag 6.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Gelände prüfen, Versionen notieren

Jeder Tag beginnt ab jetzt mit source ~/ct-lab/setup/env.sh; die Datei setzt nur Variablen. Dann ein Blick auf das Gelände:

source ~/ct-lab/setup/env.sh
podman version --format '{{.Client.Version}}'
ls -d "$NOTES/notes-api"
df -h ~ | tail -1

Erwartet (gekürzt, freier Platz weicht ab):

5.7.0
/home/ubuntu/ct-lab/notes/notes-api
/dev/sda1        38G  6.7G   32G  18% /

Für Tag 13 brauchst du mindestens 8 GB frei (trivy- und grype-Datenbank). Jetzt die Versionen aller installierten Werkzeuge – das ist der Stand, mit dem das Buch getestet wurde:

crane version; echo "$(regctl version --format '{{.VCSTag}}')"
echo "$(regsync version --format '{{.VCSTag}}')"; oras version | head -1
cosign version 2>&1 | grep GitVersion; dive --version; diffoci --version
trivy --version | head -1; grype version | grep '^Version'
syft version | grep '^Version'; dockle --version; hadolint --version
nerdctl --version; containerd --version | cut -d' ' -f1,3
buildctl --version | cut -d' ' -f1,3; crictl --version; ko version
lazydocker --version | head -1; ctop -v; kind version | cut -d' ' -f1,2

Erwartet:

0.22.1
v0.11.7
v0.11.7
Version:        1.3.6
GitVersion:    v3.1.4
dive 0.13.1
diffoci version v0.1.8
Version: 0.76.1
Version:             0.121.0
Version:       1.55.0
dockle version 0.4.15
Haskell Dockerfile Linter 2.15.1
nerdctl version 2.4.2
containerd v2.4.2
buildctl v0.34.1
crictl version v1.37.0
0.19.1
Version: 0.25.2
ctop version 0.7.7, build 11a1cb1 go1.18
kind v0.33.0

Dazu kommen aus Ubuntu Podman 5.7.0, Buildah 1.42.1, Skopeo 1.21.0, crun 1.21 und pasta. Einige Werkzeuge fehlen absichtlich: container-diff baust du an Tag 11 selbst (das Projekt ist archiviert), Docker CE mit docker scout, Buildx und Compose kommt an Tag 13, Colima (Mac) und Scaffdog (im Node-Container) an Tag 15.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Die Demo-Anwendung notes

cd ~/ct-lab/notes
ls -A . notes-api
grep -h '^FROM' notes-*/Dockerfile
grep -h -E '^(EXPOSE|USER)' notes-*/Dockerfile

Erwartet:

.:
.dockerignore  .env.example  .gitignore  .hadolint.yaml  README.md  notes-api  notes-web
notes-worker

notes-api:
.dockerignore  Dockerfile  go.mod  go.sum  main.go  main_test.go  metrics.go  store.go
FROM --platform=$BUILDPLATFORM golang:${GO_VERSION}-alpine AS base
FROM base AS test
FROM base AS build
FROM scratch AS final
FROM node:26-alpine AS build
FROM node:26-alpine AS prod
FROM python:${PYTHON_VERSION}-slim AS build
FROM python:${PYTHON_VERSION}-slim
EXPOSE 8080
USER 65532:65532
USER node
EXPOSE 3000
USER 65532:65532
Dienst Port Wichtige Variablen Besonderheit
notes-api (Go, scratch) 8080 NOTES_API_KEY, NOTES_DB_URL migrate, healthcheck
notes-web (Node) 3000 NOTES_API_URL, NOTES_API_KEY Proxy /api/… auf api
notes-worker (Python) – NOTES_API_URL, INTERVAL fasst Notizen zusammen
Postgres 18.6-alpine 5432 POSTGRES_PASSWORD Volume auf /var/lib/postgresql

Ohne NOTES_DB_URL speichert notes-api im Arbeitsspeicher. Die Dateien heißen Dockerfile; Podman und Buildah lesen sie genauso wie ein Containerfile. Gebaut wird morgen – heute läuft noch kein einziger Container:

podman ps -a && podman images

Erwartet:

CONTAINER ID  IMAGE       COMMAND     CREATED     STATUS      PORTS       NAMES
REPOSITORY  TAG         IMAGE ID    CREATED     SIZE

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

command -v podman buildah skopeo jq htpasswd crane krane regctl regsync oras cosign \
  dive diffoci trivy grype syft dockle hadolint nerdctl containerd buildctl crictl ko \
  lazydocker ctop kind shellcheck | wc -l

Erwartet: alle 27 Werkzeuge im PATH.

27
ls -d ~/ct-lab/code/notes ~/ct-lab/notes/notes-api

Erwartet:

/home/ubuntu/ct-lab/code/notes
/home/ubuntu/ct-lab/notes/notes-api
podman ps -aq | wc -l

Erwartet: noch kein Container.

0

Challenge

Beweise, dass die Schleife aus Drill 5 eine manipulierte Datei ablehnt: Mit einer Kopie von tools.lock, in der die Prüfsumme für crane falsch ist, darf crane nicht ausgepackt werden, und die Schleife muss mit Exit-Code ungleich 0 enden.

Hinweis: sed schreibt die veränderte Kopie, die Schleife liest dann die Kopie statt des Originals.

Lösung

A=$(dpkg --print-architecture) && mkdir -p /tmp/dl && cd /tmp/dl
sed "/^crane $A /s/[0-9a-f]\{64\}\$/$(printf '0%.0s' {1..64})/" \
  ~/ct-lab/setup/tools.lock > tools.lock
grep "^crane $A " tools.lock | while read -r name _ url sum; do
  curl -fsSLo "$name.tar.gz" "$url"
  echo "$sum  $name.tar.gz" | sha256sum -c || exit 1
  tar -xzf "$name.tar.gz" crane krane
done; echo "Exit: $?"
ls
cd ~ && rm -rf /tmp/dl

Erwartet:

crane.tar.gz: FAILED
sha256sum: WARNING: 1 computed checksum did NOT match
Exit: 1
crane.tar.gz  tools.lock

Der Abbruch passiert vor tar und sudo install: Es gibt kein ausgepacktes crane, die installierte Version bleibt unangetastet.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Release-Binaries kommen in Produktion aus einem internen Spiegel (Artifactory, Nexus, eigene Registry mit oras, Tag 9), nicht bei jeder Installation frisch von GitHub.
  • Eine Lock-Datei mit Prüfsummen gehört ins Git und wird per Pull-Request aktualisiert, zum Beispiel von Renovate – mit Review, wer welche Version freigibt.
  • Wo Projekte signieren (cosign, regclient), prüfe zusätzlich die Signatur: Sie belegt die Herkunft, die Prüfsumme nur die Unversehrtheit (Tag 14).
  • Golden Images oder Ansible-Rollen statt Handinstallation: Jede Maschine bekommt dieselben Versionen, und ein Inventar weiß, wo welche Version läuft.
  • Ubuntu-Pakete hinken Upstream hinterher, bekommen aber Sicherheits-Backports. Für Podman auf Servern ist das meist der bessere Tausch als die neueste Version.