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.0in 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=tag06Drill 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.yamlDen 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-cfgk 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/notesErwartet:
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 LEVELErwartet:
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; echoErwartet:
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 secretErwartet (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/notesErwartet (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/notesErwartet:
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/notesErwartet:
{"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.yamlIn 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-keyk apply -f notes.yaml
k rollout status deploy/notes
k logs deploy/notes | head -1Erwartet:
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/notesErwartet:
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/notesErwartet: {"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
- Secret
dbmituser=notesundpass=lab-pass-456; Poddb-client(busybox:1.37,sleep 3600) bekommtpassals VariableDB_PASS. Zeitziel: 2 min - ConfigMap
htmlaus einer Dateiindex.html; Podweb(nginx:1.29) liefert sie unter/usr/share/nginx/htmlaus. Zeitziel: 2 min - Gib den Benutzernamen aus Secret
dbim 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: passecho '<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: htmlk get secret db -o jsonpath='{.data.user}' | base64 -d; echoErwartet: notes
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
k exec db-client -- printenv DB_PASSErwartet: lab-pass-456
k exec web -- curl -s localhostErwartet:
<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.yamlIn broken.yaml unter dem Container ergänzen und
anwenden:
env:
- name: NOTES_API_KEY
valueFrom:
secretKeyRef:
name: notes-key
key: apikeyk apply -f broken.yamlHinweis: 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 -1Erwartet (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/brokenErwartet:
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 tag06Fortschritt speichern? Kostenlos registrieren
Prüfungstipp
k create configmap|secret … $doerzeugt YAML in Sekunden;--from-env-fileund--from-filenicht verwechseln.CreateContainerConfigErrorheißt fast immer: ConfigMap, Secret oder Schlüssel fehlt.optional: truean 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) –
listreicht schon zum Auslesen. - Rotation einplanen: Apps lesen Dateien neu ein, oder ein Controller (z. B. Reloader) startet bei Änderung neu.