Helm CLI Cheat Sheet

Vollständige kubectl-Befehlsreferenz, die Pods, Deployments, Services, ConfigMaps, Secrets und das Cluster-Management abdeckt.

Ein praktischer Quick-Reference-Guide für Helm, den Package-Manager für Kubernetes. Die Befehle sind nach Workflows organisiert: Installation, Verwaltung von Releases, Arbeit mit Charts und Fehlerbehebung.

Kernkonzepte

Bevor Sie mit den Befehlen beginnen, sollten Sie diese grundlegenden Konzepte verstehen:

Values-Dateien und Overriding

Helm führt Values in dieser Reihenfolge zusammen (spätere Werte überschreiben frühere):

1. values.yaml des Charts (Defaults)
2. Values des Parent-Charts (für Subcharts)
3. Vom Benutzer bereitgestellte -f values.yaml-Dateien (mehrere erlaubt)
4. --set- und --set-file-Argumente

Installationsbefehle

Basis-Installation

# Install a chart with default values
helm install my-release bitnami/nginx

# Install in a specific namespace (namespace must exist)
helm install my-release bitnami/nginx -n production

# Install with a custom release name from a local chart
helm install myapp ./my-chart

Installation mit benutzerdefinierten Values

# Override values from a file
helm install my-release bitnami/nginx -f values.yaml

# Override multiple values files (later files override earlier)
helm install my-release bitnami/nginx -f base.yaml -f override.yaml

# Set individual values inline
helm install my-release bitnami/nginx --set replicaCount=3

# Set nested values
helm install my-release bitnami/nginx --set image.tag=1.25.0

# Set multiple values
helm install my-release bitnami/nginx \
  --set replicaCount=3 \
  --set service.type=LoadBalancer

Installation mit Verifizierung

# Dry run to see generated manifests without installing
helm install my-release bitnami/nginx --dry-run

# Dry run with debug output (shows computed values)
helm install my-release bitnami/nginx --dry-run --debug

# Verify chart before install (runs helm test after install)
helm install my-release bitnami/nginx --wait

# Install with timeout (default is 5m)
helm install my-release bitnami/nginx --timeout 10m

Installation aus verschiedenen Quellen

# From OCI registry
helm install my-release oci://registry.example.com/charts/nginx:1.0.0

# From absolute URL
helm install my-release https://example.com/charts/nginx-1.0.0.tgz

# From a specific chart version
helm install my-release bitnami/nginx --version 15.0.0

Release-Management

Releases auflisten

# List releases in current namespace
helm list

# List releases in all namespaces
helm list -A

# List releases in a specific namespace
helm list -n production

# Show all releases including deleted (kept for history)
helm list --all

# Filter by release name pattern
helm list --filter 'my-*'

# Output in different formats
helm list -o json
helm list -o yaml

Release-Status und Historie

# Status eines Releases abrufen
helm status my-release
# Status in einem spezifischen Namespace abrufen
helm status my-release -n production

# Release-Historie anzeigen
helm history my-release

# Historie mit maximaler Anzahl an Revisionen
helm history my-release --max 10

Uninstall Releases

# Ein Release deinstallieren
helm uninstall my-release

# Aus einem spezifischen Namespace deinstallieren
helm uninstall my-release -n production

# Historie nach Deinstallation beibehalten (ermöglicht Rollback)
helm uninstall my-release --keep-history

# Dry Run der Deinstallation
helm uninstall my-release --dry-run

Upgrade and Rollback

Upgrade Releases

# Upgrade auf die neueste Chart-Version
helm upgrade my-release bitnami/nginx

# Upgrade mit neuen Values
helm upgrade my-release bitnami/nginx -f values.yaml

# Upgrade mit Inline-Values
helm upgrade my-release bitnami/nginx --set replicaCount=5

# Upgrade auf eine spezifische Chart-Version
helm upgrade my-release bitnami/nginx --version 16.0.0

# Upgrade durchführen und installieren, falls das Release nicht existiert
helm upgrade --install my-release bitnami/nginx -f values.yaml

# Ressourcen-Updates durch Ersetzung erzwingen
helm upgrade my-release bitnami/nginx --force

Upgrade with Safety Options

# Warten, bis die Ressourcen bereit sind
helm upgrade my-release bitnami/nginx --wait

# Warten mit benutzerdefiniertem Timeout
helm upgrade my-release bitnami/nginx --wait --timeout 10m

# Rollback bei Fehlern (automatischer Rollback, falls das Upgrade fehlschlägt)
helm upgrade my-release bitnami/nginx --atomic

# Bereinigung bei Fehlern (löscht neue Ressourcen bei einem Fehler)
helm upgrade my-release bitnami/nginx --cleanup-on-fail

Rollback Releases

# Rollback zur vorherigen Revision
helm rollback my-release

# Rollback zu einer spezifischen Revision
helm rollback my-release 3

# Rollback in einem spezifischen Namespace
helm rollback my-release 3 -n production

# Dry Run des Rollbacks
helm rollback my-release --dry-run

Chart Operations

Create Charts

# Ein neues Chart-Skeleton erstellen
helm create my-chart

# Erstellen mit einem spezifischen Starter
helm create my-chart --starter bitnami/nginx

Package Charts

# Ein Chart-Verzeichnis in eine .tgz-Datei packen
helm package ./my-chart

# Packen mit einer spezifischen Version
helm package ./my-chart --version 1.2.3

# Packen mit App-Version
helm package ./my-chart --app-version 2.0.0

# Packen mit Signatur
helm package ./my-chart --sign --key 'John Doe'

Lint and Validate

# Ein Chart auf Fehler prüfen (Linting)
helm lint ./my-chart

# Linting im Strict-Mode (Warnungen als Fehler behandeln)
helm lint ./my-chart --strict

# Linting mit Values-Datei
helm lint ./my-chart -f values.yaml

Pull and Download

# Download eines Charts ohne Installation
helm pull bitnami/nginx

# Download einer spezifischen Version
helm pull bitnami/nginx --version 15.0.0

# Download und Entpacken
helm pull bitnami/nginx --untar

# Download in ein spezifisches Verzeichnis
helm pull bitnami/nginx -d ./charts/

# Download aus einer OCI-Registry
helm pull oci://registry.example.com/charts/nginx:1.0.0

Inspect Charts

# Alle Chart-Informationen anzeigen
helm show all bitnami/nginx

# Nur den Inhalt von chart.yaml anzeigen
helm show chart bitnami/nginx

# Standardwerte (Default Values) anzeigen
helm show values bitnami/nginx

# README anzeigen
helm show readme bitnami/nginx

# Informationen aus einem gepackten Chart anzeigen
helm show values ./nginx-15.0.0.tgz

# Ausgaben kombinieren
helm show chart bitnami/nginx && helm show values bitnami/nginx

Repository Management

Add and List Repositories

# Ein Chart-Repository hinzufügen
helm repo add bitnami https://charts.bitnami.com/bitnami

# Hinzufügen mit Authentifizierung
helm repo add private https://charts.example.com \
  --username user --password pass

# Konfigurierte Repositories auflisten
helm repo list

# Ausgabe als JSON anzeigen
helm repo list -o json

Update and Remove

# Alle Repositories aktualisieren (neuesten Index abrufen)
helm repo update

# Spezifisches Repository aktualisieren
helm repo update bitnami

# Ein Repository entfernen
helm repo remove bitnami

# Mehrere Repositories entfernen
helm repo remove bitnami stable

Index and Search

# Index-Datei für ein Chart-Verzeichnis generieren
helm repo index ./charts/

# Index mit Basis-URL generieren
helm repo index ./charts/ --url https://charts.example.com

# Mit bestehendem Index zusammenführen
helm repo index ./charts/ --merge index.yaml

# Suche nach Charts per Keyword
helm search repo nginx

# Suche in allen Repositories (Hub)
helm search hub nginx

# Suche mit Regex
helm search repo 'nginx$'

# Alle Versionen anzeigen (nicht nur die neueste)
helm search repo nginx --versions

# Filterung nach Versionsbeschränkung
helm search repo nginx --version '>=15.0.0'

Values Management

Inspect Values

# Alle berechneten Werte für ein Release abrufen
helm get values my-release

# Werte in einem spezifischen Namespace abrufen
helm get values my-release -n production

# Werte für eine spezifische Revision abrufen
helm get values my-release --revision 3
# Alle Werte inklusive Defaults abrufen
helm get values my-release --all

# Ausgabe als YAML (Standard)
helm get values my-release -o yaml

# Ausgabe als JSON
helm get values my-release -o json

Set Values Syntax

# Einfacher Wert
--set name=value

# Verschachtelter Wert (Punkt-Notation)
--set image.tag=1.25.0

# Array/Listen-Werte (Index verwenden)
--set servers[0].name=web1
--set servers[1].name=web2

# Array-Kurzschreibweise
--set names={web1,web2,web3}

# Werte mit Sonderzeichen (maskieren oder in Anführungszeichen setzen)
--set "pod.annotations.kubernetes\.io/name"=myapp

# Wert aus Datei lesen
--set-file config=./config.txt

# String-Wert verwenden (erhält den Typ)
--set-string enabled=true

Values Files

# Eine Values-Datei verwenden
helm install my-release bitnami/nginx -f values.yaml

# Mehrere Values-Dateien verwenden
helm install my-release bitnami/nginx \
  -f base.yaml \
  -f env/prod.yaml

# Vorlage für eine Values-Datei generieren
helm show values bitnami/nginx > values.yaml

Template and Debug

Render Templates

# Templates rendern ohne Installation
helm template my-release bitnami/nginx

# Rendern mit Values-Datei
helm template my-release bitnami/nginx -f values.yaml

# In ein Verzeichnis rendern
helm template my-release bitnami/nginx --output-dir ./rendered/

# Nur spezifische Templates rendern
helm template my-release bitnami/nginx -s templates/deployment.yaml

# Rendern mit Simulation des Release-Namens
helm template my-release ./my-chart --release-name

Debug Commands

# Debugging mit Dry Run (zeigt berechnete Werte und Manifeste)
helm install my-release bitnami/nginx --dry-run --debug

# Debugging von Template-Rendering-Problemen
helm template my-release ./my-chart --debug

# Renderte Manifeste serverseitig validieren
helm template my-release bitnami/nginx | kubectl apply --dry-run=client -f -

Dependency Management

Work with Dependencies

# Chart-Abhängigkeiten herunterladen
helm dependency update ./my-chart

# Abhängigkeiten auflisten
helm dependency list ./my-chart

# Abhängigkeiten aus Chart.lock aufbauen
helm dependency build ./my-chart

Chart.yaml Dependencies

# Beispiel Chart.yaml mit Abhängigkeiten
apiVersion: v2
name: my-app
version: 1.0.0
dependencies:
  - name: redis
    version: "17.x.x"
    repository: https://charts.bitnami.com/bitnami
    condition: redis.enabled
  - name: postgresql
    version: "12.x.x"
    repository: https://charts.bitnami.com/bitnami
    alias: database

Plugin-Management

Plugins installieren und verwenden

# Install a plugin
helm plugin install https://github.com/helm/helm-mapkubeapis

# Install from local directory
helm plugin install ./helm-plugin

# List installed plugins
helm plugin list

# Uninstall a plugin
helm plugin uninstall mapkubeapis

# Update a plugin
helm plugin update helm-diff

Release-Informationen

Detaillierte Release-Infos abrufen

# Get user-supplied values
helm get values my-release

# Get rendered manifests
helm get manifest my-release

# Get release notes
helm get notes my-release

# Get hooks (job templates)
helm get hooks my-release

# Get everything combined
helm get all my-release

# Get from a specific revision
helm get manifest my-release --revision 2

# Get from specific namespace
helm get manifest my-release -n production

Testing

Releases testen

# Run helm tests for a release
helm test my-release

# Test with timeout
helm test my-release --timeout 5m

# Clean up test pods after running
helm test my-release --cleanup

# Test in a specific namespace
helm test my-release -n production

# View test logs
kubectl logs my-release-test-connection

Beispiel: Pod-Test

Charts definieren Tests in templates/tests/. Ein Test-Hook sieht wie folgt aus:

apiVersion: v1
kind: Pod
metadata:
  name: "{{ .Release.Name }}-test-connection"
  annotations:
    "helm.sh/hook": test
spec:
  containers:
    - name: wget
      image: busybox
      command: ["wget"]
      args: ["{{ .Release.Name }}:{{ .Values.service.port }}"]
  restartPolicy: Never

Gängige Patterns

Production-Installations-Pattern

helm upgrade --install myapp ./chart \
  -n production \
  --create-namespace \
  -f values/production.yaml \
  --set image.tag=${CI_COMMIT_SHA} \
  --atomic \
  --timeout 10m \
  --wait \
  --history-max 10

Diff vor dem Upgrade (mit helm-diff Plugin)

# Preview changes before applying
helm diff upgrade my-release bitnami/nginx -f values.yaml

# Diff with three-way merge view
helm diff upgrade my-release bitnami/nginx --three-way-merge

Multi-Environment-Values

# Verzeichnisstruktur
# values/
#   base.yaml
#   development.yaml
#   staging.yaml
#   production.yaml

helm upgrade --install myapp ./chart \
  -f values/base.yaml \
  -f values/production.yaml

Secret Management

# Sensible Werte aus der Umgebung setzen
helm install my-release bitnami/postgresql \
  --set postgresqlPassword="${DB_PASSWORD}" \
  --set-string postgresqlPassword="${DB_PASSWORD}"

# --set-file für Secrets aus Dateien verwenden
helm install my-release ./chart \
  --set-file ssl.cert=/path/to/cert.pem

Quick Reference

Nächste Schritte

• Kubernetes kubectl Cheat Sheet — Essenzielle kubectl-Befehle
• Docker CLI Cheat Sheet — Container-Images erstellen
• Kubernetes GitOps mit ArgoCD — Deklarative Deployments mit Helm

Ressourcen & Verwandte Plattformen

• tobias-weiss.org - Weitere Cheat Sheets, Artikel und Shop-Produkte
• graphwiz.ai - KI, Knowledge Graphs und agentische Entwicklung
• courses.graphwiz.ai - Interaktive Übungsprüfungen und Lernleitfäden
• ki-kompetenz-training.org - EU AI Act konforme KI-Kompetenztrainings

Verwandte Cheat Sheets

• Kubernetes Cheat Sheet - Cluster verwalten
• Docker Cheat Sheet - Container-Grundlagen