Tag 13: Helm und Kustomize
Ziel: Du installierst fertige Pakete mit Helm, rollst sie vor und zurück und baust für notes-api eine Kustomize-Basis mit Overlays für dev und prod. · Dauer: ca. 75 min · Voraussetzung: Tag 6
Briefing
CKAD: Application Deployment (20 %) – „Use the Helm package manager to deploy existing packages” und „Kustomize”.
| Helm | Kustomize | |
|---|---|---|
| Idee | Vorlagen + Werte = Manifeste | Basis + Overlays = Manifeste |
| Zustand | Release mit Historie im Cluster | keiner, nur k apply -k |
| Typisch | fremde Software installieren | eigene Manifeste pro Umgebung |
Helm v4 liegt auf cp1, Kustomize steckt in kubectl.
mkdir -p ~/ckad/tag13 && cd ~/ckad/tag13Drill 1: Repository und Chart finden
Als Paket dient podinfo, ein frei verfügbares
Demo-Chart:
helm repo add podinfo https://stefanprodan.github.io/podinfo
helm repo update
helm search repo podinfo --versions | head -3Erwartet:
"podinfo" has been added to your repositories
...Successfully got an update from the "podinfo" chart repository
NAME CHART VERSION APP VERSION DESCRIPTION
podinfo/podinfo 6.17.0 6.17.0 Podinfo Helm chart for Kubernetes
podinfo/podinfo 6.16.0 6.16.0 Podinfo Helm chart for Kubernetes
Welche Werte kann man setzen?
helm show values podinfo/podinfo | grep -A2 -E '^replicaCount|^ui:'Erwartet:
replicaCount: 1
logLevel: info
host: #0.0.0.0
--
ui:
color: "#34577c"
message: ""
helm show chart zeigt die Metadaten,
helm show values alle Standardwerte – das ist die
Bedienungsanleitung eines Charts.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Installieren mit –set
helm install web podinfo/podinfo --version 6.16.0 -n tag13 --create-namespace \
--set replicaCount=2 --set ui.message="Hallo CKAD"
helm list -n tag13
k get deploy,svc -n tag13Erwartet (gekürzt):
NAMESPACE: tag13
STATUS: deployed
REVISION: 1
NAME NAMESPACE REVISION ... STATUS CHART APP VERSION
web tag13 1 ... deployed podinfo-6.16.0 6.16.0
NAME READY UP-TO-DATE AVAILABLE AGE
deployment.apps/web-podinfo 0/2 2 0 1s
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S)
service/web-podinfo ClusterIP 10.102.236.229 <none> 9898/TCP,9999/TCP
Prüfen, ob der Wert angekommen ist:
k rollout status deploy/web-podinfo -n tag13
k exec -n tag13 deploy/web-podinfo -- wget -qO- web-podinfo:9898 \
| grep -E 'version|message'Erwartet:
deployment "web-podinfo" successfully rolled out
"version": "6.16.0",
"message": "Hallo CKAD",
helm status web -n tag13 zeigt denselben Kopf wie die
Installation samt NOTES des Charts.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Upgrade mit Werte-Datei
cat > values-prod.yaml <<'EOF'
replicaCount: 3
ui:
message: "Produktion"
resources:
requests:
cpu: 50m
memory: 32Mi
EOF
helm upgrade web podinfo/podinfo --version 6.17.0 -n tag13 -f values-prod.yaml
helm history web -n tag13
helm get values web -n tag13Erwartet (gekürzt):
Release "web" has been upgraded. Happy Helming!
REVISION UPDATED STATUS CHART ... DESCRIPTION
1 Wed Nov 18 15:25:54 2026 superseded podinfo-6.16.0 ... Install complete
2 Wed Nov 18 15:26:16 2026 deployed podinfo-6.17.0 ... Upgrade complete
USER-SUPPLIED VALUES:
replicaCount: 3
resources:
requests:
cpu: 50m
memory: 32Mi
ui:
message: Produktion
helm get values zeigt nur deine Werte; mit
--all kommen alle Chart-Standards dazu.
Achtung:
helm upgradeohne--reuse-valuesvergisst frühere--set-Werte. Was nicht im aktuellen Aufruf steht, fällt auf den Chart-Standard zurück.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Rollback und gezielte Änderung
helm rollback web 1 -n tag13
helm history web -n tag13
k get deploy web-podinfo -n tag13 \
-o jsonpath='{.spec.replicas} {.spec.template.spec.containers[0].image}{"\n"}'Erwartet (gekürzt):
Rollback was a success! Happy Helming!
REVISION ... STATUS CHART APP VERSION DESCRIPTION
1 ... superseded podinfo-6.16.0 6.16.0 Install complete
2 ... superseded podinfo-6.17.0 6.17.0 Upgrade complete
3 ... deployed podinfo-6.16.0 6.16.0 Rollback to 1
2 ghcr.io/stefanprodan/podinfo:6.16.0
Ein Rollback erzeugt eine neue Revision. Nur die Replikas ändern, alles andere behalten:
helm upgrade web podinfo/podinfo --version 6.16.0 -n tag13 \
--reuse-values --set replicaCount=1
helm get values web -n tag13Erwartet:
Release "web" has been upgraded. Happy Helming!
USER-SUPPLIED VALUES:
replicaCount: 1
ui:
message: Hallo CKAD
Fortschritt speichern? Kostenlos registrieren
Drill 5: Rendern statt installieren
helm template erzeugt die Manifeste lokal, ohne
Release:
helm template demo podinfo/podinfo --version 6.17.0 --set replicaCount=5 \
| grep -E '^kind:|replicas:'Erwartet:
kind: Service
kind: Deployment
replicas: 5
kind: Pod
kind: Pod
kind: Pod
Die drei Pods sind Test-Hooks des Charts. Wenn du nicht weißt, ob ein
Release schon existiert, nimm upgrade --install:
helm upgrade --install api podinfo/podinfo --version 6.17.0 -n tag13Erwartet (gekürzt):
Release "api" does not exist. Installing it now.
STATUS: deployed
REVISION: 1
Fortschritt speichern? Kostenlos registrieren
Drill 6: Kustomize-Basis für notes-api
mkdir -p notes/base notes/overlays/dev notes/overlays/prod
cat > notes/base/deployment.yaml <<'EOF'
apiVersion: apps/v1
kind: Deployment
metadata:
name: notes
spec:
replicas: 1
selector:
matchLabels:
app: notes
template:
metadata:
labels:
app: notes
spec:
containers:
- name: notes-api
image: notes-api
ports:
- containerPort: 8080
envFrom:
- configMapRef:
name: notes-config
- secretRef:
name: notes-secret
EOF
k create service clusterip notes --tcp=80:8080 $do > notes/base/service.yaml
cat > notes/base/kustomization.yaml <<'EOF'
resources:
- deployment.yaml
- service.yaml
labels:
- pairs:
app.kubernetes.io/part-of: notes
configMapGenerator:
- name: notes-config
literals:
- PORT=8080
secretGenerator:
- name: notes-secret
literals:
- NOTES_API_KEY=lab-key-123
images:
- name: notes-api
newName: 172.16.0.126:30500/notes-api
newTag: "1.0"
EOF
k kustomize notes/base | grep -E '^kind|^ name:|name: notes-|image:'Erwartet:
kind: ConfigMap
name: notes-config-td2thftdb5
kind: Secret
name: notes-secret-79mhh8mhd7
kind: Service
name: notes
kind: Deployment
name: notes
name: notes-config-td2thftdb5
name: notes-secret-79mhh8mhd7
image: 172.16.0.126:30500/notes-api:1.0
Die Generatoren hängen einen Hash an und Kustomize setzt die neuen
Namen im Deployment ein. Der images-Transformer ersetzt den
Platzhalter notes-api durch das echte Image.
lab-key-123 ist ein reiner Lab-Wert.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Overlays dev und prod
cat > notes/overlays/dev/kustomization.yaml <<'EOF'
resources:
- ../../base
namespace: tag13
namePrefix: dev-
labels:
- pairs:
env: dev
EOF
cat > notes/overlays/prod/kustomization.yaml <<'EOF'
resources:
- ../../base
namespace: tag13
namePrefix: prod-
labels:
- pairs:
env: prod
replicas:
- name: notes
count: 3
secretGenerator:
- name: notes-secret
behavior: replace
literals:
- NOTES_API_KEY=prod-key-456
patches:
- target:
kind: Deployment
name: notes
patch: |-
- op: add
path: /spec/template/spec/containers/0/resources
value:
requests:
cpu: 50m
memory: 32Mi
limits:
memory: 64Mi
EOF
k apply -k notes/overlays/dev
k apply -k notes/overlays/prod
k rollout status deploy/prod-notes -n tag13
k get endpointslices -n tag13 -l kubernetes.io/service-name=dev-notesErwartet (gekürzt):
configmap/dev-notes-config-td2thftdb5 created
secret/dev-notes-secret-79mhh8mhd7 created
service/dev-notes created
deployment.apps/dev-notes created
...
NAME ADDRESSTYPE PORTS ENDPOINTS AGE
dev-notes-kj4gp IPv4 8080 192.168.189.86,192.168.189.87,... + 1 more...
Vier Endpoints für einen dev-Pod? labels setzt
env nur in die Metadaten, nicht in die Selektoren. Beide
Services wählen app=notes – also alle dev-
und prod-Pods. Selektoren eines Deployments sind
unveränderlich, darum löschen und neu anlegen:
k delete -k notes/overlays/dev
k delete -k notes/overlays/prod
sed -i 's/ env: dev/ env: dev\n includeSelectors: true/' \
notes/overlays/dev/kustomization.yaml
sed -i 's/ env: prod/ env: prod\n includeSelectors: true/' \
notes/overlays/prod/kustomization.yaml
k apply -k notes/overlays/dev
k apply -k notes/overlays/prod
k rollout status deploy/prod-notes -n tag13
k get endpointslices -n tag13Erwartet (gekürzt):
NAME ADDRESSTYPE PORTS ENDPOINTS
api-podinfo-8xmvs IPv4 9898,9999 192.168.189.127
dev-notes-8hbhg IPv4 8080 192.168.235.170
prod-notes-2z2mp IPv4 8080 192.168.189.73,192.168.235.171,...
web-podinfo-jvg58 IPv4 9898,9999 192.168.189.121
Test mit dem prod-Key:
k exec -n tag13 deploy/dev-notes -- wget -qO- \
--header 'X-API-Key: prod-key-456' --post-data '{"text":"hallo"}' \
http://prod-notes/notesErwartet:
{"id":"fb8548cf-…","text":"hallo"}
replicas, images, patches und
Generatoren mit behavior: replace beziehen sich auf die
Namen vor dem namePrefix.
Fortschritt speichern? Kostenlos registrieren
Drill 8: Vorher sehen, was sich ändert
sed -i 's/count: 3/count: 2/' notes/overlays/prod/kustomization.yaml
k diff -k notes/overlays/prod; echo "exit=$?"Erwartet (gekürzt):
--- /tmp/LIVE-974998342/apps.v1.Deployment.tag13.prod-notes
+++ /tmp/MERGED-3466440709/apps.v1.Deployment.tag13.prod-notes
- generation: 1
+ generation: 2
- replicas: 3
+ replicas: 2
exit=1
Exit-Code 1 heißt „es gibt Unterschiede”, 0 heißt „nichts zu tun”. Danach anwenden:
k apply -k notes/overlays/prodErwartet:
deployment.apps/prod-notes configured, der Rest
unchanged.
Fortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Zeige alle Helm-Releases im ganzen Cluster. Zeitziel: 10 s
- Zeige nur die
kind:-Zeilen der Manifeste, die der Releasewebinstalliert hat. Zeitziel: 20 s - Deinstalliere die Releases
webundapi. Zeitziel: 15 s
Lösung
helm list -A
helm get manifest web -n tag13 | grep '^kind:'
helm uninstall web api -n tag13Erwartet (Ausschnitt):
NAME NAMESPACE REVISION ... STATUS CHART APP VERSION
api tag13 1 ... deployed podinfo-6.17.0 6.17.0
traefik traefik 1 ... deployed traefik-42.4.1 v3.7.19
web tag13 4 ... deployed podinfo-6.16.0 6.16.0
kind: Service
kind: Deployment
release "web" uninstalled
release "api" uninstalled
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
helm list -n tag13Erwartet: nur die Kopfzeile – kein Release mehr.
k get deploy -n tag13 -l env=prod -o jsonpath='{.items[0].spec.replicas}{"\n"}'Erwartet: 2
k get svc dev-notes -n tag13 -o jsonpath='{.spec.selector}{"\n"}'Erwartet:
{"app":"notes","env":"dev"}
Challenge
Gib dem dev-Overlay einen eigenen API-Key dev-key-789.
Was passiert mit dem Deployment und mit dem alten Secret?
Hinweis: Ein neuer Inhalt ergibt einen neuen Hash – und damit ein geändertes Pod-Template.
Lösung
cat >> notes/overlays/dev/kustomization.yaml <<'EOF'
secretGenerator:
- name: notes-secret
behavior: replace
literals:
- NOTES_API_KEY=dev-key-789
EOF
k apply -k notes/overlays/dev
k rollout status deploy/dev-notes -n tag13
k get secret,rs -n tag13 -l env=devErwartet (gekürzt):
configmap/dev-notes-config-td2thftdb5 unchanged
secret/dev-notes-secret-4c74ffgcmk created
service/dev-notes unchanged
deployment.apps/dev-notes configured
deployment "dev-notes" successfully rolled out
NAME TYPE DATA AGE
secret/dev-notes-secret-4c74ffgcmk Opaque 1 4s
secret/dev-notes-secret-79mhh8mhd7 Opaque 1 32s
NAME DESIRED CURRENT READY AGE
replicaset.apps/dev-notes-5b66cb98f6 1 1 1 3s
replicaset.apps/dev-notes-5fc456c5f9 0 0 0 32s
Der neue Secret-Name ändert das Pod-Template, das Deployment rollt
automatisch neu aus. Das alte Secret bleibt liegen;
apply -k räumt nicht auf.
Aufräumen:
k delete ns tag13Fortschritt speichern? Kostenlos registrieren
Prüfungstipp
- Bei Helm immer
-nangeben, wenn die Aufgabe einen Namespace nennt; fehlt er, hilft--create-namespace. helm show valuesist schneller als jede Doku-Suche nach dem richtigen Schlüssel.- Kustomize-Fehler zuerst mit
k kustomize <ordner>sichtbar machen, dann anwenden.
Enterprise-Notiz
- Helm-Werte und Overlays gehören ins Git; ausgerollt wird per Argo CD oder Flux.
- Chart-Versionen immer festnageln (
--version), Renovate hält sie aktuell. - Echte Secrets nie als
literalsins Git – External Secrets oder Sealed Secrets nutzen. - Fremde Charts vor der Installation mit
helm templatelesen.