Zum Inhalt springen
Trainingslager IT-Trainingslager

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=tag11

Drill 1: Repository und Chart finden

helm repo add podinfo https://stefanprodan.github.io/podinfo
helm repo update
helm search repo podinfo --versions | head -3

Erwartet:

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,svc

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

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

Erwartet:

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 podinfo

Erwartet:

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=shop

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

  1. Zeige alle Helm-Releases im ganzen Cluster. Zeitziel: 10 s
  2. Zeige die Manifeste, die der Release web installiert hat, nur die Zeilen mit kind:. Zeitziel: 20 s
  3. Lösche den Release web. Zeitziel: 10 s

Lösung

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

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

Erwartet: 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 name

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

Erwartet:

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-prod

Fortschritt speichern? Kostenlos registrieren

Prüfungstipp

  • helm upgrade --install legt an oder aktualisiert – praktisch, wenn du nicht weißt, ob der Release schon existiert.
  • Bei Helm immer -n angeben, wenn die Aufgabe einen Namespace nennt; mit --create-namespace wird 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 template prüfen.