b0050 - ENTW-ArgoCD — eigener Ordner `argocd/apps/entw/`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/b-kubernetes-gitops/b0050-entw-argocd.md
ENTW-ArgoCD — eigener Ordner argocd/apps/entw/
Der ENTW-Cluster (KVM-VM entw-vm auf worker-1, 192.168.178.100) hat eine
eigene, eigenständige ArgoCD-Instanz (siehe
40080, Baustein 1).
Sie liest ausschließlich den Ordner argocd/apps/entw/ auf dem Branch
entw. Wer dort einen Unterordner anlegt, deployt auf ENTW und nirgends sonst.
Architektur
flowchart LR
B1["Branch entw"] -->|"argocd/apps/entw/*"| E["ArgoCD ENTW<br/>Projekt entw"]
B2["Branch main"] -->|"argocd/apps/tech/*"| T["ArgoCD TECH (Hub)<br/>Projekt tech"]
B2 -->|"argocd/apps/prod/*"| P["ArgoCD TECH → PROD<br/>Projekt prod"]
E --> EC["ENTW-Cluster<br/>entw-vm"]
T --> TC["TECH-Cluster<br/>homeserver"]
P --> PC["PROD-Cluster<br/>prod-vm"]
Die Trennung hat drei voneinander unabhängige Ebenen:
| Ebene | Wodurch | Wirkung |
|---|---|---|
| Branch | ENTW liest entw, TECH und PROD lesen main |
Ein Commit auf entw wird von TECH und PROD nie gesehen. |
| Ordner | Die ApplicationSets von TECH (argocd/apps/tech/*) und PROD (argocd/bootstrap-prod/applicationset.yaml, nur argocd/apps/prod/…) nennen den Pfad entw/ nirgends |
Landet der Ordner (etwa durch die Promotion) doch auf main, erzeugt er in TECH und PROD keine Application. |
| Cluster | ENTW-ArgoCD kennt nur https://kubernetes.default.svc (den eigenen Cluster), es gibt kein cluster-Secret zu TECH oder PROD |
Selbst ein Fehler im ENTW-Ordner kann TECH und PROD nicht erreichen. |
Auf entw gelten die Rulesets entw-1 (kein Löschen, kein Force-Push), entw-2 (nur per PR, Admin-Bypass)
und Protect MAIN (PR-Pflicht ohne Bypass): Änderungen kommen daher immer per PR, siehe
f0080.
Die CI (helm template | kubeconform) prüft den Ordner erst beim Promotion-Lauf
gegen ref=entw, nicht schon im PR auf entw. Vor dem Push also lokal
helm template argocd/apps/entw/<app> ausführen.
Neue App auf ENTW deployen
- Ordner
argocd/apps/entw/<app>/anlegen, z. B. als Helm-Chart mit
Chart.yaml,values.yamlundtemplates/. Der Ordnername ist Application-
und Namespace-Name. - Ingress-Host unter
*.dev.homeserverwählen (dnsmasq leitet die Domain auf
die ENTW-VM, siehe c0000),
z. B.whoami.dev.homeserver. - Per PR auf den Branch
entwbringen (Protect MAINverlangt PRs auch für Admins). - Nach ca. 3 Minuten (Git-Polling) erscheint die Application in ArgoCD, der
Namespace wird angelegt (CreateNamespace=true).
Es gibt bewusst keine Namespace-Liste: das Projekt entw erlaubt jeden
Namespace und alle Ressourcentypen. ENTW ist die absichtlich verwundbare
Trainings-/Experimentierumgebung, Schutz kommt aus der Isolation des Clusters
(siehe host_vars/entw-vm/vars.yml),
nicht aus Einschränkungen im Projekt.
Ein Ordner wieder entfernen = Application wird pruned, die Ressourcen werden mit
gelöscht (prune: true).
ArgoCD-Oberfläche
| URL | https://argocd.dev.homeserver (Traefik-Ingress der ENTW-VM, Zertifikat aus der Homeserver-Root-CA, Service ClusterIP, server.insecure: true) |
| Benutzer | admin |
| Passwort | kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath='{.data.password}' \| base64 -d auf der ENTW-VM (ssh [email protected] 'sudo k3s kubectl …') |
Wie es konfiguriert ist
| Was | Wo |
|---|---|
Schalter argocd_entw_layout: true und Revision argocd_repo_revision: entw |
capulus-ansible/host_vars/entw-vm/vars.yml, Default false in capulus-ansible/roles/argocd/defaults/main.yml |
ApplicationSet home-server-apps-entw (Generator argocd/apps/entw/*, Revision entw) |
bootstrap-applicationset.yaml.j2, gerendert und angewendet von der argocd-Rolle |
AppProject entw (jeder Namespace, nur dieses Repo als Quelle) |
bootstrap-appprojects.yaml.j2 |
Die committeten TECH-Dateien argocd/bootstrap/* bleiben vom ENTW-Layout
unberührt (make render-bootstrap CORE_DIR=<Pfad zu capulus-core> rendert mit dem Standard der Rolle, dem TECH-Layout).
argocd_platform_apps/argocd_workloads_apps in den ENTW-Host-Vars steuern nur
noch security-tier-Label und Tier-NetworkPolicy der drei Bestands-Namespaces
(sealed-secrets, demo-app, example-whoami), nicht mehr, was deployt wird.
Neue Apps bekommen keine NetworkPolicy.
Rollout (einmalig, Umstellung vom Alt-Layout)
Reihenfolge ist wichtig, der Ordner muss auf entw liegen, bevor das
Playbook läuft. Sonst findet der neue Generator nichts, und die drei
Bestands-Apps (sealed-secrets, demo-app, example-whoami) laufen ohne
Application weiter, ohne dass ArgoCD sie noch verwaltet.
- Rollen-Änderung (Templates, Host-Vars, Doku) per PR nach
main. - Ordner
argocd/apps/entw/mit den drei Bestands-Apps auf den Branchentw
bringen (per PR, siehe Rulesets oben). - Playbook aus einem Checkout ausführen, der die Rollen-Änderung enthält:
ansible-playbook -i inventory/hosts.yml entw.yml --tags argocd --vault-password-file ~/.vault_pass
Die argocd-Rolle löscht dabei zuerst die alten ApplicationSets
home-server-apps-platform und home-server-apps-workloads (Alt-Layout
platform//workloads/ auf entw), wendet dann Projekt und ApplicationSet für
entw an und räumt die alten AppProjects platform/workloads weg. Die
Workloads laufen dabei weiter: das Template setzt keinen resources-finalizer,
die neuen gleichnamigen Applications übernehmen die vorhandenen Ressourcen. Die
alten Ordner argocd/apps/platform/ und workloads/ auf entw sind danach
ohne Funktion und können später entfernt werden.
Prüfen:
ssh [email protected] 'sudo k3s kubectl -n argocd get applicationsets,applications,appprojects'
Erwartet: ein ApplicationSet home-server-apps-entw, Applications demo-app,
example-whoami, sealed-secrets (Synced/Healthy), Projekte default und entw.
Auswirkung auf die Promotion-Pipeline
promote-entw.yml
cherry-pickt neue Commits vom Branch entw als PR nach main, überspringt aber Commits, die
ausschließlich argocd/apps/entw/ ändern: ein ENTW-Experiment erzeugt keinen PR mehr. (Der Ordner selbst liegt
seit dem Einführungs-Commit auch auf main, dort ist er harmlos, TECH und PROD lesen entw/ nie.) Andere
ENTW-spezifische Commits bekommen weiterhin [entw-only] in die Commit-Nachricht.
Die Version einer getesteten App wandert über die
Promotion-Kette nach argocd/apps/tech/ bzw. prod/:
image.tag und Chart-Abhängigkeiten, nach 24 h Gesundheit auf ENTW und mit optionalen Smoke-Checks
(argocd/promotion.yaml), Hosts und Templates bleiben unberührt. Renovate aktualisiert auf dem Branch entw
ausschließlich argocd/apps/entw/.
Troubleshooting
| Symptom | Hinweis |
|---|---|
| Neuer Ordner erscheint nicht | Nicht auf dem Branch entw (auf main allein reicht es nicht), oder Git-Polling (bis ca. 3 min). Sofort: kubectl -n argocd annotate applicationset home-server-apps-entw argocd.argoproj.io/application-set-refresh=true. |
Application Unknown/ComparisonError |
helm template argocd/apps/entw/<app> lokal ausführen; die CI macht dasselbe. |
namespace … is not permitted in project |
Läuft noch der alte Stand mit den Projekten platform/workloads? Rollout oben ausführen. |
| Alte Applications tauchen doppelt auf | Die alten ApplicationSets (home-server-apps-platform/-workloads) existieren noch: kubectl -n argocd delete applicationset home-server-apps-platform home-server-apps-workloads. |
| ArgoCD nicht erreichbar | VM läuft? ssh [email protected] 'sudo virsh list --all'; entw-vm muss running sein. |