Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 1: Der erste Release

Ziel: Ein fremdes Chart finden, lesen, mit eigenen Werten installieren, upgraden und zurückrollen – am Ende läuft zot als OCI-Registry auf Port 30500. · Dauer: ca. 60 min · Voraussetzung: Tag 0

Briefing

  • Chart = das Paket (Templates, Standardwerte, Metadaten). Release = eine installierte Instanz davon, mit eigenem Namen. Revision = ein Stand des Releases.
  • Kernidee: Manifeste = Templates + Werte. Für jede Umgebung änderst du nur die Werte.
  • Jedes upgrade und jedes rollback erzeugt eine neue Revision. Ein Rollback geht nicht zurück, es schreibt den alten Stand als neue Nummer ins Logbuch.
  • Heute installierst du zot aus einem HTTP-Repo. zot ist ab Tag 15 die Registry für dein eigenes Chart.
 Repo (index.yaml) ──> helm install ──> Templates + Werte ──> Manifeste ──> API
                        └──> Secret sh.helm.release.v1.zot.v1 (Revision 1)

Drill 1: Ein Repo hinzufügen und suchen

Ein HTTP-Repo ist ein Webserver mit einer Datei index.yaml, die alle Charts und Versionen auflistet. Helm lädt sie herunter und sucht lokal darin.

# auf prod
mkdir -p ~/helm/tag01 && cd ~/helm/tag01
helm repo add zot https://zotregistry.dev/helm-charts
helm repo update
helm search repo zot
helm search repo zot/zot --versions | head -3

Erwartet:

"zot" has been added to your repositories
Hang tight while we grab the latest from your chart repositories...
...Successfully got an update from the "zot" chart repository
Update Complete. ⎈Happy Helming!⎈
NAME     CHART VERSION  APP VERSION  DESCRIPTION
zot/zot  0.1.135        v2.1.23      A zot registry helm chart for Kubernetes
NAME     CHART VERSION  APP VERSION  DESCRIPTION
zot/zot  0.1.135        v2.1.23      A zot registry helm chart for Kubernetes
zot/zot  0.1.134        v2.1.23      A zot registry helm chart for Kubernetes

CHART VERSION ist die Version des Pakets, APP VERSION die der Software darin. Beide sind unabhängig: Zwischen 0.1.134 und 0.1.135 bleibt zot bei v2.1.23. Öffentliche Charts findest du mit helm search hub <name> auf Artifact Hub.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Lesen, bevor du installierst

# auf prod
helm show chart zot/zot --version 0.1.134
helm show values zot/zot --version 0.1.134 | grep -A3 '^service:'
helm show values zot/zot --version 0.1.134 | grep -E '^(persistence|mountConfig):'
helm show readme zot/zot --version 0.1.134 | head -5

Erwartet (gekürzt):

apiVersion: v2
appVersion: v2.1.23
description: A zot registry helm chart for Kubernetes
name: zot
type: application
version: 0.1.134
service:
  type: NodePort
  port: 5000
  nodePort: null  # Set to a specific port if type is NodePort
mountConfig: false
persistence: false
# zot

Ohne eigene Werte bekäme zot einen zufälligen NodePort und keine Persistenz – nach jedem Neustart des Pods wären alle Charts weg. helm show all zeigt alles auf einmal.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Hineinschauen mit helm pull

Bevor du einem fremden Chart Rechte in deinem Cluster gibst, holst du es auf die Platte.

# auf prod
helm pull zot/zot --version 0.1.134 --untar
tree zot -L 2 -I unittests
head -2 zot/templates/statefulset.yaml zot/templates/deployment.yaml

Erwartet (gekürzt):

zot
├── Chart.yaml
├── README.md
├── templates
│   ├── NOTES.txt
│   ├── _helpers.tpl
│   ├── config.yaml
│   ├── configmap.yaml
│   ├── deployment.yaml
│   ├── ...
│   ├── service.yaml
│   ├── serviceaccount.yaml
│   ├── servicemonitor.yaml
│   ├── statefulset.yaml
│   └── tests
└── values.yaml
==> zot/templates/statefulset.yaml <==
{{- if .Values.persistence  -}}
{{- $pvcName := default (printf "%s-pvc" .Release.Name) .Values.pvc.name -}}

==> zot/templates/deployment.yaml <==
{{ if not .Values.persistence }}
apiVersion: apps/v1

Ein Schalter, zwei Welten: Mit persistence: true rendert das Chart ein StatefulSet mit PVC, sonst ein Deployment. Genau solche Stellen liest du vor der Installation.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Installieren mit eigener Werte-Datei

# auf prod
cat > zot-values.yaml <<'EOF'
# ~/helm/tag01/zot-values.yaml – Stand Tag 01
service:
  type: NodePort
  nodePort: 30500
persistence: true
pvc:
  storage: 2Gi
mountConfig: true
configFiles:
  config.json: |-
    {
      "storage": { "rootDirectory": "/var/lib/registry" },
      "http": { "address": "0.0.0.0", "port": "5000" },
      "log": { "level": "info" }
    }
resources:
  requests: {cpu: 50m, memory: 64Mi}
  limits: {memory: 256Mi}
EOF
helm install zot zot/zot --version 0.1.134 -n zot --create-namespace \
  -f zot-values.yaml
kubectl -n zot rollout status statefulset/zot --timeout=180s
curl -s localhost:30500/v2/_catalog; echo

Erwartet (gekürzt):

NAME: zot
LAST DEPLOYED: Fri Nov 20 00:51:43 2026
NAMESPACE: zot
STATUS: deployed
REVISION: 1
DESCRIPTION: Install complete
NOTES:
Get the application URL by running these commands:
  export NODE_PORT=$(kubectl get --namespace zot -o jsonpath="{.spec.ports[0]...
partitioned roll out complete: 1 new pods have been updated...
{"repositories":[]}

Lies den Befehl als Satz: Installiere als Release zot das Chart zot/zot in Version 0.1.134 in den Namespace zot, mit den Werten aus der Datei. Ohne --version nimmt Helm die neueste – in Skripten pinnst du immer. mountConfig: true ist nötig, sonst ignoriert zot den Block configFiles.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Den Release ansehen

# auf prod
helm list -A
helm status zot -n zot

Erwartet (gekürzt):

NAME             NAMESPACE    REVISION  STATUS    CHART                      APP VERSION
gateway-api-crd  kube-system  1         deployed  gateway-api-crd-1.6.301    v1.6.3
traefik          kube-system  1         deployed  traefik-41.6.101+up41.6.1  v3.7.13
traefik-crd      kube-system  1         deployed  traefik-crd-41.6.101+up... v3.7.1
zot              zot          1         deployed  zot-0.1.134                v2.1.23
NAME: zot
STATUS: deployed
REVISION: 1
RESOURCES:
==> v1/Service
NAME   TYPE       CLUSTER-IP     EXTERNAL-IP   PORT(S)          AGE
zot    NodePort   10.43.102.93   <none>        5000:30500/TCP   53s

==> v1/StatefulSet
NAME   READY   AGE
zot    1/1     53s

==> v1/Pod(related)
NAME    READY   STATUS    RESTARTS   AGE
zot-0   1/1     Running   0          53s

Helm 4 zeigt bei status die Ressourcen samt Pods von selbst. Unter Helm 3 brauchtest du dafür --show-resources – das Flag gibt es in Helm 4 nicht mehr.

Was Helm gespeichert hat, liest du mit helm get:

# auf prod
helm get values zot -n zot | head -4
helm get values zot -n zot --all | wc -l
helm get manifest zot -n zot | grep '^kind:'
helm get metadata zot -n zot

Erwartet (gekürzt):

USER-SUPPLIED VALUES:
configFiles:
  config.json: |-
    {
130
kind: ServiceAccount
kind: ConfigMap
kind: Service
kind: StatefulSet
NAME: zot
CHART: zot
VERSION: 0.1.134
APP_VERSION: v2.1.23
NAMESPACE: zot
REVISION: 1
STATUS: deployed
DEPLOYED_AT: 2026-11-20T00:51:43Z
APPLY_METHOD: server-side apply

get values zeigt nur deine Werte, --all die zusammengeführten (130 Zeilen). get manifest ist das, was Helm wirklich an die API geschickt hat. APPLY_METHOD: server-side apply ist neu in Helm 4 – mehr dazu in Tag 14.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Upgrade, History, Rollback

Was bringt 0.1.135? Bevor du upgradest, vergleichst du die Standardwerte:

# auf prod
diff <(helm show values zot/zot --version 0.1.134) \
  <(helm show values zot/zot --version 0.1.135)
helm upgrade zot zot/zot --version 0.1.135 -n zot -f zot-values.yaml | head -5
helm history zot -n zot

Erwartet (gekürzt):

412a413,414
>   # -- Render the `helm test` hooks. Set to false to leave them out of the release.
>   enabled: true
Release "zot" has been upgraded. Happy Helming!
NAME: zot
LAST DEPLOYED: Fri Nov 20 00:52:49 2026
NAMESPACE: zot
STATUS: deployed
REVISION  UPDATED                   STATUS      CHART        DESCRIPTION
1         Fri Nov 20 00:51:43 2026  superseded  zot-0.1.134  Install complete
2         Fri Nov 20 00:52:49 2026  deployed    zot-0.1.135  Upgrade complete

Beim Upgrade gibst du -f zot-values.yaml wieder mit. Ließest du die Datei weg und setztest stattdessen irgendeinen anderen Wert, rechnete Helm nur mit den Chart-Standards plus diesem Wert – zot verlöre NodePort und Persistenz. Die genauen Regeln zeigt Tag 3.

# auf prod
helm rollback zot 1 -n zot
helm history zot -n zot
kubectl -n zot get sts zot -o jsonpath='{.metadata.labels.helm\.sh/chart}{"\n"}'

Erwartet (gekürzt):

Rollback was a success! Happy Helming!
REVISION  UPDATED                   STATUS      CHART        DESCRIPTION
1         Fri Nov 20 00:51:43 2026  superseded  zot-0.1.134  Install complete
2         Fri Nov 20 00:52:49 2026  superseded  zot-0.1.135  Upgrade complete
3         Fri Nov 20 00:53:00 2026  deployed    zot-0.1.134  Rollback to 1
zot-0.1.134

Revision 3 hat den Inhalt von Revision 1. Ohne Nummer rollt Helm auf die vorherige Revision zurück – also auf 2:

# auf prod
helm rollback zot -n zot
helm history zot -n zot --max 2

Erwartet:

Rollback was a success! Happy Helming!
REVISION  UPDATED                   STATUS      CHART        APP VERSION  DESCRIPTION
3         Fri Nov 20 00:53:00 2026  superseded  zot-0.1.134  v2.1.23      Rollback to 1
4         Fri Nov 20 00:53:09 2026  deployed    zot-0.1.135  v2.1.23      Rollback to 2

zot läuft wieder mit 0.1.135. Das ist der Stand für die nächsten Tage.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Wegwerf-Release und keep-history

helm uninstall löscht die Objekte und die Historie. Mit --keep-history bleibt das Logbuch – und damit der Weg zurück.

# auf prod
helm install wegwerf zot/zot --version 0.1.135 -n tag01 --create-namespace \
  --set service.type=ClusterIP --set persistence=true --set pvc.storage=1Gi \
  --wait --timeout 3m | grep STATUS
helm uninstall wegwerf -n tag01 --keep-history
helm list -n tag01
kubectl -n tag01 get all,pvc

Erwartet (gekürzt):

STATUS: deployed
release "wegwerf" uninstalled
NAME     NAMESPACE  REVISION  UPDATED  STATUS       CHART        APP VERSION
wegwerf  tag01      1         ...      uninstalled  zot-0.1.135  v2.1.23
NAME                                              STATUS   VOLUME          CAPACITY
persistentvolumeclaim/wegwerf-pvc-wegwerf-zot-0   Bound    pvc-4502992e…   1Gi

Zwei Dinge fallen auf. Erstens: Helm 4 zeigt in helm list alle Releases in jedem Status, auch uninstalled. Das alte helm list -a gibt es nicht mehr; zum Filtern nimmst du --deployed, --failed oder --uninstalled. Zweitens: Die PVC bleibt. Sie stammt aus den volumeClaimTemplates des StatefulSets und gehört nicht zum Release.

# auf prod
helm rollback wegwerf 1 -n tag01
helm history wegwerf -n tag01
helm uninstall wegwerf -n tag01
helm history wegwerf -n tag01
kubectl delete namespace tag01

Erwartet (gekürzt):

Rollback was a success! Happy Helming!
REVISION  UPDATED                   STATUS       CHART        DESCRIPTION
1         Fri Nov 20 00:53:20 2026  uninstalled  zot-0.1.135  Uninstallation...
2         Fri Nov 20 00:53:53 2026  deployed     zot-0.1.135  Rollback to 1
release "wegwerf" uninstalled
Error: release: not found
namespace "tag01" deleted

Ein Rollback holt auch einen deinstallierten Release zurück – samt der liegen gebliebenen PVC. Nach dem zweiten uninstall ohne --keep-history ist er endgültig weg. Erst das Löschen des Namespaces entfernt die PVC.

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Zeig nur die Chart-Version des Releases zot. Zeitziel: 20 s
  2. Zeig die Werte, die du in Revision 1 gesetzt hast. Zeitziel: 15 s
  3. Lies den NodePort aus dem gespeicherten Manifest. Zeitziel: 30 s
  4. Prüfe, ob zot über die IP der VM antwortet. Zeitziel: 15 s

Lösung

# auf prod
helm list -n zot -o json | jq -r '.[0].chart'
helm get values zot -n zot --revision 1 | head -3
helm get manifest zot -n zot | yq 'select(.kind == "Service") | .spec.ports[0].nodePort'
curl -s -o /dev/null -w '%{http_code}\n' 172.16.0.123:30500/v2/

Erwartet:

zot-0.1.135
USER-SUPPLIED VALUES:
configFiles:
  config.json: |-
30500
200

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

# auf prod
helm list -n zot --deployed --short

Erwartet: zot

# auf prod
helm history zot -n zot --max 1 -o json | jq -r '.[0].chart'

Erwartet: zot-0.1.135

# auf prod
curl -s localhost:30500/v2/_catalog

Erwartet: {"repositories":[]}

# auf prod
kubectl -n zot get pvc

Erwartet: zot-pvc-zot-0 mit Status Bound und 2Gi.

Challenge

Finde ohne Installation heraus, welche Kubernetes-Objekte das zot-Chart mit deiner Werte-Datei erzeugt und welche ohne. Warum tauchen zwei Pods auf, die helm get manifest nicht zeigt?

Hinweis: helm template rendert lokal, ohne den Cluster zu ändern.

Lösung

# auf prod
cd ~/helm/tag01
helm template zot zot/zot --version 0.1.135 -f zot-values.yaml | grep '^kind:'
helm template zot zot/zot --version 0.1.135 | grep '^kind:'
helm template zot zot/zot --version 0.1.135 -s templates/statefulset.yaml

Erwartet:

kind: ServiceAccount
kind: ConfigMap
kind: Service
kind: StatefulSet
kind: Pod
kind: Pod
kind: ServiceAccount
kind: Service
kind: Deployment
kind: Pod
kind: Pod
Error: could not find template templates/statefulset.yaml in chart

Die beiden Pods sind Test-Hooks aus templates/tests/. helm template gibt sie mit aus, im Release stehen Hooks aber getrennt (helm get hooks, Tag 11). Und: -s auf eine Datei, die mit den aktuellen Werten leer rendert, endet mit could not find template – die Datei existiert, sie liefert nur nichts.

Fortschritt speichern? Kostenlos registrieren

Interview-Notiz

  • Chart oder Release? Das Chart ist das Paket, der Release seine Instanz im Cluster. Ein Chart kann als viele Releases laufen, auch im selben Namespace, solange die Namen sich unterscheiden.
  • Was passiert bei helm install? Chart laden, Werte zusammenführen, Templates rendern, prüfen, an die API schicken und den Release als Secret im Namespace speichern.
  • Was macht helm rollback? Er schreibt den Inhalt einer alten Revision als neue Revision. Daten in Volumes dreht er nicht zurück.

Enterprise-Notiz

  • Fremde Charts immer mit --version pinnen und vor dem Upgrade helm show values der alten und neuen Version vergleichen.
  • Charts nicht direkt aus dem Internet installieren, sondern in eine eigene Registry spiegeln und dort prüfen (Tag 15, 16).
  • PVCs aus volumeClaimTemplates überleben helm uninstall. Aufräumen gehört ins Runbook – genauso wie das bewusste Behalten von Produktionsdaten.
  • --keep-history für Releases, deren Uninstall du eventuell zurücknehmen willst.