Zum Inhalt springen
Trainingslager IT-Trainingslager

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 -A

Erwartet:

.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"]
EOF

Warum 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-api

Erwartet (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 notes

Erwartet:

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.0

Erwartet (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/list

Erwartet:

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=8080

Ein 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 -6

Erwartet (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/list

Erwartet (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 -2

Erwartet (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.tar

Erwartet (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 notes

Erwartet:

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/version

Erwartet (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 -- id

Erwartet:

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

  1. Zeige User und Entrypoint des Images notes-api:1.0. Zeitziel: 30 s
  2. Speichere notes-api:1.0 im OCI-Format als ~/ckad/tag02/notes-api-1.0.tar. Zeitziel: 30 s
  3. Liste alle Tags von notes-api in 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/list

Erwartet (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/list

Erwartet: {"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/*.tar

Erwartet: 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 -1

Erwartet (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 tag02

Fortschritt speichern? Kostenlos registrieren

Prüfungstipp

  • Lies das Dockerfile der Aufgabe genau: Oft fehlt nur ein ARG, ein ENV oder ein falscher Pfad in COPY --from. Bauen mit -t name:tag, Punkt am Ende nicht vergessen.
  • „Als Tarball/Archiv speichern” heißt podman save -o datei.tar (oder docker save); steht „OCI” in der Aufgabe, --format oci-archive ergänzen.
  • podman image inspect und podman history beantworten 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 scratch verkleinern die Angriffsfläche weiter.