Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 6: ConfigMaps und Secrets

Ziel: Du trennst Konfiguration und Geheimnisse vom Image und gibst sie notes-api als Variable oder Datei mit. · Dauer: ca. 60 min · Voraussetzung: Tag 2 (Image notes-api:1.0 in der Registry), Tag 5

Briefing

CKAD: Application Environment, Configuration and Security (25 %) – „Understand ConfigMaps”, „Create & consume Secrets”.

ConfigMap / Secret --env / envFrom-->  Variable  (fest ab Containerstart)
                   --volume--------->  Datei     (Kubelet aktualisiert nach ~1 min)

Secrets sind nur base64-kodiert, nicht verschlüsselt. Wer get secret darf, liest sie.

mkdir -p ~/ckad/tag06 && cd ~/ckad/tag06
k create ns tag06
k config set-context --current --namespace=tag06

Drill 1: ConfigMaps auf drei Wegen

k create configmap notes-cfg --from-literal=LOG_LEVEL=info --from-literal=PORT=8080
printf 'motd=Willkommen bei notes-api\n' > app.properties
k create configmap notes-file --from-file=config.properties=app.properties
printf 'COLOR=blue\n# Kommentar\nOWNER=team-a\n' > team.env
k create configmap notes-env --from-env-file=team.env
k get cm notes-file -o jsonpath='{.data}{"\n"}'
k get cm notes-env -o jsonpath='{.data}{"\n"}'

Erwartet:

{"config.properties":"motd=Willkommen bei notes-api\n"}
{"COLOR":"blue","OWNER":"team-a"}

--from-file macht die ganze Datei zu einem Schlüssel (Name vor dem = frei wählbar). --from-env-file macht aus jeder Zeile einen Schlüssel, Kommentare entfallen.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Als Variable und als Datei

k run envtest --image=busybox:1.37 $do --command -- sh -c 'sleep 3600' > envtest.yaml

Den Container in envtest.yaml so ergänzen:

apiVersion: v1
kind: Pod
metadata:
  name: envtest
spec:
  containers:
  - name: envtest
    image: busybox:1.37
    command: ["sh", "-c", "sleep 3600"]
    env:
    - name: LEVEL
      valueFrom:
        configMapKeyRef:
          name: notes-cfg
          key: LOG_LEVEL
    envFrom:
    - configMapRef:
        name: notes-env
      prefix: CFG_
    volumeMounts:
    - name: cfg
      mountPath: /etc/notes
  volumes:
  - name: cfg
    configMap:
      name: notes-cfg
k apply -f envtest.yaml
k wait --for=condition=Ready pod/envtest
k exec envtest -- env | grep -E 'LEVEL|CFG_' | sort
k exec envtest -- ls /etc/notes

Erwartet:

CFG_COLOR=blue
CFG_OWNER=team-a
LEVEL=info
LOG_LEVEL
PORT

env holt einen Schlüssel unter eigenem Namen, envFrom alle Schlüssel (optional mit prefix), das Volume legt jeden Schlüssel als Datei ab.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Wer merkt eine Änderung?

k patch configmap notes-cfg -p '{"data":{"LOG_LEVEL":"debug"}}'

Etwa eine Minute warten, dann:

k exec envtest -- cat /etc/notes/LOG_LEVEL; echo
k exec envtest -- printenv LEVEL

Erwartet:

debug
info

Die Datei ist neu, die Variable nicht – Umgebungsvariablen werden nur beim Start gesetzt. Im Test dauerte es gut 70 Sekunden (Sync-Intervall des Kubelets plus Cache). Bei Variablen hilft nur ein Neustart, z. B. k rollout restart deployment ….

Fortschritt speichern? Kostenlos registrieren

Drill 4: Secrets anlegen und lesen

k create secret generic notes-key --from-literal=api-key=lab-key-123
k get secret notes-key -o yaml | grep -A1 '^data:'
k get secret notes-key -o jsonpath='{.data.api-key}' | base64 -d; echo

Erwartet:

data:
  api-key: bGFiLWtleS0xMjM=
lab-key-123

lab-key-123 ist ein reiner Lab-Wert. Im Manifest sparst du dir das Kodieren mit stringData:

cat <<'EOF' | k apply -f -
apiVersion: v1
kind: Secret
metadata:
  name: db-cred
type: Opaque
stringData:
  username: notes
  password: lab-pass-456
EOF
k get secret db-cred -o jsonpath='{.data}{"\n"}'

Erwartet:

{"password":"bGFiLXBhc3MtNDU2","username":"bm90ZXM="}

Der API-Server speichert stringData kodiert unter data. Selbst kodieren geht mit echo -n lab-pass-456 | base64 – ohne -n landet ein Zeilenumbruch im Wert.

Fortschritt speichern? Kostenlos registrieren

Drill 5: TLS- und Registry-Secrets

openssl req -x509 -newkey rsa:2048 -nodes -days 30 -subj "/CN=notes.lab" \
  -keyout tls.key -out tls.crt
k create secret tls notes-tls --cert=tls.crt --key=tls.key
k create secret docker-registry lab-reg --docker-server=172.16.0.126:30500 \
  --docker-username=dev --docker-password=lab-reg-pass
k get secret

Erwartet (gekürzt):

NAME        TYPE                             DATA   AGE
db-cred     Opaque                           2      2s
lab-reg     kubernetes.io/dockerconfigjson   1      0s
notes-key   Opaque                           1      3s
notes-tls   kubernetes.io/tls                2      1s

Der Typ legt die Schlüssel fest: tls.crt/tls.key (für Ingress, Tag 16) und .dockerconfigjson. Ein Pod nutzt das Registry-Secret über spec.imagePullSecrets: [{name: lab-reg}]; die Lab-Registry braucht keins.

Fortschritt speichern? Kostenlos registrieren

Drill 6: notes-api braucht ihren Schlüssel

k create deployment notes --image=172.16.0.126:30500/notes-api:1.0 --port=8080
k get pods -l app=notes
k logs deploy/notes

Erwartet (nach etwa 20 s):

NAME                     READY   STATUS   RESTARTS      AGE
notes-677dbfcdd4-v5g2h   0/1     Error    2 (16s ago)   20s
time=2026-11-18T15:37:17.879Z level=ERROR msg="start abgebrochen" err="NOTES_API_KEY
oder NOTES_API_KEY_FILE fehlt"

Gut so: Eine Anwendung ohne Pflicht-Konfiguration soll laut scheitern statt halb zu laufen. Den Schlüssel aus dem Secret einspielen, imperativ:

k set env deploy/notes --from=secret/notes-key --prefix=NOTES_
k get deploy notes -o jsonpath='{.spec.template.spec.containers[0].env}{"\n"}'
k rollout status deploy/notes

Erwartet:

Warning: key api-key transferred to API_KEY
deployment.apps/notes env updated
[{"name":"NOTES_API_KEY","valueFrom":{"secretKeyRef":{"key":"api-key",
"name":"notes-key"}}}]
deployment "notes" successfully rolled out

k set env macht aus api-key einen gültigen Variablennamen und setzt secretKeyRef – der Wert steht nicht im Deployment. Jetzt eine Notiz anlegen, einmal mit falschem Key:

k exec deploy/notes -- wget -qO- --header 'X-API-Key: lab-key-123' \
  --post-data '{"text":"Hallo"}' http://localhost:8080/notes
k exec deploy/notes -- wget -qO- --header 'X-API-Key: falsch' \
  --post-data '{"text":"x"}' http://localhost:8080/notes

Erwartet:

{"id":"f9baad70-061a-455b-9782-842940c33a82","text":"Hallo"}
wget: server returned error: HTTP/1.1 401 Unauthorized

Fortschritt speichern? Kostenlos registrieren

Drill 7: Der Schlüssel als Datei

Variablen landen leicht in Crash-Dumps und env-Ausgaben. notes-api liest den Key deshalb auch aus einer Datei (NOTES_API_KEY_FILE).

k delete deploy notes
k create deployment notes --image=172.16.0.126:30500/notes-api:1.0 --port=8080 \
  $do > notes.yaml

In notes.yaml den Container ergänzen:

    spec:
      containers:
      - name: notes-api
        image: 172.16.0.126:30500/notes-api:1.0
        ports:
        - containerPort: 8080
        env:
        - name: NOTES_API_KEY_FILE
          value: /etc/notes/secret/api-key
        volumeMounts:
        - name: key
          mountPath: /etc/notes/secret
          readOnly: true
      volumes:
      - name: key
        secret:
          secretName: notes-key
k apply -f notes.yaml
k rollout status deploy/notes
k logs deploy/notes | head -1

Erwartet:

time=2026-11-18T15:37:54.644Z level=INFO msg="api key loaded" source=file

Jetzt den Schlüssel rotieren:

k create secret generic notes-key --from-literal=api-key=lab-key-456 $do \
  | k replace -f -

Nach etwa einer Minute:

k exec deploy/notes -- cat /etc/notes/secret/api-key; echo
k exec deploy/notes -- wget -qO- --header 'X-API-Key: lab-key-456' \
  --post-data '{"text":"x"}' http://localhost:8080/notes

Erwartet:

lab-key-456
wget: server returned error: HTTP/1.1 401 Unauthorized

Die Datei ist neu, aber notes-api liest sie nur beim Start. Erst ein Neustart übernimmt den Schlüssel:

k rollout restart deploy/notes
k rollout status deploy/notes
k exec deploy/notes -- wget -qO- --header 'X-API-Key: lab-key-456' \
  --post-data '{"text":"x"}' http://localhost:8080/notes

Erwartet: {"id":"…","text":"x"}

Fortschritt speichern? Kostenlos registrieren

Drill 8: Unveränderliche Secrets

k patch secret notes-key -p '{"immutable":true}'
k create secret generic notes-key --from-literal=api-key=lab-key-789 $do \
  | k replace -f -
k patch secret notes-key -p '{"immutable":false}'

Erwartet:

secret/notes-key patched
The Secret "notes-key" is invalid:
* immutable: Forbidden: field is immutable when `immutable` is set
* data: Forbidden: field is immutable when `immutable` is set
The Secret "notes-key" is invalid: immutable: Forbidden: field is immutable when
`immutable` is set

Der Weg zurück ist versperrt – nur Löschen und neu Anlegen hilft. Dafür muss der Kubelet unveränderliche Objekte nicht mehr beobachten (entlastet den API-Server). Gilt auch für ConfigMaps.

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Secret db mit user=notes und pass=lab-pass-456; Pod db-client (busybox:1.37, sleep 3600) bekommt pass als Variable DB_PASS. Zeitziel: 2 min
  2. ConfigMap html aus einer Datei index.html; Pod web (nginx:1.29) liefert sie unter /usr/share/nginx/html aus. Zeitziel: 2 min
  3. Gib den Benutzernamen aus Secret db im Klartext aus. Zeitziel: 20 s

Lösung

k create secret generic db --from-literal=user=notes --from-literal=pass=lab-pass-456
k run db-client --image=busybox:1.37 $do --command -- sleep 3600 > db-client.yaml
    env:
    - name: DB_PASS
      valueFrom:
        secretKeyRef:
          name: db
          key: pass
echo '<h1>tag06</h1>' > index.html
k create configmap html --from-file=index.html
k run web --image=nginx:1.29 $do > web.yaml
    volumeMounts:
    - name: html
      mountPath: /usr/share/nginx/html
  volumes:
  - name: html
    configMap:
      name: html
k get secret db -o jsonpath='{.data.user}' | base64 -d; echo

Erwartet: notes

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

k exec db-client -- printenv DB_PASS

Erwartet: lab-pass-456

k exec web -- curl -s localhost

Erwartet: <h1>tag06</h1>

k get secret notes-key -o jsonpath='{.immutable}{"\n"}'

Erwartet: true

Challenge

Ein Kollege rollt broken aus. Der Pod startet nie. Finde die Ursache und repariere das Deployment, ohne das Secret zu ändern.

k create deployment broken --image=172.16.0.126:30500/notes-api:1.0 $do > broken.yaml

In broken.yaml unter dem Container ergänzen und anwenden:

        env:
        - name: NOTES_API_KEY
          valueFrom:
            secretKeyRef:
              name: notes-key
              key: apikey
k apply -f broken.yaml

Hinweis: Der Status heißt nicht CrashLoopBackOff – der Container wird gar nicht erst erzeugt.

Lösung

k get pods -l app=broken
k get events --field-selector reason=Failed | tail -1

Erwartet (gekürzt):

NAME                      READY   STATUS                       RESTARTS   AGE
broken-5c58d874bc-qjdhv   0/1     CreateContainerConfigError   0          10s
7s   Warning   Failed   pod/broken-5c58d874bc-qjdhv   Error: couldn't find key apikey
in Secret tag06/notes-key

Der Schlüssel heißt api-key. Reparieren:

k set env deploy/broken --from=secret/notes-key --prefix=NOTES_
k rollout status deploy/broken

Erwartet: deployment "broken" successfully rolled out. k set env überschreibt die vorhandene Variable NOTES_API_KEY mit dem richtigen secretKeyRef.

Aufräumen:

k config set-context --current --namespace=default
k delete ns tag06

Fortschritt speichern? Kostenlos registrieren

Prüfungstipp

  • k create configmap|secret … $do erzeugt YAML in Sekunden; --from-env-file und --from-file nicht verwechseln.
  • CreateContainerConfigError heißt fast immer: ConfigMap, Secret oder Schlüssel fehlt. optional: true an der Referenz macht ihn verzichtbar.
  • Doku: kubernetes.io → Tasks → Configure Pods → „Configure a Pod to Use a ConfigMap” und „Distribute Credentials Securely Using Secrets”.

Enterprise-Notiz

  • Secrets im etcd mit EncryptionConfiguration (KMS-Provider) verschlüsseln.
  • Geheimnisse nicht im Git: External Secrets Operator, Sealed Secrets oder Vault (CSI- oder Agent-Injector) holen sie aus dem zentralen Tresor.
  • Lesezugriff auf Secrets per RBAC eng fassen (Tag 9) – list reicht schon zum Auslesen.
  • Rotation einplanen: Apps lesen Dateien neu ein, oder ein Controller (z. B. Reloader) startet bei Änderung neu.