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 installrendert 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 (
--atomicheiß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.0Erwartet (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
versionist die Version des Charts,appVersiondie der Anwendung darin. Bei podinfo sind beide gleich, bei den meisten Charts nicht.- OCI-Charts brauchen kein
helm repo add; die Adresse beginnt mitoci://.--versionpinnt – 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.yamlErwartet:
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 -12Erwartet (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.yamlim 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 beiinstallnicht 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,podsErwartet (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
kubectlden Namespace des Kontexts. Der steht aufnotes– darum ist das erstehelm listleer. Bei Helm gehört-nzu jedem Befehl. --waitwartet, bis alle Objekte bereit sind (Standard-Timeout 5 min). Ohne kehrtinstallzurück, sobald die Objekte angelegt sind.NOTES:rendert das Chart austemplates/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 %1Erwartet (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-labelsErwartet (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 podinfoErwartet (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 podinfoErwartet (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 rsErwartet (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-80Erwartet (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-failureschaltet--waitein, wartet bis--timeoutund rollt bei einem Fehler auf die letzte erfolgreiche Revision zurück. Beiinstalldeinstalliert es stattdessen.- Ohne das Flag bliebe Revision 5
failedstehen, das Deployment hinge mit einem Pod inImagePullBackOff– und der nächsteupgrademüsste es richten. - Helm 4 kennt
--atomicnoch, meldet aberFlag --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 -- idErwartet (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 podinfoErwartet: 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 podinfoErwartet: 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 podinfoErwartet: 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 podinfoErwartet: zwei podinfo-Pods bereit.
NAME READY UP-TO-DATE AVAILABLE AGE
podinfo 2/2 2 2 113s
helm list -n notesErwartet: 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/podinfoErwartet (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 -AErwartet:
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 templatevor 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--setin 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.