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
upgradeund jedesrollbackerzeugt 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 -3Erwartet:
"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 -5Erwartet (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.yamlErwartet (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; echoErwartet (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 zotErwartet (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 zotErwartet (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 zotErwartet (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 2Erwartet:
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,pvcErwartet (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 tag01Erwartet (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
- Zeig nur die Chart-Version des Releases
zot. Zeitziel: 20 s - Zeig die Werte, die du in Revision 1 gesetzt hast. Zeitziel: 15 s
- Lies den NodePort aus dem gespeicherten Manifest. Zeitziel: 30 s
- 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 --shortErwartet: 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/_catalogErwartet: {"repositories":[]}
# auf prod
kubectl -n zot get pvcErwartet: 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.yamlErwartet:
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
--versionpinnen und vor dem Upgradehelm show valuesder 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überlebenhelm uninstall. Aufräumen gehört ins Runbook – genauso wie das bewusste Behalten von Produktionsdaten. --keep-historyfür Releases, deren Uninstall du eventuell zurücknehmen willst.