Tag 11: Helm und Kustomize
Ziel: Du installierst, aktualisierst und rollst Cluster-Komponenten mit Helm zurück und passt Manifeste mit Kustomize pro Umgebung an. · Dauer: ca. 60 min · Voraussetzung: Tag 8
Briefing
CKA: „Use Helm and Kustomize to install cluster components” (Teil der 25 %).
| Helm | Kustomize | |
|---|---|---|
| Idee | Vorlagen + Werte = Manifeste | Basis + Overlays = Manifeste |
| Zustand | Release mit Historie im Cluster | keiner, nur kubectl apply -k |
| Typisch | fremde Software installieren | eigene Manifeste pro Umgebung |
Helm hast du in Tag 8 installiert, Kustomize steckt in kubectl.
mkdir -p ~/cka/tag11 && cd ~/cka/tag11
k create ns tag11
k config set-context --current --namespace=tag11Drill 1: Repository und Chart finden
helm repo add podinfo https://stefanprodan.github.io/podinfo
helm repo update
helm search repo podinfo --versions | head -3Erwartet:
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 lassen sich setzen?
helm show values podinfo/podinfo --version 6.16.0 | grep -A2 -E '^replicaCount|^ui:'Erwartet:
replicaCount: 1
logLevel: info
host: #0.0.0.0
--
ui:
color: "#34577c"
message: ""
Fortschritt speichern? Kostenlos registrieren
Drill 2: Installieren mit –set
helm install web podinfo/podinfo --version 6.16.0 \
--set replicaCount=2 --set ui.message="Hallo CKA"
helm list
k get deploy,svcErwartet (gekürzt):
STATUS: deployed
REVISION: 1
NAME NAMESPACE REVISION ... STATUS CHART APP VERSION
web tag11 1 ... deployed podinfo-6.16.0 6.16.0
NAME READY UP-TO-DATE AVAILABLE AGE
deployment.apps/web-podinfo 2/2 2 2 24s
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S)
service/web-podinfo ClusterIP 10.97.129.35 <none> 9898/TCP,9999/TCP
Der Release web liegt im aktuellen Namespace;
Helm-Befehle kennen dafür -n.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Upgrade mit einer 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 -f values-prod.yaml
helm history web
helm get values webErwartet (gekürzt):
REVISION UPDATED STATUS CHART ... DESCRIPTION
1 Tue Nov 17 22:19:17 2026 superseded podinfo-6.16.0 ... Install complete
2 Tue Nov 17 22:19:42 2026 deployed podinfo-6.17.0 ... Upgrade complete
USER-SUPPLIED VALUES:
replicaCount: 3
resources:
requests:
cpu: 50m
memory: 32Mi
ui:
message: Produktion
Achtung: Ein
helm upgradeohne--reuse-valuesvergisst alle früheren--set-Werte. Was nicht in diesem Aufruf steht, fällt auf den Chart-Standard zurück.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Rollback
helm rollback web 1
helm history web
k get deployment web-podinfo \
-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
Wie bei kubectl rollout undo entsteht eine neue
Revision. Jetzt nur die Replikas ändern, alles andere behalten:
helm upgrade web podinfo/podinfo --version 6.16.0 --reuse-values --set replicaCount=1
helm get values webErwartet:
USER-SUPPLIED VALUES:
replicaCount: 1
ui:
message: Hallo CKA
Fortschritt speichern? Kostenlos registrieren
Drill 5: Rendern statt installieren
helm template erzeugt die Manifeste lokal – ohne Release
im Cluster:
helm template demo podinfo/podinfo --version 6.17.0 --set replicaCount=5 \
| grep -E '^kind:|replicas:'
helm pull podinfo/podinfo --version 6.17.0 --untar
ls podinfoErwartet:
kind: Service
kind: Deployment
replicas: 5
kind: Pod
kind: Pod
kind: Pod
Chart.yaml
LICENSE
README.md
templates
values-prod.yaml
values.yaml
Die drei Pods sind Test-Hooks des Charts.
helm pull --untar lädt das Chart zum Lesen herunter.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Kustomize – Basis und Overlays
mkdir -p shop/base shop/overlays/dev shop/overlays/prod
k create deployment shop --image=nginx:1.28 $do > shop/base/deployment.yaml
k create service clusterip shop --tcp=80:80 $do > shop/base/service.yaml
cat > shop/base/kustomization.yaml <<'EOF'
resources:
- deployment.yaml
- service.yaml
labels:
- pairs:
team: shop
includeSelectors: false
EOF
cat > shop/overlays/dev/kustomization.yaml <<'EOF'
resources:
- ../../base
namespace: shop-dev
namePrefix: dev-
configMapGenerator:
- name: settings
literals:
- MODE=dev
EOF
k kustomize shop/overlays/dev | grep -E '^kind|name: |MODE'Erwartet:
MODE: dev
kind: ConfigMap
name: dev-settings-bk2hmt6gd5
kind: Service
name: dev-shop
- name: 80-80
kind: Deployment
name: dev-shop
name: nginx
Der Generator hängt einen Hash an den ConfigMap-Namen. Ändert sich der Inhalt, ändert sich der Name – und Pods, die ihn nutzen, werden neu gestartet.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Overlay für Produktion
cat > shop/overlays/prod/kustomization.yaml <<'EOF'
resources:
- ../../base
namespace: shop-prod
namePrefix: prod-
replicas:
- name: shop
count: 3
images:
- name: nginx
newTag: "1.29"
patches:
- target:
kind: Deployment
name: shop
patch: |-
- op: add
path: /spec/template/spec/containers/0/resources
value:
limits:
memory: 128Mi
EOF
k kustomize shop/overlays/prod | grep -E 'replicas|image:|memory'
k create ns shop-dev
k create ns shop-prod
k apply -k shop/overlays/dev
k apply -k shop/overlays/prod
k get deploy -A -l team=shopErwartet (gekürzt):
replicas: 3
- image: nginx:1.29
memory: 128Mi
...
NAMESPACE NAME READY UP-TO-DATE AVAILABLE AGE
shop-dev dev-shop 1/1 1 1 10s
shop-prod prod-shop 3/3 3 3 9s
replicas, images und patches
beziehen sich auf die Namen vor dem
namePrefix.
Fortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Zeige alle Helm-Releases im ganzen Cluster. Zeitziel: 10 s
- Zeige die Manifeste, die der Release
webinstalliert hat, nur die Zeilen mitkind:. Zeitziel: 20 s - Lösche den Release
web. Zeitziel: 10 s
Lösung
helm list -A
helm get manifest web | grep '^kind:'
helm uninstall webErwartet (Ausschnitt):
NAME NAMESPACE REVISION ... CHART APP VERSION
csi-driver-nfs kube-system 1 ... csi-driver-nfs-4.13.6 4.13.6
traefik traefik 1 ... traefik-42.4.1 v3.7.19
web tag11 4 ... podinfo-6.16.0 6.16.0
kind: Service
kind: Deployment
release "web" uninstalled
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
helm list -n tag11Erwartet: nur die Kopfzeile – kein Release mehr.
k get deploy prod-shop -n shop-prod \
-o jsonpath='{.spec.template.spec.containers[0].image}{"\n"}'Erwartet: nginx:1.29
k get cm -n shop-dev -o nameErwartet:
configmap/dev-settings-bk2hmt6gd5 (der Hash kann abweichen)
und configmap/kube-root-ca.crt.
Challenge
Ändere im Dev-Overlay MODE auf debug und
wende es an. Was passiert mit der alten ConfigMap?
Hinweis: Vergleiche die ConfigMap-Namen vorher und nachher.
Lösung
sed -i 's/MODE=dev/MODE=debug/' shop/overlays/dev/kustomization.yaml
k apply -k shop/overlays/dev
k get cm -n shop-devErwartet:
configmap/dev-settings-6km8h95bh5 created
service/dev-shop unchanged
deployment.apps/dev-shop unchanged
NAME DATA AGE
dev-settings-6km8h95bh5 1 1s
dev-settings-bk2hmt6gd5 1 65s
kube-root-ca.crt 1 66s
Die neue ConfigMap entsteht neben der alten; apply -k
räumt nicht auf. Das Deployment bleibt unchanged, weil es
die ConfigMap in diesem Beispiel nicht einbindet – sonst würde der neue
Name einen Rollout auslösen. Aufräumen kannst du mit
k apply -k … --prune und Labels oder von Hand.
Aufräumen:
k config set-context --current --namespace=default
k delete ns tag11 shop-dev shop-prodFortschritt speichern? Kostenlos registrieren
Prüfungstipp
helm upgrade --installlegt an oder aktualisiert – praktisch, wenn du nicht weißt, ob der Release schon existiert.- Bei Helm immer
-nangeben, wenn die Aufgabe einen Namespace nennt; mit--create-namespacewird er angelegt. - Kustomize-Fehler zuerst mit
k kustomize <ordner>sichtbar machen, dann erst anwenden.
Enterprise-Notiz
- Helm-Werte und Kustomize-Overlays gehören ins Git; ausgerollt wird per Argo CD oder Flux.
- Chart-Versionen immer festnageln (
--version), Renovate hält sie aktuell. - Charts aus fremden Quellen vor der Installation mit
helm templateprüfen.