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
- Der Kontext von
kubectlmuss auf den Cluster mit ArgoCD zeigen. Die Kontextwahl in cubi (c) betrifft nur dieargocd-CLI, nichtkubectl(Kubernetes fürkubectl). - Apps mit mehreren Sources zeigen in Ansichten die erste Source als Repo und Pfad.
- Apps, die ein ApplicationSet oder eine übergeordnete App verwaltet, überschreiben Änderungen. Dazu ArgoCD-Features.
RefreshundHard Refreshsind Aufrufe vonargocd app get: Sie lösen einen neuen Abgleich mit Git aus, ändern aber nichts am Cluster.
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“:
cubi argocd→ Details: Meldung, Bedingungen, betroffene Ressourcen.- Hard Refresh, dann Diff: was unterscheidet Git und Cluster?
- Bei
Degraded:cubi kubernetes, Pod-Status, Describe, Logs. - Bei
Progressinglänger als einige Minuten: PodPending(Node, PVC) oder Image nicht ziehbar. - Passende Fachdoku: Dienste-Übersicht.
Allgemeines: Debugging und Fehlersuche.