Rolle `argocd`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/argocd.md
Rolle argocd
ArgoCD per Helm, Bootstrap-ApplicationSet und -Projects, Namespace-Labels, NetworkPolicies.
| Läuft gegen | controlplane-0 (Hub), entw-vm |
| Tags | argocd, gitops |
| Quellcode | roles/argocd |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
argocd_entw_layout |
false |
– |
argocd_ci_account_enabled |
true |
– |
argocd_ingress_enabled |
false |
– |
argocd_ui_host |
`` | – |
argocd_ingress_tls_crt |
`` | – |
argocd_ingress_tls_key |
`` | – |
argocd_server_nodeport_enabled |
true |
– |
argocd_platform_apps |
[alert-caller, sealed-secrets, kubeseal-webgui, lldap, monitoring, logging, ntfy, ntfy-… |
– |
argocd_workloads_apps |
[alamos-apager, alamos-relay, carplay-api, github-release-watcher, isc-news-bot, mediam… |
– |
argocd_apply_network_policies |
true |
– |
argocd_network_policy_refined_namespaces |
[alert-caller, n8n, alamos-apager, alamos-relay, carplay-api, github-release-watcher, i… |
– |
argocd_network_policy_excluded_apps |
[] |
– |
argocd_network_policy_extra_ingress |
{garage: [argo-workflows], monitoring: [carplay-api, n8n, argo-workflows], n8n: [alamos-… |
– |
Ablauf
- argocd-namespace anlegen (idempotent)
- argo-helm-repository hinzufügen
- helm-repositories aktualisieren
- helm-werte für argocd nach /tmp templaten
- tls-secret für den ingress anlegen
- argocd per helm installieren oder aktualisieren
- status des helm-releases anzeigen
- warten bis das argocd-server-deployment verfügbar ist
- warten bis alle argocd-pods bereit sind
- prüfen ob das initiale admin-secret existiert
- initiales argocd-admin-passwort lesen
- initiale argocd-zugangsdaten anzeigen (passwort verborgen)
- initiale argocd-zugangsdaten anzeigen (passwort sichtbar)
- bootstrap-appprojects templaten
- bootstrap-appprojects anwenden
- alte applicationsets platform/workloads entfernen (entw-layout)
- bootstrap-applicationset templaten
- bootstrap-applicationset anwenden
- alte appprojects platform/workloads entfernen (entw-layout)
- status der applicationsets anzeigen
- warten bis die applicationsets verarbeitet sind
- angelegte applications auflisten
- applications anzeigen
- namespaces der platform-stufe mit security-tier=platform labeln
- namespaces der workloads-stufe mit security-tier=workload labeln
- vorhandene namespaces lesen
- vorhandene namespaces als fakt setzen
- networkpolicies tier-default-ingress templaten
- networkpolicies tier-default-ingress anwenden
- temporäre helm-wertedatei entfernen
Templates
argocd-values.yaml.j2bootstrap-applicationset.yaml.j2bootstrap-appprojects.yaml.j2bootstrap-networkpolicies.yaml.j2
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
kubectl -n argocd get pods,applications.argoproj.io,applicationsets.argoproj.io
helm -n argocd status argocd
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d; echo
| Symptom | Ursache | Lösung |
|---|---|---|
| Helm-Install scheitert oder wartet ewig | Pods starten nicht (Ressourcen, Image), helm upgrade --install Timeout (Retries in der Rolle) |
kubectl -n argocd get pods, describe, Task-Ausgabe |
| Keine Applications nach der Rolle | Bootstrap-ApplicationSet nicht angewendet oder Repo-URL falsch (argocd_repo_url) |
kubectl -n argocd describe applicationset home-server-apps-tech, ArgoCD: Fehlersuche |
Neue App wird abgelehnt (not permitted in project) |
Namespace fehlt in argocd_platform_apps oder argocd_workloads_apps |
Liste ergänzen, make render-bootstrap CORE_DIR=…, committen (AppProjects) |
| Initial-Passwort nicht auffindbar | Secret argocd-initial-admin-secret wurde gelöscht oder das Passwort geändert |
ArgoCD: Initial-Credentials |
| UI nicht erreichbar | Ingress oder TLS-Secret (argocd_ingress_tls_crt, argocd_ingress_tls_key), NodePort |
kubectl -n argocd get ingress,svc, Internes TLS |
| NetworkPolicies blockieren Verkehr | argocd_apply_network_policies: true mit fehlender Quelle |
Network Policies |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.