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.timerPodman-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 downlazydocker
lazydocker # liest DOCKER_HOST (4)
lazydocker -c | grep -E '^commandTemplates:|dockerCompose:' # StandardwerteIn ~/.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.0ko
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 → containerdnerdctl
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 buildkitbuildctl
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 --allBuildKit 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 buildkitBuildKit 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; echoskopeo
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:p1Transports: 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-labcrictl
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.0krane
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.05diffoci
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=sizehadolint
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.sarifAusnahmen: # 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 statusdocker 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-alpinesyft
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.jsoncosign
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 dfBuildx 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 TargetDocker 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 VolumesColima (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 KontextPlugins 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 Podmanrootless netns: kill network process: permission denied– das Profilpastaverweigert das Signal von Podman. Die Objekte sind trotzdem weg; Docker Compose braucht ein zweitesdown. - nerdctl-default, docker-default und gosu (6, 15):
Unter
nerdctlund Docker CE hängt Postgres mit voller CPU – die Profilenerdctl-defaultunddocker-defaultverbietengosu(und Postgres selbst) Signale an die eigenen Threads und Prozesse (journalctl -k | grep DENIED). Labor-Lösung:security_opt: [apparmor=unconfined]fürdbincompose.nerdctl.yamlbzw.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 = 1erlaubt User Namespaces nur Programmen mit Profil; podman und buildah haben eins, skopeo nicht →Error during unshare(...): Operation not permitted. Abhilfe:podman unshare skopeo copy …oderpodman save. - Rootless containerd (6):
containerd-rootless-setuptool.sh checkscheitert, weil/usr/local/bin/rootlesskitkein Profil hat. Im Buch bleibt containerd rootful.
Namen und Formate
- Short-Names (1, 16):
registries.confhat keineunqualified-search-registries,shortnames.confkenntnginxundpostgresnicht. Ein Short-Name passt nur auf Images, die schon lokal liegen – auf einem frischen Rechner scheitert derselbe Build. Immerdocker.io/library/…schreiben. - HEALTHCHECK verschwindet (1, 5, 8, 12, 16): Podman
und Buildah bauen ohne
--format dockerOCI und warnen nur. Auchbuildah push … oci:,skopeo copy --format ociund ko verlieren ihn;regctl image mod --to-ocinicht. - ctr kennt keine Short-Names (6):
nginx:1.30.6-alpinewird zuparse "dummy://nginx…": invalid port.
Pakete und Dienste
- docker-compose-v2 aus apt (4): zieht
docker.ioundcontainerdnach – nicht installieren, podman-compose oder das Docker-Compose-Binary nehmen. - Ports nach dem Stoppen (4): Nach
systemctl --user stop notes-pod.servicegut 3 s warten, sonstinternal libpod errorbeim 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 buildkitzeigtfailed–sudo systemctl reset-failed buildkit. - Go in Ubuntu (5):
golang-goist 1.26, notes-api verlangt 1.27 –GOTOOLCHAIN=autolädt die passende Toolchain nach~/go/pkg/mod.
Logins, TLS, Registry
- Podman-Login im RAM (7):
$XDG_RUNTIME_DIR/containers/auth.jsonist 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 mitsubjectAltNameausstellen. - 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=falsegeht 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_HOSTund hältlocalhost/…für eine Registry –DOCKLE_HOSTsetzen oder--inputmit Archiv. - grype (13): lokale Podman-Images nur mit Präfix
podman:und laufendem Podman-Socket. - kind (10):
kind load docker-imagefindetlocalhost/-Images von Podman nicht (→image-archive); der Node erbt/etc/hostsder VM (→base_hosts_file = "none"perCONTAINERS_CONF_OVERRIDE). - dive (11): gelöschte Ordner zählen nicht als Verschwendung – Layer-Größen zusätzlich ansehen.
- hadolint (12):
-t nonelieferte trotzdem Exit 1 –--no-failnehmen. - Quadlet (3, 16): Tippfehler lassen die Unit still
verschwinden (
Unit … not found); nur der Dryrun nennt die Zeile. Generierte Units sind nichtenable-bar.