Helm
Quelle: pkr-lab/pkr-lab-docs/cubi/helm.md
Helm
Helm-Releases aller Namespaces ansehen: Status, Values und Historie.
Code: modules/helm.py
Überblick
cubi helm ruft helm list -A -o json --max 500 auf und zeigt die Releases als Tabelle (alle 30 Sekunden neu), sortiert nach Namespace und Name. Der Bereich liest nur und ändert nichts.
| Spalte | Quelle |
|---|---|
| Release, Namespace | name, namespace |
| Rev | revision |
| Status | status, farbig: deployed grün, failed und unknown rot, pending-* und uninstalling gelb, superseded und uninstalled grau |
| Chart, App-Version | chart, app_version |
| Alter | aus updated berechnet (3d, 5h) |
Enter auf einem Release öffnet das Menü:
| Aktion | Befehl |
|---|---|
| Status | helm status <name> -n <ns> |
| Values | helm get values <name> -n <ns> (leer: Keine eigenen Values) |
| Historie | helm history <name> -n <ns> |
Beachten: Im Homelab rollt ArgoCD die Charts aus. ArgoCD rendert sie mit helm template und legt keine Helm-Release-Secrets an, ArgoCD-Apps fehlen daher in dieser Tabelle. Sichtbar sind nur Releases, die Helm selbst installiert hat. Nach dem Code von capulus-ansible ist das mindestens ArgoCD (Rolle argocd, helm upgrade --install argocd argo/argo-cd) und, was k3s selbst per Helm-Controller mitbringt (zum Beispiel Traefik, konfiguriert über helmchartconfig.yaml). TODO: prüfen, welche Releases helm list -A im Cluster tatsächlich zeigt. Für ArgoCD-Apps ist ArgoCD die richtige Ansicht. Hintergrund: Helm-Charts und ArgoCD.
Debugging und Fehlersuche
| Meldung | Ursache | Lösung |
|---|---|---|
helm ist nicht installiert oder nicht im PATH |
Helm fehlt | installieren |
Kubernetes cluster unreachable: … (Fehlertext von helm) |
falscher Kontext oder Cluster nicht erreichbar | kubectl config current-context, siehe Kubernetes |
Zeitüberschreitung bei: helm list -A -o json --max 500 |
API-Server langsam (Timeout 30 Sekunden) | Verbindung prüfen |
Ungültige Ausgabe von: helm list … |
Ausgabe ist kein JSON | Befehl direkt ausführen, helm-Version prüfen |
Tabelle leer (0 Releases) |
keine Helm-Releases im Cluster, siehe Hinweis oben | normal bei reinem ArgoCD-Betrieb |
Release auf failed oder pending-upgrade |
abgebrochener Upgrade oder Installation | Historie und Status lesen, Ursache beheben, Rollback mit helm rollback außerhalb von cubi |
Menü Values zeigt Keine eigenen Values |
Release nutzt nur Chart-Defaults | helm get values <name> -n <ns> -a für alle Werte |
Checkliste: helm list -A direkt, helm status, bei Zugriffsproblemen kubectl auth can-i list secrets -A (Helm speichert Release-Daten in Secrets).
Allgemeines: Debugging und Fehlersuche.