Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 9: Helm – Charts nutzen

Ziel: Ein fremdes Chart aus einer OCI-Registry installieren, mit eigenen Values anpassen, aktualisieren, zurückrollen und wieder entfernen. · Dauer: ca. 75 min · Voraussetzung: Tag 8

Briefing

  • Ein Chart ist ein Paket aus Manifest-Vorlagen (Go-Templates) und Standardwerten (values.yaml). Charts liegen in Repositories oder, wie heute, als OCI-Artefakt in einer Container-Registry.
  • helm install rendert die Vorlagen mit deinen Values und legt einen Release an. Jede Änderung erzeugt eine neue Revision; auf jede kannst du zurück.
  • Helm 4 (seit Ende 2025) arbeitet wie Helm 3 ohne Server-Komponente, nutzt aber standardmäßig Server-Side Apply, wartet über kstatus („watcher”) und hat einige Flags umbenannt (--atomic heißt jetzt --rollback-on-failure).
  • Demo-Chart: podinfo 6.17.0, ein kleiner Go-Webserver, im eigenen Namespace podinfo.
 Chart (oci://…/podinfo:6.17.0) ─┐
 values.yaml im Chart ───────────┼─► helm template ─► Manifeste ─► API-Server
 -f podinfo-values.yaml, --set ──┘
 Release podinfo: Revision 1, 2, 3 … als Secret sh.helm.release.v1.podinfo.vN

Drill 1: Helm und ein Chart aus der Registry

source ~/k8s-lab/setup/env.sh
mkdir -p ~/k8s-lab/tag09 && cd ~/k8s-lab/tag09
cp -R "$LAB/code/notes/." . && cp -R "$LAB/code/tag08/notes/." .
cp "$LAB/code/tag09/podinfo-values.yaml" .
helm version
helm show chart oci://ghcr.io/stefanprodan/charts/podinfo --version 6.17.0

Erwartet (gekürzt):

version.BuildInfo{Version:"v4.3.1", GitCommit:"c0d08d0…", GitTreeState:"clean", …}
Pulled: ghcr.io/stefanprodan/charts/podinfo:6.17.0
Digest: sha256:258d0da5…
apiVersion: v1
appVersion: 6.17.0
description: Podinfo Helm chart for Kubernetes
home: https://github.com/stefanprodan/podinfo
kubeVersion: '>=1.23.0-0'
…
name: podinfo
…
version: 6.17.0
  • version ist die Version des Charts, appVersion die der Anwendung darin. Bei podinfo sind beide gleich, bei den meisten Charts nicht.
  • OCI-Charts brauchen kein helm repo add; die Adresse beginnt mit oci://. --version pinnt – ohne nimmt Helm die neueste Version, und dein Lab ändert sich irgendwann unter dir.

Der Stand von Tag 8 bleibt unberührt: notes läuft weiter, heute arbeitest du daneben.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Values ansehen und rendern

C=oci://ghcr.io/stefanprodan/charts/podinfo
helm show values $C --version 6.17.0 2>/dev/null | wc -l
helm show values $C --version 6.17.0 2>/dev/null | grep -E -A3 '^(replicaCount|ui):'
cat podinfo-values.yaml

Erwartet:

327
replicaCount: 1
logLevel: info
host: #0.0.0.0
backend: #http://backend-podinfo:9898/echo
--
ui:
  color: "#34577c"
  message: ""
  logo: ""
# podinfo-values.yaml – eigene Werte für das Demo-Chart (Tag 9)
replicaCount: 2
ui:
  message: "Hallo aus dem Trainingslager"
  color: "#0f766e"
resources:
  requests:
    cpu: 20m
    memory: 32Mi
  limits:
    memory: 64Mi

327 Zeilen sind die Schnittstelle des Charts. Du überschreibst nur, was du brauchst. helm template zeigt, was daraus wird – ohne Cluster-Zugriff:

helm template podinfo $C --version 6.17.0 -n podinfo 2>/dev/null \
  | grep -E '^kind:|^  name:'
helm template podinfo $C --version 6.17.0 -n podinfo -f podinfo-values.yaml \
  --set ui.message="Hallo von --set" 2>/dev/null \
  | grep -E -A1 'replicas:|PODINFO_UI_(MESSAGE|COLOR)' | head -12

Erwartet (gekürzt, Suffixe weichen bei dir ab):

kind: Service
  name: podinfo
kind: Deployment
  name: podinfo
kind: Pod
  name: podinfo-grpc-test-jkmji
kind: Pod
  name: podinfo-jwt-test-bczoc
kind: Pod
  name: podinfo-service-test-a3fjm
  replicas: 2
  strategy:
--
          - name: PODINFO_UI_MESSAGE
            value: "Hallo von --set"
          - name: PODINFO_UI_COLOR
            value: "#0f766e"
  • Reihenfolge der Quellen: values.yaml im Chart, dann jede -f-Datei, dann jedes --set. Was später kommt, gewinnt.
  • Die drei Pods sind Tests (helm test), keine Workloads; Helm legt sie bei install nicht an. An Tag 10 schreibst du selbst einen.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Installieren

helm install podinfo $C --version 6.17.0 -n podinfo --create-namespace \
  -f podinfo-values.yaml --wait
helm list
helm list -n podinfo
kubectl -n podinfo get deploy,pods

Erwartet (gekürzt, Namen, IPs und Zeiten weichen bei dir ab):

Pulled: ghcr.io/stefanprodan/charts/podinfo:6.17.0
Digest: sha256:258d0da5…
NAME: podinfo
LAST DEPLOYED: Fri Oct 30 14:47:43 2026
NAMESPACE: podinfo
STATUS: deployed
REVISION: 1
DESCRIPTION: Install complete
NOTES:
1. Get the application URL by running these commands:
  echo "Visit http://127.0.0.1:8080 to use your application"
  kubectl -n podinfo port-forward deploy/podinfo 8080:9898
NAME    NAMESPACE   REVISION    UPDATED STATUS  CHART   APP VERSION
NAME     NAMESPACE  REVISION  UPDATED          STATUS    CHART           APP VERSION
podinfo  podinfo    1         2026-10-30 …     deployed  podinfo-6.17.0  6.17.0
NAME                      READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/podinfo   2/2     2            2           24s
NAME                           READY   STATUS    RESTARTS   AGE
pod/podinfo-6d9f6b786d-ngl55   1/1     Running   0          24s
pod/podinfo-6d9f6b786d-pss8p   1/1     Running   0          24s
  • Helm nimmt wie kubectl den Namespace des Kontexts. Der steht auf notes – darum ist das erste helm list leer. Bei Helm gehört -n zu jedem Befehl.
  • --wait wartet, bis alle Objekte bereit sind (Standard-Timeout 5 min). Ohne kehrt install zurück, sobald die Objekte angelegt sind.
  • NOTES: rendert das Chart aus templates/NOTES.txt – die Bedienungsanleitung.

Der Service ist ClusterIP. Für einen kurzen Blick reicht ein Port-Forward:

kubectl -n podinfo port-forward svc/podinfo 9898:9898 >/dev/null &
sleep 2
curl -s localhost:9898 | jq -c '{hostname, message, color, version}'
kill %1

Erwartet (gekürzt):

{"hostname":"podinfo-6d9f6b786d-pss8p","message":"Hallo aus dem Trainingslager",
"color":"#0f766e","version":"6.17.0"}

port-forward auf einen Service wählt einen Pod und bleibt bei ihm – für Lastverteilung taugt es nicht, für Diagnose schon.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Was Helm sich merkt

helm get values podinfo -n podinfo
helm get values podinfo -n podinfo --all | wc -l
helm get manifest podinfo -n podinfo | grep -E '^(# Source|kind)'
kubectl -n podinfo get secret -l owner=helm --show-labels

Erwartet (gekürzt):

USER-SUPPLIED VALUES:
replicaCount: 2
resources:
  limits:
    memory: 64Mi
  requests:
    cpu: 20m
    memory: 32Mi
ui:
  color: '#0f766e'
  message: Hallo aus dem Trainingslager
187
# Source: podinfo/templates/service.yaml
kind: Service
# Source: podinfo/templates/deployment.yaml
kind: Deployment
NAME                            TYPE                 DATA   AGE   LABELS
sh.helm.release.v1.podinfo.v1   helm.sh/release.v1   1      34s   modifiedAt=…,
name=podinfo,owner=helm,status=deployed,version=1

Jede Revision liegt als Secret im Namespace des Release: Chart, Values und gerenderte Manifeste, komprimiert. Darum braucht Helm keinen Server – und darum gehört der Namespace mit zum Release.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Upgrade und die Values-Falle

Du willst nur die Nachricht ändern:

helm upgrade podinfo $C --version 6.17.0 -n podinfo \
  --set ui.message="Version 2" --wait 2>/dev/null | grep -E '^(STATUS|REVISION)'
helm get values podinfo -n podinfo
kubectl -n podinfo get deploy podinfo

Erwartet (gekürzt):

STATUS: deployed
REVISION: 2
USER-SUPPLIED VALUES:
ui:
  message: Version 2
NAME      READY   UP-TO-DATE   AVAILABLE   AGE
podinfo   1/1     1            1           39s

Eine Replik, keine Farbe, keine Ressourcen: upgrade mit --set oder -f startet von den Chart-Standardwerten. Deine Datei aus Revision 1 ist weg. Ohne jedes --set/-f übernimmt Helm dagegen die alten Values. Verlass dich auf keins von beiden, sondern gib bei jedem Upgrade alles an:

helm upgrade podinfo $C --version 6.17.0 -n podinfo -f podinfo-values.yaml \
  --set ui.message="Version 3" --wait 2>/dev/null | grep -E '^(STATUS|REVISION)'
kubectl -n podinfo get deploy podinfo
helm history podinfo -n podinfo

Erwartet (gekürzt):

STATUS: deployed
REVISION: 3
NAME      READY   UP-TO-DATE   AVAILABLE   AGE
podinfo   2/2     2            2           55s
REVISION UPDATED                  STATUS     CHART          APP VERSION DESCRIPTION
1        Fri Oct 30 14:47:43 2026 superseded podinfo-6.17.0 6.17.0      Install complete
2        Fri Oct 30 14:48:07 2026 superseded podinfo-6.17.0 6.17.0      Upgrade complete
3        Fri Oct 30 14:48:24 2026 deployed   podinfo-6.17.0 6.17.0      Upgrade complete

--reuse-values (alte Values plus Neues) und --reset-then-reuse-values gibt es auch. Eine Values-Datei im Git ist trotzdem die einzige Quelle, auf die du dich verlassen kannst.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Rollback

helm get values podinfo -n podinfo --revision 1 | tail -2
helm rollback podinfo 1 -n podinfo --wait
helm history podinfo -n podinfo | tail -2
kubectl -n podinfo get rs

Erwartet (gekürzt):

  color: '#0f766e'
  message: Hallo aus dem Trainingslager
Rollback was a success! Happy Helming!
3        Fri Oct 30 14:48:24 2026 superseded podinfo-6.17.0 6.17.0      Upgrade complete
4        Fri Oct 30 14:48:40 2026 deployed   podinfo-6.17.0 6.17.0      Rollback to 1
NAME                 DESIRED   CURRENT   READY   AGE
podinfo-6d9f6b786d   2         2         2       71s
podinfo-86f77b6996   0         0         0       30s
podinfo-bfdb7fbb7    0         0         0       47s

Ein Rollback schreibt Revision 1 als neue Revision 4 – die Historie läuft nur vorwärts. Das Deployment ist wieder auf dem Pod-Template von Revision 1, also skaliert das alte ReplicaSet 6d9f6b786d wieder hoch. helm rollback ohne Nummer geht eine Revision zurück. Helm hebt standardmäßig zehn Revisionen auf (--history-max).

Fortschritt speichern? Kostenlos registrieren

Drill 7: Automatisch zurück mit --rollback-on-failure

Ein Upgrade mit einem Image-Tag, den es nicht gibt:

helm upgrade podinfo $C --version 6.17.0 -n podinfo -f podinfo-values.yaml \
  --set image.tag=0.0.0 --rollback-on-failure --timeout 60s
echo "Exit: $?"
helm history podinfo -n podinfo | tail -3
kubectl -n podinfo get events --field-selector reason=Failed \
  -o custom-columns=MSG:.message | sort -u | head -3 | cut -c1-80

Erwartet (gekürzt):

Pulled: ghcr.io/stefanprodan/charts/podinfo:6.17.0
Digest: sha256:258d0da5…
level=WARN msg="upgrade failed" name=podinfo error="resource Deployment/podinfo/podinfo
not ready. status: InProgress, message: Pending termination: 1\ncontext deadline
exceeded"
Error: UPGRADE FAILED: release podinfo failed, and has been rolled back due to
rollback-on-failure being set: resource Deployment/podinfo/podinfo not ready. …
context deadline exceeded
Exit: 1
4        Fri Oct 30 14:48:40 2026 superseded podinfo-6.17.0 6.17.0      Rollback to 1
5        Fri Oct 30 14:49:03 2026 failed     podinfo-6.17.0 6.17.0      Upgrade "podi…
6        Fri Oct 30 14:50:05 2026 deployed   podinfo-6.17.0 6.17.0      Rollback to 4
Error: ErrImagePull
Error: ImagePullBackOff
Failed to pull image "ghcr.io/stefanprodan/podinfo:0.0.0": rpc error: code = NotFoun
  • --rollback-on-failure schaltet --wait ein, wartet bis --timeout und rollt bei einem Fehler auf die letzte erfolgreiche Revision zurück. Bei install deinstalliert es stattdessen.
  • Ohne das Flag bliebe Revision 5 failed stehen, das Deployment hinge mit einem Pod in ImagePullBackOff – und der nächste upgrade müsste es richten.
  • Helm 4 kennt --atomic noch, meldet aber Flag --atomic has been deprecated, use --rollback-on-failure instead (live geprüft).

In einer Pipeline ist das die Standard-Kombination: --rollback-on-failure --timeout mit einem Wert, der zu den Probes passt.

Fortschritt speichern? Kostenlos registrieren

Drill 8: Fremde Charts und Pod Security

Der Namespace podinfo hat kein PSA-Label. kind setzt keinen Cluster-Standard, also gilt dort privileged – alles ist erlaubt. Würde podinfo unter den Regeln von notes laufen?

kubectl get ns podinfo --show-labels
kubectl label --dry-run=server --overwrite ns podinfo \
  pod-security.kubernetes.io/enforce=baseline
kubectl label --dry-run=server --overwrite ns podinfo \
  pod-security.kubernetes.io/enforce=restricted
kubectl -n podinfo exec deploy/podinfo -- id

Erwartet (gekürzt):

NAME      STATUS   AGE   LABELS
podinfo   Active   24s   kubernetes.io/metadata.name=podinfo,name=podinfo
namespace/podinfo labeled (server dry run)
namespace/podinfo labeled (server dry run)
Warning: existing pods in namespace "podinfo" violate the new PodSecurity enforce
level "restricted:latest"
Warning: podinfo-6d9f6b786d-24rcl (and 1 other pod): allowPrivilegeEscalation !=
false, unrestricted capabilities, runAsNonRoot != true, seccompProfile
uid=100(app) gid=101(app) groups=101(app)

baseline ja, restricted nein – dieselben vier Punkte wie notes vor Tag 8, obwohl podinfo gar nicht als root läuft. Viele öffentliche Charts sind so: Sie setzen keinen securityContext, bieten aber Values dafür an (helm show values … | grep -i securitycontext). Das ist die Challenge.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

helm list -n podinfo

Erwartet: Release podinfo, deployed, Revision 6.

NAME      NAMESPACE   REVISION   UPDATED   STATUS     CHART            APP VERSION
podinfo   podinfo     6          2026-…    deployed   podinfo-6.17.0   6.17.0
helm history podinfo -n podinfo

Erwartet: sechs Revisionen, darunter das fehlgeschlagene Upgrade aus Drill 7.

REVISION   UPDATED   STATUS       CHART            APP VERSION   DESCRIPTION
1          …         superseded   podinfo-6.17.0   6.17.0        Install complete
2          …         superseded   podinfo-6.17.0   6.17.0        Upgrade complete
3          …         superseded   podinfo-6.17.0   6.17.0        Upgrade complete
4          …         superseded   podinfo-6.17.0   6.17.0        Rollback to 1
5          …         failed       podinfo-6.17.0   6.17.0        Upgrade "podinfo" fa…
6          …         deployed     podinfo-6.17.0   6.17.0        Rollback to 4
helm get values podinfo -n podinfo

Erwartet: deine Werte aus podinfo-values.yaml, replicaCount: 2.

USER-SUPPLIED VALUES:
replicaCount: 2
resources:
  limits:
    memory: 64Mi
  requests:
    cpu: 20m
    memory: 32Mi
ui:
  color: '#0f766e'
  message: Hallo aus dem Trainingslager
kubectl -n podinfo get deploy podinfo

Erwartet: zwei podinfo-Pods bereit.

NAME      READY   UP-TO-DATE   AVAILABLE   AGE
podinfo   2/2     2            2           113s
helm list -n notes

Erwartet: nur die Kopfzeile. notes läuft weiter ohne Helm.

NAME    NAMESPACE   REVISION    UPDATED STATUS  CHART   APP VERSION

Challenge

Schalte im Namespace podinfo enforce und warn auf restricted und bring podinfo nur über eine zusätzliche Values-Datei podinfo-restricted.yaml wieder zum Laufen – ohne das Chart zu ändern. Räum danach alles ab.

Hinweis: Das Chart hat die Values podSecurityContext und securityContext; denk an die Falle aus Tag 8 (Drill 4).

Lösung

cat > podinfo-restricted.yaml <<'EOF'
# podinfo-restricted.yaml – Challenge Tag 9
podSecurityContext:
  runAsNonRoot: true
  runAsUser: 100   # User app im Image – Name statt UID, siehe Tag 8
  runAsGroup: 101
  seccompProfile:
    type: RuntimeDefault
securityContext:
  allowPrivilegeEscalation: false
  readOnlyRootFilesystem: true
  capabilities:
    drop: [ALL]
EOF
kubectl label ns podinfo pod-security.kubernetes.io/enforce=restricted \
  pod-security.kubernetes.io/warn=restricted
helm upgrade podinfo $C --version 6.17.0 -n podinfo -f podinfo-values.yaml \
  -f podinfo-restricted.yaml --wait 2>&1 | grep -E '^(STATUS|REVISION|Error)'
kubectl -n podinfo exec deploy/podinfo -- id
kubectl -n podinfo rollout restart deploy/podinfo

Erwartet (gekürzt):

Warning: existing pods in namespace "podinfo" violate the new PodSecurity enforce
level "restricted:latest"
Warning: podinfo-6d9f6b786d-24rcl (and 1 other pod): allowPrivilegeEscalation != …
namespace/podinfo labeled
STATUS: deployed
REVISION: 7
uid=100(app) gid=101(app) groups=101(app)
deployment.apps/podinfo restarted

Der rollout restart ohne Warning: beweist: Neue Pods erfüllen restricted. Ohne runAsUser hängt das Upgrade bis zum Timeout und die Pods zeigen CreateContainerConfigError mit image has non-numeric user (app) (live geprüft) – die Release-Revision steht dann auf failed, bis ein korrigiertes Upgrade folgt.

Zum Abschluss des Tages:

helm uninstall podinfo -n podinfo
kubectl delete ns podinfo
helm list -A

Erwartet:

release "podinfo" uninstalled
namespace "podinfo" deleted
NAME    NAMESPACE   REVISION    UPDATED STATUS  CHART   APP VERSION

helm uninstall löscht alle Objekte des Release und seine Historie, aber nie den Namespace – auch nicht, wenn --create-namespace ihn angelegt hat.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Charts aus dem Internet sind fremder Code mit Cluster-Rechten: Version pinnen, helm template vor dem ersten Einsatz lesen, Charts in eine eigene Registry spiegeln. Signaturen und Provenienz behandelt „Sichere Lieferketten zum Anfassen”.
  • Values pro Umgebung als Dateien im Git (values-prod.yaml), nie nur --set in einer Shell-History. GitOps-Werkzeuge wie Argo CD oder Flux rendern Charts deklarativ und erkennen Abweichungen.
  • helm diff (Plugin) zeigt vor jedem Upgrade, was sich ändert – Pflicht in Reviews.
  • Registry-Zugänge (helm registry login) gehören in den Secret-Store der Pipeline, nicht in die Home-Verzeichnisse der Admins.
  • Release-Secrets enthalten alle Values im Klartext (nur komprimiert). Wer Secrets lesen darf, liest auch Passwörter aus Values – RBAC entsprechend schneiden.