Zum Inhalt springen
Trainingslager IT-Trainingslager

Anhang A: Spickzettel

Alle 34 Werkzeuge auf wenigen Seiten: Installation und die Befehle, die du im Buch geübt hast. Die Zahl in Klammern ist der Tag. Variablen wie $REG setzt source ~/ct-lab/setup/env.sh; die Registry heißt registry.ct.lab:5000, Login lab/lab-registry-pw-123. Im Zweifel gilt die Doku des Projekts oder --help auf der VM.

Installation auf einen Blick

Werkzeug Version im Buch Quelle Tag
podman, Quadlet 5.7.0 Ubuntu-Paket podman 1–3
podman-compose 1.5.0 Ubuntu-Paket podman-compose 4
lazydocker, ctop 0.25.2, 0.7.7 (veraltet) Release-Binary 4
buildah 1.42.1 Ubuntu-Paket buildah 5
ko 0.19.1 Release-Binary, dazu golang-go 5
ctr, nerdctl, buildctl v2.4.2, 2.4.2, v0.34.1 Bündel nerdctl-full 6
buildctl, Lima (Mac) 0.34.1, 2.2.1 Homebrew, VM per template://buildkit 6
crane, krane 0.22.1 Release-Binary (go-containerregistry) 7, 10
skopeo 1.21.0 Ubuntu-Paket skopeo 8
regctl, regsync v0.11.7 Release-Binary (regclient) 8, 9
oras 1.3.6 Release-Binary 9
kind, crictl v0.33.0, v1.37.0 Release-Binary 10
dive, diffoci 0.13.1, v0.1.8 Release-Binary 11
container-diff v0.19.0 (archiviert) selbst gebaut (go mod download) 11
hadolint, dockle 2.15.1, 0.4.15 Release-Binary 12
ShellCheck 0.11.0 Ubuntu-Paket shellcheck 12
trivy, grype 0.76.1, 0.121.0 Release-Binary 13
docker scout v1.29.0, Docker CE 29.9.2 Docker-apt-Quelle + CLI-Plugin 13
syft, cosign 1.55.0, v3.1.4 Release-Binary 14
docker, Buildx, Compose 29.9.2, v0.38.1, v5.6.1 Docker-apt-Quelle (Plugins) 13, 15
Colima (Mac), Lima v0.10.3, 2.2.1 Homebrew 15
Scaffdog 4.1.0 npm, per npx in node:26.13.0-alpine 15

Jedes Release-Binary in vier Schritten – laden, Prüfsumme prüfen, auspacken, installieren (0). URL und Prüfsumme stehen in setup/tools.lock:

sudo apt-get install -y podman buildah skopeo jq apache2-utils     # Pakete (0)
arch=$(dpkg --print-architecture)           # ein Binary von Hand (0, 7, 8)
read -r _ _ url sum < <(grep "^regctl $arch " "$LAB/setup/tools.lock")
curl -fsSLo /tmp/regctl "$url"
echo "$sum  /tmp/regctl" | sha256sum -c -
sudo install -m 0755 /tmp/regctl /usr/local/bin/regctl && rm /tmp/regctl
sha256sum -c --ignore-missing checksums.txt # gegen die Datei des Projekts (0, 4)

Podman und systemd (Tag 1–4)

podman

podman pull docker.io/library/nginx:1.30.6-alpine   # immer vollqualifiziert (1)
podman run -d --name web -p 127.0.0.1:8080:80 docker.io/library/nginx:1.30.6-alpine
podman ps --format '{{.Names}}\t{{.Status}}\t{{.Ports}}'
podman logs --tail 1 web
podman top web user huser pid hpid args         # UID im Container und auf dem Host (1)
podman build --format docker -t localhost/notes-api:0.1.0 \
  --build-arg VERSION=0.1.0 notes-api           # Docker-Format behält HEALTHCHECK (1)
podman image inspect localhost/notes-api:0.1.0 \
  --format '{{.Config.Healthcheck.Test}} {{.ManifestType}}'
podman healthcheck run notes-api && echo "gesund"
podman save localhost/notes-api:0.1.0 | sudo podman load      # rootless → rootful (1)
podman info --format '{{.Store.GraphRoot}}'
podman image prune -f                           # nur namenlose Images des Users (1)

Rootless im Detail, Pods und Kubernetes-YAML (2):

podman unshare cat /proc/self/uid_map           # 0 → 1000, 1 → 100000 … (2)
podman run -d --name pg-bind --user 70:70 -e POSTGRES_PASSWORD=lab-db-pw-123 \
  -v ./pgdata-bind:/var/lib/postgresql:U docker.io/library/postgres:18.6-alpine
podman unshare rm -rf pgdata-bind               # fremde UIDs löschen (2)
podman pod create --name notes -p 127.0.0.1:8080:8080 -p 127.0.0.1:3000:3000
podman run -d --pod notes --name notes-db … docker.io/library/postgres:18.6-alpine
podman kube generate notes -f notes-pod.yaml
podman kube play --replace notes-pod.yaml
podman kube down notes-pod.yaml                 # Volumes bleiben (ohne --force)

Beobachten (4):

podman stats --no-stream --format 'table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}'
podman pod stats --no-stream --format '{{.Pod}} {{.Name}} {{.MemUsage}}'
podman events --since 30s --until 1s --filter container=notes-api \
  --format '{{.Status}} {{.Name}}'

Quadlet

Units in ~/.config/containers/systemd/, nach jeder Änderung daemon-reload (3):

# ~/.config/containers/systemd/notes-api.container – Muster (3)
[Unit]
Requires=notes-migrate.container
After=notes-migrate.container

[Container]
ContainerName=notes-api
Image=localhost/notes-api:0.1.0
Pod=notes.pod
Environment=NOTES_API_KEY=lab-api-key-123
Notify=healthy
AutoUpdate=local

[Service]
Restart=on-failure
/usr/libexec/podman/quadlet -dryrun -user       # erzeugte Units, Tippfehler (3, 16)
QUADLET_UNIT_DIRS=/tmp/qtest /usr/libexec/podman/quadlet -dryrun -user
systemctl --user daemon-reload
systemctl --user start notes-pod.service        # nicht enable: Units sind generiert
systemctl --user list-units 'notes*' --all --no-pager
journalctl --user -u notes-api.service --no-pager -o cat
sudo loginctl enable-linger "$USER"             # Dienste ohne Anmeldung (3)
podman auto-update --dry-run
systemctl --user enable --now podman-auto-update.timer

Podman-Socket und podman-compose

systemctl --user enable --now podman.socket     # Docker-API 1.41 (4)
S="$XDG_RUNTIME_DIR/podman/podman.sock"
curl -s --unix-socket "$S" http://d/_ping; echo
export DOCKER_HOST="unix://$XDG_RUNTIME_DIR/podman/podman.sock"   # in ~/.bashrc
podman --remote ps --format '{{.Names}}'
sudo apt-get install -y podman-compose          # Provider für podman compose (4)
podman compose up -d
podman compose logs worker | tail -1
podman compose down

lazydocker

lazydocker                                      # liest DOCKER_HOST (4)
lazydocker -c | grep -E '^commandTemplates:|dockerCompose:'   # Standardwerte

In ~/.config/lazydocker/config.yml: commandTemplates: → dockerCompose: podman compose. Tasten: 1…6 Panels, [ ] Reiter (Logs, Stats …), x Menü, q Ende.

ctop

ctop -v && ctop                                 # seit 2022 ohne Release – veraltet (4)

Bauen (Tag 5–6)

buildah

sudo apt-get install -y buildah
buildah build --format docker -t localhost/notes-api:0.2.0 \
  --build-arg VERSION=0.2.0 notes-api           # ohne --layers: ein Layer (5)
buildah build -q --format docker --timestamp 0 …   # reproduzierbare Image-ID (5)
b=$(buildah from --name api-build docker.io/library/golang:1.27-alpine)
buildah copy "$b" notes-api /src
buildah run --workingdir /src -e CGO_ENABLED=0 "$b" -- \
  go build -trimpath -ldflags="-s -w -X main.version=0.2.0" -o /out/notes-api .
f=$(buildah from --format docker --name api-final scratch)
buildah copy --from "$b" --chmod 555 "$f" /out/notes-api /notes-api
buildah config --user 65532:65532 --entrypoint '["/notes-api"]' \
  --healthcheck 'CMD /notes-api healthcheck' "$f"
buildah commit --format docker --rm "$f" localhost/notes-api:0.2.0-buildah
buildah rm "$b" && buildah containers
buildah unshare sh -c '
  m=$(buildah mount api-final); ls -ln "$m"; buildah umount api-final'
buildah push localhost/notes-api:0.2.0 oci:./out:notes-api     # OCI: Healthcheck weg
buildah push localhost/notes-api:0.2.0 \
  docker-archive:./out/notes-api.tar:localhost/notes-api:0.2.0

ko

sudo apt-get install -y golang-go
ko build --push=false .                         # ohne KO_DOCKER_REPO nur bauen (5)
ko build --local .                              # über DOCKER_HOST nach ko.local/…
export VERSION=0.2.0                            # für {{.Env.VERSION}} in .ko.yaml
KO_DOCKER_REPO=ko.local/notes-api ko build --bare -t 0.2.0 --sbom-dir ../out/sbom .
KO_DOCKER_REPO=localhost/notes-api ko build --bare -t 0.2.0-ko --push=false \
  --tarball ../out/ko.tar .
podman load -i ../out/ko.tar
podman run -d --name api-ko --health-cmd '["/ko-app/notes-api", "healthcheck"]' …

ctr

sudo systemctl daemon-reload && sudo systemctl enable --now containerd
sudo ctr ns ls
sudo ctr images pull docker.io/library/nginx:1.30.6-alpine   # keine Short-Names
sudo ctr run -d docker.io/library/nginx:1.30.6-alpine web
sudo ctr tasks ls
sudo ctr tasks exec --exec-id e1 web nginx -v
sudo ctr tasks kill web && sudo ctr tasks rm web && sudo ctr containers rm web
podman save localhost/notes-api:0.2.0 | sudo ctr images import -   # Podman → containerd

nerdctl

sudo nerdctl run -d --name web -p 127.0.0.1:8081:80 \
  docker.io/library/nginx:1.30.6-alpine
sudo nerdctl ps && sudo nerdctl images
sudo nerdctl network ls
sudo nerdctl compose -f compose.yaml -f compose.nerdctl.yaml up -d db   # erst db (6)
sudo nerdctl compose -f compose.yaml -f compose.nerdctl.yaml up -d
sudo nerdctl build -t localhost/notes-api:0.2.0 --build-arg VERSION=0.2.0 notes-api
sudo systemctl disable --now containerd buildkit

buildctl

sudo systemctl enable --now buildkit
sudo buildctl debug workers -v
sudo buildctl build --frontend dockerfile.v0 \
  --local context=notes-api --local dockerfile=notes-api \
  --opt build-arg:VERSION=0.2.0 \
  --output type=oci,dest=out/notes-api-oci.tar,name=localhost/notes-api:0.2.0-buildctl \
  --export-cache type=local,dest=out/buildcache
sudo buildctl build … --import-cache type=local,src=out/buildcache
sudo buildctl build … --output type=docker,name=localhost/notes-api:0.3.0,dest=- \
  | sudo ctr images import -
sudo buildctl prune --all

BuildKit eigenständig mit Lima (Mac)

brew install buildkit lima                       # buildctl auf dem Mac (6)
limactl start --name=buildkit --cpus=2 --memory=2 --disk=20 template://buildkit
export BUILDKIT_HOST="unix://$HOME/.lima/buildkit/sock/buildkitd.sock"   # ~/.zshrc
buildctl debug workers
buildctl build --frontend dockerfile.v0 --local context=. --local dockerfile=. \
  --output type=oci,dest=myapp.tar,name=localhost/myapp:0.1.0
buildctl build … --output "type=image,name=$REG/lab/myapp:0.1.0,push=true"   # ab 7
limactl stop buildkit; limactl list; limactl start buildkit

BuildKit baut nur: kein images, kein run. Ausführen per podman load -i myapp.tar.

Registry und Images bewegen (Tag 7–10)

Eigene Registry

./run-registry.sh [kind]                        # Registry neu starten (7, 10)
curl -sS -u "$REG_USER:$REG_PASS" "https://$REG/v2/_catalog"; echo
curl -sS -u "$REG_USER:$REG_PASS" "https://$REG/v2/notes/notes-api/tags/list"; echo
podman exec registry registry garbage-collect --dry-run /etc/distribution/config.yml
Werkzeug schreibt Login nach liest außerdem
podman, buildah, skopeo $XDG_RUNTIME_DIR/containers/auth.json ~/.docker/config.json
crane, krane ~/.docker/config.json Podman-auth.json
regctl ~/.regctl/config.json ~/.docker/config.json
oras, cosign ~/.docker/config.json –

Mit gesetztem DOCKER_CONFIG lesen und schreiben crane und oras dort statt in ~/.docker; auch podman login schreibt dann dorthin, solange REGISTRY_AUTH_FILE nicht gesetzt ist (16).

crane

echo "$REG_PASS" | crane auth login "$REG" -u "$REG_USER" --password-stdin
crane catalog "$REG"
crane ls docker.io/library/nginx | grep '^1\.30\.6-alpine'
crane digest docker.io/library/nginx:1.30.6-alpine              # HEAD: zählt nicht
crane digest --platform linux/arm64 docker.io/library/nginx:1.30.6-alpine
crane manifest "$REG/library/nginx:1.30.6-alpine" | jq -r .mediaType
crane config --platform linux/arm64 "$REG/library/nginx:1.30.6-alpine" | jq .config
crane copy docker.io/library/nginx:1.30.6-alpine "$REG/library/nginx:1.30.6-alpine"
crane tag "$REG/lab/notes-api:oci" stabil
crane delete "$REG/lab/notes-api@$(crane digest "$REG/lab/notes-api:oci")"
crane mutate "$REG/lab/notes-api:0.1.0" --label lab.tag=07 -t "$REG/lab/notes-api:mut"
crane append -b "$REG/lab/notes-api:0.1.0" -f extra.tar -t "$REG/lab/notes-api:extra"
crane export "$REG/lab/notes-api:extra" - | tar -t
crane validate --remote "$REG/lab/notes-api:extra"
echo "$REG" | crane auth get; echo

skopeo

skopeo inspect "docker://$REG/library/nginx:1.30.6-alpine" | jq '{Digest, Architecture}'
skopeo inspect --config --raw "docker://$REG/notes/notes-api:0.1.0" \
  | jq -c .config.Healthcheck.Test              # --raw: Original-Config (8)
skopeo copy -q --all --preserve-digests "docker://$REG/library/nginx:1.30.6-alpine" \
  "docker://$REG/mirror/nginx:1.30.6-alpine-all"    # echter Spiegel
skopeo copy -q "docker://$REG/notes/notes-api:0.1.0" oci:api-oci:0.1.0
podman unshare skopeo copy -q dir:api-dir \
  containers-storage:localhost/notes-api:von-dir    # rootless nur so (8)
skopeo sync --src docker --dest dir --scoped "$REG/notes/notes-api" backup/
skopeo list-tags "docker://$REG/notes/notes-api" | jq -c .Tags
skopeo delete "docker://$REG/backup/notes-web:0.1.0"
skopeo --policy policy-lab.json copy -q "docker://$REG/notes/notes-api:0.1.0" dir:p1

Transports: docker:// (Registry), dir:, oci:pfad:tag, docker-archive:datei, containers-storage: (Podman-Speicher).

regctl

echo "$REG_PASS" | regctl registry login "$REG" -u "$REG_USER" --pass-stdin
regctl registry whoami "$REG"                   # kennt nur ~/.regctl/config.json
regctl tag ls --include '1\.30\.6-alpine.*' docker.io/library/nginx
regctl image ratelimit docker.io/library/nginx:1.30.6-alpine
regctl manifest head "$REG/library/nginx:1.30.6-alpine"
regctl manifest get "$REG/notes/notes-api:0.1.0" --format raw-body | jq -r .mediaType
regctl image digest --platform linux/arm64 "$REG/library/nginx:1.30.6-alpine"
regctl image copy "$REG/notes/notes-api:0.1.0" "$REG/lab/notes-api:rc"
regctl image mod "$REG/lab/notes-api:rc" --to-oci --label lab.tag=08 \
  --create 0.1.0-oci08                          # Healthcheck bleibt (8)
regctl image get-file "$REG/notes/notes-api:0.1.0" /etc/ssl/certs/ca-certificates.crt
regctl image export "$REG/notes/notes-api:0.1.0" api-regctl.tar
regctl tag rm "$REG/lab/notes-api:rc"           # nur der Tag
regctl repo ls "$REG"
regctl artifact list "$REG/release/notes-api:0.1.0"

regsync

regsync config -c regsync.yml                   # zeigt Passwörter im Klartext!
regsync check -c regsync.yml
regsync once -c regsync.yml
regsync once --missing -c regsync.yml
timeout 15 regsync server -c regsync.yml
systemd-analyze verify --user systemd/regsync.service systemd/regsync.timer
# regsync.yml – Muster (9)
version: 1
creds:
  - registry: '{{ env "REG" }}'
    user: '{{ env "REG_USER" }}'
    pass: '{{ env "REG_PASS" }}'
defaults:
  ratelimit: {min: 20, retry: 15m}
sync:
  - source: docker.io/library/postgres
    target: '{{ env "REG" }}/mirror/postgres'
    type: repository
    platform: linux/arm64
    tags:
      allow: ['18\.6-alpine']

oras

echo "$REG_PASS" | oras login -u "$REG_USER" --password-stdin "$REG"
oras repo ls "$REG" && oras repo tags "$REG/notes/notes-api"
oras push "$REG/lab/regsync-config:tag09" \
  --artifact-type application/vnd.ct-lab.config regsync.yml:application/yaml
oras pull -o /tmp/zurueck "$REG/lab/regsync-config:tag09"
oras manifest fetch "$REG/charts/notes:0.1.0" | jq .
oras attach --artifact-type application/spdx+json "$REG/notes/notes-api:0.1.0" \
  notes-api.spdx.json:application/spdx+json
oras discover "$REG/notes/notes-api:0.1.0"
oras discover --artifact-type text/markdown "$REG/notes/notes-web:0.1.0"
oras cp -r "$REG/notes/notes-api:0.1.0" "$REG/release/notes-api:0.1.0"   # mit Referrern
oras manifest delete --force "$REG/notes/notes-api@$S"

kind

export KIND_EXPERIMENTAL_PROVIDER=podman
CONTAINERS_CONF_OVERRIDE=$PWD/kind/containers-kind.conf \
  kind create cluster --config kind/kind-ct-lab.yaml        # rootless (10)
N=ct-lab-control-plane
podman exec $N kubectl get pods -A                         # kubectl im Node (10)
podman save -q -o api-020.tar localhost/notes-api:0.2.0
kind load image-archive api-020.tar --name ct-lab
kind delete cluster --name ct-lab

crictl

podman cp /usr/local/bin/crictl ct-lab-control-plane:/usr/local/bin/crictl
N=ct-lab-control-plane
podman exec $N crictl pods                                    # crictl im Node (10)
podman exec $N crictl ps
podman exec $N crictl images
CID=$(podman exec $N crictl ps --name notes-api -q)
podman exec $N crictl inspect "$CID" | jq -r .status.imageRef
podman exec $N crictl logs --tail 1 "$CID"
podman exec $N crictl exec "$CID" /notes-api healthcheck
podman exec $N crictl pull --creds lab:lab-registry-pw-123 \
  registry.ct.lab:5000/notes/notes-web:0.1.0
podman exec $N crictl rmi registry.ct.lab:5000/notes/notes-web:0.1.0

krane

krane version && krane ls "$REG/notes/notes-api"   # crane + Cloud-Keychains (10)
DOCKER_CONFIG=/tmp/leer env -u XDG_RUNTIME_DIR krane ls "$REG/notes/notes-api"

krane liest Docker-Config, Google, GitHub, ECR, ACR – keine kubeconfig, keine Pull-Secrets. Ein Pull-Secret ist eine Docker-Config: als Datei mounten, DOCKER_CONFIG darauf zeigen lassen.

Prüfen und absichern (Tag 11–14)

dive

dive docker.io/library/nginx:1.30.6-alpine          # Oberfläche über DOCKER_HOST
CI=true dive podman://docker.io/library/nginx:1.30.6-alpine     # ruft podman save
dive --ci --source podman localhost/notes-api:schlecht   # Regeln aus .dive-ci (11)
dive --source podman localhost/notes-api:schlecht -j dive.json
dive --ci docker-archive://nginx.tar
# .dive-ci – Muster (11)
rules:
  lowestEfficiency: 0.98
  highestWastedBytes: 10MB
  highestUserWastedPercent: 0.05

diffoci

diffoci diff --semantic podman://localhost/notes-api:0.1.0 \
  podman://localhost/notes-api:0.2.0            # Exit 1 bei Unterschieden (11)
diffoci diff --semantic --verbose podman://… podman://…
diffoci diff --semantic podman://localhost/notes-api:0.1.0 "$REG/notes/notes-api:0.1.0"

container-diff

Archiviert, nur zum Vergleich mit diffoci (11):

podman run --rm -v "$PWD/bin:/out:Z" -e CGO_ENABLED=0 \
  docker.io/library/golang:1.27-alpine sh -c '
  m=github.com/GoogleContainerTools/[email protected]
  cd "$(go mod download -json "$m" | sed -n "s/.*\"Dir\": \"\(.*\)\",/\1/p")"
  go build -o /out/container-diff .'
./bin/container-diff diff api-010.tar api-020.tar --type=file --type=size

hadolint

hadolint --no-color notes-api/Dockerfile        # liest .hadolint.yaml im Ordner (12)
hadolint -t error notes-api/Containerfile.lint
hadolint --no-fail notes-api/Containerfile.lint
hadolint --disable-ignore-pragma notes-api/Containerfile.lint
hadolint -f sarif notes-api/Containerfile.lint -o lint.sarif

Ausnahmen: # hadolint ignore=DL3008 über der Zeile, --ignore DL3059 für einen Lauf, ignored:, override: und trustedRegistries: in .hadolint.yaml.

dockle

export DOCKLE_HOST="unix://$XDG_RUNTIME_DIR/podman/podman.sock"   # nicht DOCKER_HOST
dockle --no-color -c 1 localhost/notes-worker:0.1.0     # .dockleignore im Ordner (12)
dockle --no-color --accept-key KEY_SHA512 --exit-code 1 \
  docker.io/library/nginx:1.30.6-alpine
dockle --no-color --input api.tar               # Archiv aus podman save
dockle -f json localhost/notes-api:0.1.0 | jq -c '.summary'

ShellCheck

sudo apt-get install -y shellcheck
shellcheck push-alle.sh                          # Befunde mit SC-Code, Vorschlag (12)
shellcheck -x push-alle.sh                       # source-Dateien mitprüfen
shellcheck -S warning -f gcc tag12/*.sh          # nur Warnungen, Format für Editor/CI
shellcheck -f json1 push-alle.sh | jq -c '.comments[] | [.line, .code]'

Ausnahmen: # shellcheck disable=SC2086 über der Zeile, # shellcheck source=datei für source, source-path=SCRIPTDIR und external-sources=true in .shellcheckrc.

trivy

trivy image -q --scanners vuln --severity HIGH,CRITICAL --ignore-unfixed \
  --exit-code 1 localhost/notes-api:0.1.0       # Gate, liest .trivyignore (13)
trivy image -q --scanners vuln --show-suppressed localhost/notes-api:0.1.0
trivy image -q --scanners vuln --ignorefile '' localhost/notes-api:0.1.1
trivy image -q --scanners secret --exit-code 1 localhost/notes-api:schlecht
trivy fs -q --scanners vuln --table-mode summary .
trivy config -q notes-api/Containerfile.besser
trivy sbom -q --table-mode summary nginx.cdx.json
trivy image -q --skip-db-update … && trivy clean --vuln-db
# .trivyignore – Muster (13): jede Ausnahme mit Grund und Ablauf
CVE-2026-56851 exp:2026-12-31

grype

grype db update        # ca. 4–5 min, 3,2 GB (13)
grype -q podman:docker.io/library/nginx:1.30.6-alpine
grype -q "registry:$REG/notes/notes-api:0.1.0" --only-fixed --by-cve
grype -q podman:localhost/notes-api:0.1.0 --only-fixed --fail-on high   # Exit 2
grype -q sbom:nginx.cdx.json --only-fixed --fail-on critical
grype db status

docker scout

Braucht Docker CE und ein Docker-Konto; sieht nur Dockers Speicher (13):

docker scout quickview docker.io/library/nginx:1.30.6-alpine
docker scout cves --only-severity critical,high --only-fixed --exit-code \
  docker.io/library/nginx:1.30.6-alpine
syft -q podman:docker.io/library/nginx:1.30.6-alpine -o spdx-json \
  | docker scout cves sbom://
docker scout recommendations docker.io/library/nginx:1.30.6-alpine

syft

syft -q podman:localhost/notes-api:0.1.0        # Tabelle, Go-Module aus dem Binary
syft -q dir:. -o purls
syft -q "registry:$REG/notes/notes-api:0.1.0" -o syft-json=api.syft.json \
  -o cyclonedx-json=api.cdx.json -o spdx-json=api.spdx.json      # drei Formate (14)
syft convert api.syft.json -o cyclonedx-json=konvertiert.cdx.json

cosign

export COSIGN_PASSWORD=lab-cosign-pw-123
cosign generate-key-pair                        # in ~/ct-lab/keys, nie ins Repo (14)
cosign signing-config create --out lab-signing-config.json   # ohne Rekor/TSA
img="$REG/notes/notes-api@$(crane digest "$REG/notes/notes-api:0.1.0")"   # Digest!
cosign sign --key ~/ct-lab/keys/cosign.key --signing-config lab-signing-config.json \
  --yes -a version=0.1.0 "$img"
cosign verify --key ~/ct-lab/keys/cosign.pub --insecure-ignore-tlog=true "$img"
cosign attest --key ~/ct-lab/keys/cosign.key --signing-config lab-signing-config.json \
  --yes --type cyclonedx --predicate api.cdx.json "$img"
cosign verify-attestation --key ~/ct-lab/keys/cosign.pub \
  --insecure-ignore-tlog=true --type cyclonedx "$img"
cosign tree "$img"
cosign download attestation "$img"              # prüft nichts
cosign verify … --registry-cacert "$LAB/registry/certs/ca.crt" "$img"

Docker-Werkzeuge (Tag 15)

docker und Kontexte

docker context create podman --docker "host=unix://$XDG_RUNTIME_DIR/podman/podman.sock"
docker context ls                               # DOCKER_HOST überstimmt jeden Kontext
unset DOCKER_HOST                               # danach gilt der aktive Kontext (15)
docker --context podman ps                      # pro Befehl
docker context use podman                       # dauerhaft
docker version --format '{{.Client.Version}} / {{.Server.Version}}'
docker build -q -t ct-lab/notes-api:0.1.0 notes-api
docker ps --format '{{.Names}}\t{{.Status}}'
docker stats --no-stream; docker system df

Buildx und Bake

docker buildx ls
docker buildx create --name ct-lab --driver docker-container \
  --driver-opt image=docker.io/moby/buildkit:v0.34.1 --driver-opt network=host \
  --buildkitd-config buildkitd.toml --bootstrap    # CA der Registry in der TOML (15)
echo "$REG_PASS" | docker login "$REG" -u "$REG_USER" --password-stdin
docker buildx build --builder ct-lab --platform linux/amd64,linux/arm64 \
  -t "$REG/lab/notes-api:0.1.0" --push notes-api
docker buildx imagetools inspect "$REG/lab/notes-api:0.1.0"
docker buildx bake --print                      # aufgelöste Bake-Datei
docker buildx bake --builder ct-lab --push      # Gruppe default
VERSION=0.2.0 docker buildx bake --builder ct-lab --push report   # ein Target

Docker Compose

docker compose up -d --build --wait             # bauen, starten, Healthchecks (15)
docker compose ps --format '{{.Service}}\t{{.Status}}'
docker compose logs api; docker compose exec api /notes-api healthcheck
docker compose down                             # -v löscht auch die Volumes

Colima (Mac)

brew install colima docker docker-buildx docker-compose
colima start --cpu 2 --memory 4 --disk 40 --vm-type vz --vz-rosetta   # (15)
colima status; colima list; colima ssh
colima stop; colima delete                      # VM samt Images löschen
docker context use default                      # zurück zu einem anderen Kontext

Plugins aus Homebrew findet das CLI über "cliPluginsExtraDirs" in ~/.docker/config.json ($(brew --prefix)/lib/docker/cli-plugins).

Scaffdog

docker run --rm -u "$(id -u):$(id -g)" -e HOME=/tmp \
  -v "$PWD":/work -w /work \
  docker.io/library/node:26.13.0-alpine npx --yes [email protected] list   # (15)
# statt list: generate go-dienst -a name:notes-report -a port:8097 [--dry-run|--force]

Fallen auf Ubuntu 26.04

Alle im Labor aufgetreten und im jeweiligen Kapitel gezeigt.

AppArmor

  • pasta beim Netz-Entfernen (2, 4): Entfernst du rootless den letzten Container eines eigenen Netzes (auch kube down, docker compose down), meldet Podman rootless netns: kill network process: permission denied – das Profil pasta verweigert das Signal von Podman. Die Objekte sind trotzdem weg; Docker Compose braucht ein zweites down.
  • nerdctl-default, docker-default und gosu (6, 15): Unter nerdctl und Docker CE hängt Postgres mit voller CPU – die Profile nerdctl-default und docker-default verbieten gosu (und Postgres selbst) Signale an die eigenen Threads und Prozesse (journalctl -k | grep DENIED). Labor-Lösung: security_opt: [apparmor=unconfined] für db in compose.nerdctl.yaml bzw. compose.yaml (Tag 15); in Produktion ein eigenes Profil oder ein Image ohne gosu.
  • skopeo und containers-storage: (8, 16): kernel.apparmor_restrict_unprivileged_userns = 1 erlaubt User Namespaces nur Programmen mit Profil; podman und buildah haben eins, skopeo nicht → Error during unshare(...): Operation not permitted. Abhilfe: podman unshare skopeo copy … oder podman save.
  • Rootless containerd (6): containerd-rootless-setuptool.sh check scheitert, weil /usr/local/bin/rootlesskit kein Profil hat. Im Buch bleibt containerd rootful.

Namen und Formate

  • Short-Names (1, 16): registries.conf hat keine unqualified-search-registries, shortnames.conf kennt nginx und postgres nicht. Ein Short-Name passt nur auf Images, die schon lokal liegen – auf einem frischen Rechner scheitert derselbe Build. Immer docker.io/library/… schreiben.
  • HEALTHCHECK verschwindet (1, 5, 8, 12, 16): Podman und Buildah bauen ohne --format docker OCI und warnen nur. Auch buildah push … oci:, skopeo copy --format oci und ko verlieren ihn; regctl image mod --to-oci nicht.
  • ctr kennt keine Short-Names (6): nginx:1.30.6-alpine wird zu parse "dummy://nginx…": invalid port.

Pakete und Dienste

  • docker-compose-v2 aus apt (4): zieht docker.io und containerd nach – nicht installieren, podman-compose oder das Docker-Compose-Binary nehmen.
  • Ports nach dem Stoppen (4): Nach systemctl --user stop notes-pod.service gut 3 s warten, sonst internal libpod error beim nächsten Stack auf denselben Ports.
  • Ports unter 1024 (2, 16): rootless Listen failed … Permission denied (net.ipv4.ip_unprivileged_port_start = 1024); als Quadlet-Dienst steht die Meldung nur im Journal der Unit.
  • buildkitd (6): endet beim Stoppen mit Exit 1, systemctl is-active buildkit zeigt failed – sudo systemctl reset-failed buildkit.
  • Go in Ubuntu (5): golang-go ist 1.26, notes-api verlangt 1.27 – GOTOOLCHAIN=auto lädt die passende Toolchain nach ~/go/pkg/mod.

Logins, TLS, Registry

  • Podman-Login im RAM (7): $XDG_RUNTIME_DIR/containers/auth.json ist nach einem Neustart weg. regctl und oras lesen ihn nie (Tabelle oben).
  • Zertifikat ohne SAN (7, 16): curl akzeptiert den CN, alle Go-Werkzeuge nicht: x509: certificate relies on legacy Common Name field. Zertifikat mit subjectAltName ausstellen.
  • Registry 3.1.2 ohne Referrers-API (9, 14): oras und cosign legen den Tag sha256-<digest> an; beim Kopieren mitnehmen (oras cp -r).
  • cosign v3 (14): --tlog-upload=false geht nicht mehr – leere Signing-Config und beim Prüfen --insecure-ignore-tlog=true.
  • Docker Hub (7): anonym 100 Pulls pro Stunde und IP; HEAD (crane digest, regctl image digest) zählt nicht.

Werkzeug-Eigenheiten

  • dockle (12): ignoriert DOCKER_HOST und hält localhost/… für eine Registry – DOCKLE_HOST setzen oder --input mit Archiv.
  • grype (13): lokale Podman-Images nur mit Präfix podman: und laufendem Podman-Socket.
  • kind (10): kind load docker-image findet localhost/-Images von Podman nicht (→ image-archive); der Node erbt /etc/hosts der VM (→ base_hosts_file = "none" per CONTAINERS_CONF_OVERRIDE).
  • dive (11): gelöschte Ordner zählen nicht als Verschwendung – Layer-Größen zusätzlich ansehen.
  • hadolint (12): -t none lieferte trotzdem Exit 1 – --no-fail nehmen.
  • Quadlet (3, 16): Tippfehler lassen die Unit still verschwinden (Unit … not found); nur der Dryrun nennt die Zeile. Generierte Units sind nicht enable-bar.