b0090 - Beispiel-Apps — `demo-app` und `example-whoami`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/b-kubernetes-gitops/b0090-beispiel-apps.md
Beispiel-Apps — demo-app und example-whoami
Zwei kleine Apps zum Ausprobieren des GitOps-Ablaufs. Sie haben keinen Nutzen im Betrieb, zeigen aber, wie sich eine Änderung in Git im Cluster auswirkt, und dienen in der Promotion-Kette als harmlose Testfälle (f00b0).
Cluster: ENTW (beide, Ordner
argocd/apps/entw/), PROD (beide, Ordnerargocd/apps/prod/). Hosts:demo.dev.homeserver,whoami.dev.homeserver,demo.prod.homeserver,whoami.prod.homeserver. In TECH gibt es sie nicht. Zugriff je Cluster: a0010.
Überblick
| App | Image | Zweck |
|---|---|---|
demo-app |
hashicorp/http-echo:1.0.0 |
zeigt den Text aus der Umgebungsvariablen MESSAGE (message in values.yaml, Standard „Hello from GitOps - Version 1“). Dient der Self-Heal-Demo: Ein Eingriff per kubectl set env macht die App OutOfSync, ArgoCD setzt den Git-Stand zurück |
example-whoami |
traefik/whoami:v1.12.0 |
gibt Hostname, IP und Request-Header aus. Dient dem Test von Ingress, Wildcard-DNS, TLS und HPA |
| Eigenschaft | demo-app |
example-whoami |
| --- | --- | --- |
| Service | ClusterIP, Port 80 → 5678 | ClusterIP, Port 80 → 80 |
| Ingress | Klasse traefik, Host demo.<tier>.homeserver |
Klasse traefik, Host whoami.<tier>.homeserver |
| Replikas | ENTW: 1, PROD: 0 (bewusst abgeschaltet) | 1 mit HPA (1 bis 3 bei 70 % CPU) |
| Ressourcen | Limit 100m und 64 MiB | Request 10m und 16 MiB, Limit 100m und 64 MiB |
Die PROD-Kopie von demo-app ist mit replicaCount: 0 ausgerollt (Batch 1 der Migration, siehe 40080): Die Application ist grün, es läuft aber kein Pod, und demo.prod.homeserver antwortet nicht.
Self-Heal-Demo mit demo-app
kubectl port-forward svc/demo-app 8080:80 -n demo-app # http://localhost:8080
kubectl set env deployment/demo-app MESSAGE="Hier stand etwas anderes" -n demo-app
# ArgoCD zeigt OutOfSync, nach einigen Sekunden setzt Self-Heal zurück
Danach in ArgoCD (oder per cubi) beobachten, wie die App wieder Synced wird. Die Hinweise nach der Installation stehen in templates/NOTES.txt des Charts. Auf ENTW greift Self-Heal wie in b0050 beschrieben.
Fehlersuche
kubectl get pods,svc,ingress -n demo-app
kubectl get pods,svc,ingress,hpa -n example-whoami
curl -k https://whoami.dev.homeserver # bzw. whoami.prod.homeserver
| Symptom | Ursache | Lösung |
|---|---|---|
demo.prod.homeserver antwortet nicht, App ist grün |
PROD-replicaCount ist 0 |
Absicht. Zum Testen replicaCount in argocd/apps/prod/demo-app/values.yaml anheben |
| Hostname nicht auflösbar | DNS-Wildcard fehlt oder Gerät ohne internen DNS | DNS-Architektur, Domain-Tiers |
| Zertifikatswarnung | Root-CA nicht installiert | Internes TLS |
404 page not found |
Ingress fehlt oder Host falsch | kubectl get ingress -A, Traefik-Konfiguration |
demo-app ändert den Text nicht nach values.yaml-Änderung |
Pod nicht neu gestartet oder ArgoCD noch nicht synchron | ArgoCD-Sync abwarten, kubectl rollout restart deployment/demo-app -n demo-app |
App bleibt OutOfSync nach manuellem Eingriff |
Auto-Sync oder Self-Heal ist aus (zum Beispiel durch cubi autosync) |
cubi: ArgoCD-Features, Auto-Sync wieder aktivieren |
example-whoami: HPA zeigt <unknown> |
Metrics-Server liefert keine Werte | HPA |
| ENTW-App erscheint nicht in ArgoCD | Ordner nicht auf dem Branch entw |
b0050 |
Promotion überträgt demo-app-Änderung nicht |
nur Versionsfelder (image.tag) werden übertragen, keine message |
f00b0 |
Allgemeine Fehlersuche: zentrale Fehlersuche.