Zum Inhalt springen
Trainingslager IT-Trainingslager

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

Drill 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 -3

Erwartet:

"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 tag13

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

Erwartet (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 upgrade ohne --reuse-values vergisst 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 tag13

Erwartet:

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 tag13

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

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

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

Erwartet: {"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/prod

Erwartet: deployment.apps/prod-notes configured, der Rest unchanged.

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Zeige alle Helm-Releases im ganzen Cluster. Zeitziel: 10 s
  2. Zeige nur die kind:-Zeilen der Manifeste, die der Release web installiert hat. Zeitziel: 20 s
  3. Deinstalliere die Releases web und api. Zeitziel: 15 s

Lösung

helm list -A
helm get manifest web -n tag13 | grep '^kind:'
helm uninstall web api -n tag13

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

Erwartet: 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=dev

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

Fortschritt speichern? Kostenlos registrieren

Prüfungstipp

  • Bei Helm immer -n angeben, wenn die Aufgabe einen Namespace nennt; fehlt er, hilft --create-namespace.
  • helm show values ist 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 literals ins Git – External Secrets oder Sealed Secrets nutzen.
  • Fremde Charts vor der Installation mit helm template lesen.