PKR-Lab

ArgoCD

Quelle: pkr-lab/pkr-lab-docs/cubi/argocd.md

ArgoCD

Tabelle aller ArgoCD-Applications mit Sync- und Health-Status, Filter, Sync, Diff, Refresh und Verknüpfung zu GitHub.

Code: modules/argocd.py, argocd_apps.py, argocd_config.py

Die Änderungs-Features (Auto-Sync, Feature-Testing, Pods skalieren) stehen in ArgoCD-Features. Wie ArgoCD im Homelab aufgebaut ist: ArgoCD, AppProjects.


Überblick

cubi argocd (argo) liest die Custom Resources applications.argoproj.io im ArgoCD-Namespace (argocd.namespace, Standard argocd) direkt per kubectl get … -o json. Es braucht dafür keinen ArgoCD-Login und funktioniert, auch wenn der ArgoCD-Server nicht läuft. Nur Diff, Sync, Refresh und Historie rufen die argocd-CLI auf und brauchen den Login (Login).

Die Tabelle lädt alle 10 Sekunden neu.

Spalte Quelle
App metadata.name
Projekt spec.project (sonst default)
Sync status.sync.status: Synced grün, OutOfSync gelb, Unknown magenta
Health status.health.status: Healthy grün, Progressing gelb, Degraded und Missing rot, Suspended cyan, Unknown magenta

Sortierung: schlechtester Zustand zuerst (Degraded vor OutOfSync vor Missing vor Progressing …, dann nach Name). Über der Tabelle zählt cubi die Zustände (Sync Synced 30 · OutOfSync 1, Health Healthy 28 · …). OutOfSync und Degraded erscheinen immer, auch mit 0.


Tasten

Taste Wirkung
Enter Menü der App
f Filter: alle Apps, nur Probleme (nicht Synced oder nicht Healthy), oder ein Projekt
c ArgoCD-Kontext der CLI wechseln (argocd context <name>)
m mehrere Apps synchronisieren (vorgewählt: alle OutOfSync), argocd app sync <namen…> nach Rückfrage
s Auto-Sync
t Feature-Testing
z Pods skalieren
r neu laden
Esc zurück

Menü einer App

Eintrag Befehl
Details zeigt aus der Application-Ressource Projekt, Ziel-Namespace, Sync, Revision (10 Zeichen), Health inklusive Meldung, Repo, Pfad, Ziel-Revision, Sync-Policy, letzten Sync (Phase, Alter, Meldung), Bedingungen und betroffene Ressourcen (nicht Synced oder nicht Healthy)
Sync argocd app sync <name> nach Rückfrage
Refresh argocd app get <name> --refresh
Hard Refresh argocd app get <name> --hard-refresh (verwirft den Manifest-Cache)
Diff argocd app diff <name> (Keine Unterschiede, wenn leer)
Historie argocd app history <name>
Quelle auf GitHub letzte Commits für den Pfad der App, Link, siehe GitHub

Ablauf

flowchart TD
    A[cubi argocd] --> B["kubectl get applications.argoproj.io -n argocd -o json"]
    B -->|Fehler| E["✖ ArgoCD-Apps konnten nicht gelesen werden: …"]
    B --> C[Tabelle, Filter, Sortierung]
    C -->|Enter| D[App-Menü]
    D --> K[Details: nur Ressourcendaten, kein Login]
    D --> L[argocd CLI: Sync, Refresh, Diff, Historie]
    L -->|Auth-Fehler| H[Hinweis: Login erneuern]

Konfiguration

Schlüssel in targets.yaml Wirkung
argocd.namespace Namespace der Applications
argocd.contexts[] Zugänge für die Kontextwahl und den Login, siehe Konfiguration

Randfälle


Debugging und Fehlersuche

Meldung Ursache Lösung
ArgoCD-Apps konnten nicht gelesen werden: … kubectl kann Applications nicht lesen: falscher Kontext, keine Rechte, CRD fehlt, falscher Namespace kubectl get applications.argoproj.io -n argocd direkt prüfen, argocd.namespace kontrollieren, Kubernetes
kubectl ist nicht installiert oder nicht im PATH kubectl fehlt installieren
argocd ist nicht installiert oder nicht im PATH CLI fehlt (betrifft nur Diff, Sync, Refresh, Historie, Login) argocd installieren
Hinweis: Login abgelaufen oder fehlt. Im Hauptmenü unter Login erneuern. ArgoCD-CLI ohne gültigen Login Login
Zeitüberschreitung bei: argocd app … ArgoCD-Server nicht erreichbar (Timeout 90 Sekunden) Server, Port und VPN prüfen; zum Vergleich argocd.contexts[].server
FATA[…] rpc error … Unauthenticated Token abgelaufen Login
FATA[…] … connection refused falscher Server oder plaintext/insecure falsch server, plaintext, insecure in der Config
Keine Einträge in der Tabelle Filter aktiv, oder keine Apps im Namespace f → Alle Apps
App steht dauerhaft auf Unknown Repo nicht erreichbar oder Manifest-Fehler Details → Bedingungen; Hard Refresh; ArgoCD
App OutOfSync, Sync ändert nichts ignoreDifferences oder selfHeal-Konflikt Diff, siehe ArgoCD
App Degraded Ressource unhealthy (zum Beispiel Pod crasht) Details → Betroffene Ressourcen, danach Kubernetes → Pods, Logs

Checkliste „App ist nicht grün“:

  1. cubi argocd → Details: Meldung, Bedingungen, betroffene Ressourcen.
  2. Hard Refresh, dann Diff: was unterscheidet Git und Cluster?
  3. Bei Degraded: cubi kubernetes, Pod-Status, Describe, Logs.
  4. Bei Progressing länger als einige Minuten: Pod Pending (Node, PVC) oder Image nicht ziehbar.
  5. Passende Fachdoku: Dienste-Übersicht.

Allgemeines: Debugging und Fehlersuche.