Tag 2: Container-Images
Ziel: Du schreibst ein Dockerfile, baust, taggst, änderst, exportierst und pushst ein Image und startest es im Cluster. · Dauer: ca. 60 min · Voraussetzung: Tag 1
Briefing
CKAD: Application Design and Build (20 %) – „Define, build and modify container images”. In der Prüfung liegt meist ein Dockerfile bereit; du sollst es ändern, mit podman oder docker bauen, taggen und als Archiv speichern oder in eine Registry schieben.
Dockerfile ──podman build──> notes-api:1.0 ──podman tag/push──> 172.16.0.126:30500
| | |
Multi-Stage podman save -o x.tar kubelet zieht Image
Alles läuft auf cp1 im Ordner
~/ckad/notes-api.
Drill 1: Quellcode holen
cd ~/ckad
git clone https://github.com/thomaszachmann/ckad-zum-anfassen
cp -r ckad-zum-anfassen/notes-api ~/ckad/notes-api
cd ~/ckad/notes-api
ls -AErwartet:
.dockerignore go.mod go.sum main.go main_test.go metrics.go store.go
notes-api ist eine kleine Go-API mit In-Memory-Speicher.
Pflicht ist ein API-Key über NOTES_API_KEY, der Port kommt
aus PORT (Standard 8080). Die .dockerignore
hält .git, Schlüssel und .env-Dateien aus dem
Build-Kontext heraus.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Multi-Stage-Dockerfile
cat > Dockerfile <<'EOF'
# Stufe 1: bauen
FROM docker.io/library/golang:1.27-alpine AS build
WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .
ARG VERSION=dev
RUN CGO_ENABLED=0 go build -ldflags="-s -w -X main.version=${VERSION}" \
-o /out/notes-api .
# Stufe 2: ausliefern
FROM docker.io/library/alpine:3.23
COPY --from=build /out/notes-api /usr/local/bin/notes-api
USER 65532:65532
EXPOSE 8080
ENTRYPOINT ["notes-api"]
EOFWarum so? go.mod und go.sum zuerst
kopieren: Ändert sich nur Code, kommen die Abhängigkeiten aus dem Cache.
Die zweite Stufe enthält nur das Binary – kein Compiler, kein Quellcode.
USER 65532 lässt den Prozess ohne Root-Rechte laufen.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Bauen mit Build-Argument
podman build -t notes-api:1.0 --build-arg VERSION=1.0 .
podman images notes-apiErwartet (gekürzt, der erste Lauf dauert gut eine Minute):
[1/2] STEP 1/7: FROM docker.io/library/golang:1.27-alpine AS build
...
[2/2] STEP 5/5: ENTRYPOINT ["notes-api"]
[2/2] COMMIT notes-api:1.0
Successfully tagged localhost/notes-api:1.0
REPOSITORY TAG IMAGE ID CREATED SIZE
localhost/notes-api 1.0 41ac32fa82fa 11 seconds ago 20.5 MB
podman setzt vor Namen ohne Registry localhost/. Das
Build-Image mit Go (473 MB) bleibt als <none> zurück,
ausgeliefert werden nur 20,5 MB.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Lokal testen
podman run --rm notes-api:1.0
echo $?Erwartet:
time=2026-11-18T15:34:04.733Z level=ERROR msg="start abgebrochen"
err="NOTES_API_KEY oder NOTES_API_KEY_FILE fehlt"
1
Mit API-Key (lab-key-123 ist ein reiner Lab-Wert):
podman run -d --name notes -p 8080:8080 -e NOTES_API_KEY=lab-key-123 notes-api:1.0
curl -s localhost:8080/version
curl -s -X POST -H 'X-API-Key: lab-key-123' -d '{"text":"hallo"}' localhost:8080/notes
podman exec notes id
podman rm -f notesErwartet:
e6dfdb539f4d07bbfa233fa1511026db35da1b9cd848bbff938ffddb487d2c5b
1.0
{"id":"2c796fb5-34b9-4017-a42f-bbf41be949fe","text":"hallo"}
uid=65532(65532) gid=65532(65532)
notes
Fortschritt speichern? Kostenlos registrieren
Drill 5: Taggen und pushen
Ein Image kann beliebig viele Namen haben. Der Name bestimmt, wohin
push geht:
podman tag notes-api:1.0 172.16.0.126:30500/notes-api:1.0
podman push 172.16.0.126:30500/notes-api:1.0Erwartet (gekürzt):
Error: trying to reuse blob sha256:7900...: pinging container registry
172.16.0.126:30500: Get "https://172.16.0.126:30500/v2/": http: server gave HTTP
response to HTTPS client
Die Lab-Registry spricht nur HTTP:
podman push --tls-verify=false 172.16.0.126:30500/notes-api:1.0
curl -s http://172.16.0.126:30500/v2/notes-api/tags/listErwartet:
Getting image source signatures
Copying blob sha256:9cff15c0e80c...
Copying blob sha256:7900194cf242...
Copying config sha256:41ac32fa82fa...
Writing manifest to image destination
{"name":"notes-api","tags":["1.0"]}
Fortschritt speichern? Kostenlos registrieren
Drill 6: Image ändern
Version 1.1 bekommt Metadaten und einen Standardwert für
PORT. Ersetze in Dockerfile die Zeile
FROM docker.io/library/alpine:3.23 durch:
FROM docker.io/library/alpine:3.23
ARG VERSION=dev
LABEL org.opencontainers.image.title="notes-api" \
org.opencontainers.image.version="${VERSION}"
ENV PORT=8080Ein ARG gilt nur in der Stufe, in der es steht – deshalb
steht es in Stufe 2 noch einmal.
podman build -t notes-api:1.1 --build-arg VERSION=1.1 .
podman inspect notes-api:1.1 --format '{{.Config.Labels}}'
podman inspect notes-api:1.1 --format '{{.Config.User}} {{.Config.Env}}'
podman history notes-api:1.1 --format '{{.CreatedBy}} {{.Size}}' | head -6Erwartet (gekürzt):
Successfully tagged localhost/notes-api:1.1
map[io.buildah.version:1.33.7 org.opencontainers.image.title:notes-api
org.opencontainers.image.version:1.1]
65532:65532 [PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
PORT=8080]
/bin/sh -c #(nop) ENTRYPOINT ["notes-api"] 0B
/bin/sh -c #(nop) EXPOSE 8080 0B
/bin/sh -c #(nop) USER 65532:65532 0B
/bin/sh -c #(nop) COPY file:009b539941a4d8... 11.7MB
/bin/sh -c #(nop) ENV PORT=8080 0B
/bin/sh -c #(nop) LABEL org.opencontainers... 0B
Die Go-Stufe kam komplett aus dem Cache, weil sich dort nichts geändert hat.
podman tag notes-api:1.1 172.16.0.126:30500/notes-api:1.1
podman push --tls-verify=false 172.16.0.126:30500/notes-api:1.1
curl -s http://172.16.0.126:30500/v2/notes-api/tags/listErwartet (gekürzt):
Writing manifest to image destination
{"name":"notes-api","tags":["1.0","1.1"]}
Fortschritt speichern? Kostenlos registrieren
Drill 7: Image als Archiv
Prüfungsklassiker: „Speichere das Image als Tarball unter …“.
Standard ist das Docker-Format, mit --format oci-archive
das OCI-Format:
mkdir -p ~/ckad/tag02 && cd ~/ckad/tag02
podman save -o notes-api-1.1.tar notes-api:1.1
podman save --format oci-archive -o notes-api-1.1-oci.tar notes-api:1.1
ls -lh *.tar
tar tf notes-api-1.1-oci.tar | tail -2Erwartet (gekürzt):
-rw-r--r-- 1 ubuntu ubuntu 8.2M Nov 18 15:35 notes-api-1.1-oci.tar
-rw-r--r-- 1 ubuntu ubuntu 20M Nov 18 15:35 notes-api-1.1.tar
index.json
oci-layout
Das OCI-Archiv ist kleiner, weil es die Schichten komprimiert. Zurückholen:
podman rmi localhost/notes-api:1.1
podman load -i notes-api-1.1-oci.tarErwartet (gekürzt):
Untagged: localhost/notes-api:1.1
...
Loaded image: localhost/notes-api:1.1
Fortschritt speichern? Kostenlos registrieren
Drill 8: Im Cluster starten
k create ns tag02
k config set-context --current --namespace=tag02
k run notes --image=172.16.0.126:30500/notes-api:1.0 --port=8080
k get pod notes
k logs notesErwartet:
NAME READY STATUS RESTARTS AGE
notes 0/1 Error 2 (22s ago) 25s
time=2026-11-18T15:35:55.962Z level=ERROR msg="start abgebrochen"
err="NOTES_API_KEY oder NOTES_API_KEY_FILE fehlt"
Der Pull hat geklappt, die Anwendung bricht ab. Neu anlegen mit Umgebungsvariable:
k delete pod notes $now
k run notes --image=172.16.0.126:30500/notes-api:1.0 --port=8080 \
--env=NOTES_API_KEY=lab-key-123
k get pod notes -o wide
curl -s $(k get pod notes -o jsonpath='{.status.podIP}'):8080/versionErwartet (gekürzt):
pod/notes created
NAME READY STATUS RESTARTS AGE IP NODE
notes 1/1 Running 0 2s 192.168.235.186 worker1
1.0
Das Image ist eines der wenigen änderbaren Pod-Felder:
k set image pod/notes notes=172.16.0.126:30500/notes-api:1.1
k exec notes -- wget -qO- localhost:8080/version
k exec notes -- idErwartet:
pod/notes image updated
1.1
uid=65532 gid=0(root) groups=0(root)
Warum gid=0? Kubernetes übernimmt aus USER
nur die UID; die Gruppe setzt erst runAsGroup im
SecurityContext (Tag 8).
Fortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Zeige User und Entrypoint des Images
notes-api:1.0. Zeitziel: 30 s - Speichere
notes-api:1.0im OCI-Format als~/ckad/tag02/notes-api-1.0.tar. Zeitziel: 30 s - Liste alle Tags von
notes-apiin der Lab-Registry. Zeitziel: 20 s
Lösung
podman inspect notes-api:1.0 --format '{{.Config.User}} {{.Config.Entrypoint}}'
podman save --format oci-archive -o ~/ckad/tag02/notes-api-1.0.tar notes-api:1.0
curl -s http://172.16.0.126:30500/v2/notes-api/tags/listErwartet (gekürzt):
65532:65532 [notes-api]
Writing manifest to image destination
{"name":"notes-api","tags":["1.0","1.1"]}
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
curl -s http://172.16.0.126:30500/v2/notes-api/tags/listErwartet:
{"name":"notes-api","tags":["1.0","1.1"]} – spätere Tage
brauchen notes-api:1.0 in der Registry.
k get pod notes -o jsonpath='{.status.containerStatuses[0].imageID}'Erwartet:
172.16.0.126:30500/notes-api@sha256:6a78ccd2... (dein
Digest weicht ab)
ls ~/ckad/tag02/*.tarErwartet: drei Archive, darunter
notes-api-1.0.tar.
Challenge
Starte notes-api:1.1 als Pod notes-9090,
der auf Port 9090 lauscht, und prüfe /healthz aus einem
Wegwerf-Pod.
Hinweis: Eine Umgebungsvariable im Pod überschreibt
das ENV aus dem Image.
Lösung
k run notes-9090 --image=172.16.0.126:30500/notes-api:1.1 --port=9090 \
--env=NOTES_API_KEY=lab-key-123 --env=PORT=9090
IP=$(k get pod notes-9090 -o jsonpath='{.status.podIP}')
k run t --rm -i --image=busybox:1.37 --restart=Never -- wget -qO- -T 5 $IP:9090/healthz
k logs notes-9090 | tail -1Erwartet (gekürzt):
ok
pod "t" deleted from tag02 namespace
time=2026-11-18T15:36:42.346Z level=INFO msg=listening addr=:9090 version=1.1 pid=1
Aufräumen (die Images in der Registry bleiben):
k config set-context --current --namespace=default
k delete ns tag02Fortschritt speichern? Kostenlos registrieren
Prüfungstipp
- Lies das Dockerfile der Aufgabe genau: Oft fehlt nur ein
ARG, einENVoder ein falscher Pfad inCOPY --from. Bauen mit-t name:tag, Punkt am Ende nicht vergessen. - „Als Tarball/Archiv speichern” heißt
podman save -o datei.tar(oderdocker save); steht „OCI” in der Aufgabe,--format oci-archiveergänzen. podman image inspectundpodman historybeantworten Fragen nach User, Ports, Labels und Schichten ohne Doku.
Enterprise-Notiz
- Images baut die CI (Buildah, Kaniko, BuildKit) und signiert sie (cosign); niemand pusht vom Laptop.
- Tags sind veränderlich – in Produktion per Digest
(
@sha256:…) deployen oder unveränderliche Tags in der Registry erzwingen. - Basis-Images regelmäßig scannen (Trivy, Grype) und neu bauen;
distroless oder
scratchverkleinern die Angriffsfläche weiter.