test: CI/CD pipeline staging test - Repository Setup automatisiert

deployment/ansible/playbooks/README.md

@@ -0,0 +1,65 @@
+# Ansible Playbooks - Übersicht
+
+## Verfügbare Playbooks
+
+### Infrastructure Setup
+- **`setup-infrastructure.yml`** - Deployed alle Stacks (Traefik, PostgreSQL, Redis, Registry, Gitea, Monitoring, Production)
+- **`setup-production-secrets.yml`** - Deployed Secrets zu Production
+- **`setup-ssl-certificates.yml`** - SSL Certificate Setup
+- **`setup-wireguard-host.yml`** - WireGuard VPN Setup
+- **`sync-stacks.yml`** - Synchronisiert Stack-Konfigurationen zum Server
+
+### Deployment & Updates
+- **`rollback.yml`** - Rollback zu vorheriger Version
+- **`backup.yml`** - Erstellt Backups von PostgreSQL, Application Data, Gitea, Registry
+- **`deploy-image.yml`** - Docker Image Deployment (wird von CI/CD Workflows verwendet)
+
+### Maintenance
+- **`system-maintenance.yml`** - System-Updates, Unattended-Upgrades, Docker-Pruning
+- **`troubleshoot.yml`** - Unified Troubleshooting mit Tags
+- **`update-gitea-config.yml`** - Aktualisiert Gitea-Konfiguration und startet neu
+
+### WireGuard
+- **`generate-wireguard-client.yml`** - Generiert WireGuard Client-Config
+- **`wireguard-routing.yml`** - Konfiguriert WireGuard Routing
+
+### Initial Deployment
+- **`sync-application-code.yml`** - Rsync-basiertes Code-Sync für Initial Deployment (synchronisiert Code vom lokalen Repository zum Server)
+- **`deploy-application-code.yml`** - Git-basiertes Code-Deployment (für CI/CD und zukünftige Deployments)
+- **`install-composer-dependencies.yml`** - Installiert Composer Dependencies im PHP Container
+- **`build-initial-image.yml`** - Build und Push des initialen Docker Images (für erstes Deployment)
+
+### Code Deployment
+- **`sync-application-code.yml`** - Rsync-basiertes Code-Sync (Initial Deployment)
+- **`deploy-application-code.yml`** - Git-basiertes Code-Deployment (CI/CD)
+- **`deploy-image.yml`** - Docker Image Deployment zu Application Stack
+
+### Troubleshooting & Diagnostics
+- **`check-container-logs.yml`** - Container Logs prüfen (queue-worker, web, scheduler)
+- **`check-container-status.yml`** - Container Status prüfen
+- **`check-final-status.yml`** - Finale Status-Prüfung aller Container
+- **`fix-container-issues.yml`** - Container-Probleme beheben (Composer Dependencies, Permissions)
+- **`fix-web-container.yml`** - Web Container Permissions beheben
+- **`recreate-containers-with-env.yml`** - Container mit env_file neu erstellen
+- **`sync-and-recreate-containers.yml`** - Docker Compose sync und Container recreate
+
+### CI/CD & Development
+- **`setup-gitea-runner-ci.yml`** - Gitea Runner CI Setup
+- **`setup-gitea-initial-config.yml`** - Gitea Initial Setup (automatisiert via app.ini + CLI)
+- **`setup-gitea-repository.yml`** - Erstellt Repository in Gitea und konfiguriert Git-Remote (automatisiert via API)
+- **`install-docker.yml`** - Docker Installation auf Server
+
+## Entfernte/Legacy Playbooks
+
+Die folgenden Playbooks wurden entfernt, da sie nicht mehr benötigt werden:
+- ~~`build-and-push.yml`~~ - Wird durch CI/CD Pipeline ersetzt
+- ~~`remove-framework-production-stack.yml`~~ - Temporäres Playbook
+- ~~`remove-temporary-grafana-ip.yml`~~ - Temporäres Playbook
+
+## Verwendung
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml playbooks/<playbook>.yml
+```
+