initial demo

README.md

@@ -0,0 +1,111 @@
+# Argo CD + Git Demo Bundle
+
+Dieses Bundle setzt eine kleine Demo auf einem **bereits existierenden Kubernetes-Cluster** auf.
+
+Ziel der Demo:
+- Ein kleines **Git** im Cluster (Gitea)
+- **Argo CD** als GitOps-CD
+- Eine kleine **Helm-App**
+- Ein sichtbarer **Upgrade-Flow nur über Git/Helm values**
+
+## Architektur
+- Namespace `gitea`: internes Demo-Git
+- Namespace `argocd`: Argo CD
+- Namespace `demo-app`: Demo-Anwendung
+
+## Voraussetzung
+- `kubectl` Zugriff auf den Cluster
+- ausgehender Internetzugriff des Clusters auf Container-Images/Helm Charts
+- optional `helm`
+
+## Schnellstart
+1. Namespaces und Basis anlegen:
+   ```bash
+   kubectl apply -f bootstrap/namespaces.yaml
+   ```
+
+2. Gitea installieren:
+   ```bash
+   helm repo add gitea-charts https://dl.gitea.com/charts/
+   helm repo update
+   helm upgrade --install gitea gitea-charts/gitea \
+     -n gitea -f bootstrap/gitea-values.yaml
+   ```
+
+3. Argo CD installieren:
+   ```bash
+   kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
+   ```
+
+4. Warten bis Argo CD und Gitea laufen:
+   ```bash
+   kubectl -n argocd rollout status deploy/argocd-server --timeout=300s
+   kubectl -n gitea rollout status statefulset/gitea-postgresql --timeout=300s || true
+   kubectl -n gitea rollout status deploy/gitea-http --timeout=300s || true
+   ```
+
+5. Gitea lokal erreichbar machen:
+   ```bash
+   kubectl -n gitea port-forward svc/gitea-http 3000:3000
+   ```
+   Dann im Browser `http://localhost:3000` öffnen.
+
+6. Initialen Admin-User anlegen (falls Setup-Seite erscheint) oder vorhandene Logins nutzen.
+
+7. Ein neues Repo erstellen, z. B. `gitops-demo`.
+
+8. Dieses Bundle in euer Repo pushen:
+   ```bash
+   git init
+   git branch -M main
+   git add .
+   git commit -m "initial demo"
+   git remote add origin http://localhost:3000/<ORG_OR_USER>/gitops-demo.git
+   git push -u origin main
+   ```
+
+9. Argo CD Repo-Secret anpassen:
+   - Datei `argocd/repo-secret.yaml`
+   - `url`, `username`, `password` auf euer Gitea-Repo setzen
+
+10. Repo-Secret und App deployen:
+   ```bash
+   kubectl apply -f argocd/repo-secret.yaml
+   kubectl apply -f argocd/project.yaml
+   kubectl apply -f apps/demo-app.yaml
+   ```
+
+11. Argo CD UI öffnen:
+   ```bash
+   kubectl -n argocd port-forward svc/argocd-server 8080:443
+   ```
+   UI: `https://localhost:8080`
+
+   Admin-Passwort:
+   ```bash
+   kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath='{.data.password}' | base64 -d; echo
+   ```
+
+## Demo-Flow für Kundentermin
+1. Zeige in Gitea die Datei `charts/demo-app/values.yaml`
+2. In Argo CD ist die App `Healthy/Synced`
+3. Ändere z. B.:
+   - `image.tag: "1.25"` -> `"1.27"`
+   - oder `replicaCount: 1` -> `2`
+   - oder `message: "v1"` -> `"v2 upgraded by gitops"`
+4. Commit + Push
+5. Argo CD erkennt die Git-Änderung und rollt aus
+6. Zeige in Kubernetes:
+   ```bash
+   kubectl -n demo-app get deploy,pods,svc,cm
+   kubectl -n demo-app rollout status deploy/demo-app
+   ```
+
+## Sauberer Upgrade-Nachweis
+- **Git ist die einzige Wahrheit**: Keine direkte Cluster-Änderung
+- Änderung nur im Repo
+- Argo CD erkennt Drift und synchronisiert
+- Rollout sauber über Deployment-Update
+
+## Optional: Image Updater
+Wenn ihr in einer zweiten Demo auch zeigen wollt, wie neue Container-Tags automatisch in Git zurückgeschrieben werden, könnt ihr zusätzlich Argo CD Image Updater evaluieren. Für diese Demo ist er nicht nötig.