Tag 0: Das Trainingsgelände
Ziel: Die Labor-VM anlegen, alle Werkzeuge nach einem festen Prinzip installieren und prüfen und die Demo-Anwendung
noteskennenlernen. · Dauer: ca. 60 min · Voraussetzung: keine
Briefing
- Gearbeitet wird in einer Ubuntu-26.04-VM
ct-lab, als Userubuntuin~/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.lockpinnt 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-labAb hier läuft alles in der VM:
grep -E '^(PRETTY_NAME|VERSION_ID)' /etc/os-release
uname -m
nproc && free -h | head -2Erwartet (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 2pErwartet (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 codeErwartet (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.shErwartet (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.txtErwartet:
898c0cff975f… go-containerregistry_Linux_arm64.tar.gz
go-containerregistry_Linux_arm64.tar.gz: OK
-flässt curl bei HTTP-Fehlern scheitern, statt eine Fehlerseite zu speichern;-Lfolgt der Weiterleitung von GitHub zum Download-Server.--ignore-missingprüft nur die Dateien auschecksums.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/dlErwartet:
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 bashaus 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/
doneErwartet:
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/
doneErwartet (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/dlErwartet:
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 -1Erwartet (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,2Erwartet:
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-*/DockerfileErwartet:
.:
.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 imagesErwartet:
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 -lErwartet: alle 27 Werkzeuge im PATH.
27
ls -d ~/ct-lab/code/notes ~/ct-lab/notes/notes-apiErwartet:
/home/ubuntu/ct-lab/code/notes
/home/ubuntu/ct-lab/notes/notes-api
podman ps -aq | wc -lErwartet: 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/dlErwartet:
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.