205 lines
6.0 KiB
Markdown
205 lines
6.0 KiB
Markdown
# Deployment Dokumentation - Index
|
|
|
|
**Stand:** 2025-11-01
|
|
**Status:** ? Vollst?ndige Dokumentation vorhanden
|
|
|
|
---
|
|
|
|
## ?? Schnellstart
|
|
|
|
### F?r schnellen Einstieg
|
|
|
|
1. **[quick-start.md](guides/quick-start.md)** ?
|
|
- Schnellstart-Guide
|
|
- Pipeline-Status pr?fen
|
|
- Troubleshooting Quick Reference
|
|
|
|
2. **[code-change-workflow.md](guides/code-change-workflow.md)**
|
|
- Wie Code?nderungen gepusht werden
|
|
- Automatisches vs. manuelles Deployment
|
|
- Branching-Strategien
|
|
- Beispiel-Workflows
|
|
|
|
---
|
|
|
|
## ?? Detaillierte Guides
|
|
|
|
### Setup & Konfiguration
|
|
|
|
3. **[setup-guide.md](guides/setup-guide.md)**
|
|
- Kompletter Setup-Guide von Anfang bis Ende
|
|
- Infrastructure Deployment
|
|
- Gitea Runner Setup
|
|
- Secrets Konfiguration
|
|
- Schritt-f?r-Schritt Anleitung
|
|
|
|
4. **[deployment-commands.md](guides/deployment-commands.md)**
|
|
- Command-Referenz f?r Deployment
|
|
- Ansible Playbook Befehle
|
|
- Docker Compose Kommandos
|
|
- Troubleshooting Kommandos
|
|
|
|
5. **[vault-password.md](guides/vault-password.md)**
|
|
- Ansible Vault Password Dokumentation
|
|
- Setup und Verwaltung
|
|
- CI/CD Integration
|
|
- Best Practices
|
|
|
|
### Deployment-Prozess
|
|
|
|
6. **[application-stack.md](reference/application-stack.md)**
|
|
- Detaillierter Deployment-Ablauf Schritt f?r Schritt
|
|
- Was passiert bei jedem Deployment
|
|
- Container-Neustart Details
|
|
- Rollback-Prozess
|
|
- Troubleshooting
|
|
|
|
---
|
|
|
|
## ?? Status & ?bersicht
|
|
|
|
### Projekt-Status
|
|
|
|
7. **[deployment-summary.md](status/deployment-summary.md)**
|
|
- Was ist fertig?
|
|
- Was fehlt noch?
|
|
- Completion Rate
|
|
- N?chste Schritte
|
|
|
|
8. **[deployment-todo.md](status/deployment-todo.md)**
|
|
- Aktuelle TODO-Liste
|
|
- Priorisierte Reihenfolge
|
|
- Quick Checklist
|
|
|
|
### CI/CD Pipeline
|
|
|
|
9. **[ci-cd-status.md](status/ci-cd-status.md)**
|
|
- Aktueller CI/CD Status
|
|
- Secrets-?bersicht
|
|
- Runner-Status
|
|
- Checkliste f?r Completion
|
|
- Troubleshooting
|
|
|
|
### Verbesserungen & Planung
|
|
|
|
10. **[improvements.md](status/improvements.md)**
|
|
- Verbesserungsvorschl?ge
|
|
- Refactoring-Ideen
|
|
- Architektur-?berlegungen
|
|
|
|
11. **[next-steps.md](status/next-steps.md)**
|
|
- Geplante n?chste Schritte
|
|
- Roadmap
|
|
- Priorit?ten
|
|
|
|
---
|
|
|
|
## ?? Stack-spezifische Dokumentation
|
|
|
|
### Infrastructure Stacks
|
|
|
|
- **[stacks/traefik/README.md](../stacks/traefik/README.md)** - Reverse Proxy & SSL
|
|
- **[stacks/postgresql/README.md](../stacks/postgresql/README.md)** - Database mit Backups
|
|
- **[stacks/registry/README.md](../stacks/registry/README.md)** - Private Docker Registry
|
|
- **[stacks/gitea/README.md](../stacks/gitea/README.md)** - Git Server & CI/CD
|
|
- **[stacks/monitoring/README.md](../stacks/monitoring/README.md)** - Monitoring Tools
|
|
|
|
### Application Stack
|
|
|
|
- **[stacks/application/README.md](../stacks/application/README.md)** - Application Stack Details
|
|
- **[ansible/README.md](../ansible/README.md)** - Ansible Playbooks Dokumentation
|
|
|
|
### CI/CD
|
|
|
|
- **[gitea-runner/README.md](../gitea-runner/README.md)** - Gitea Runner Setup
|
|
- **[.gitea/workflows/production-deploy.yml](../../.gitea/workflows/production-deploy.yml)** - Haupt-Deployment-Pipeline
|
|
- **[.gitea/workflows/system-maintenance.yml](../../.gitea/workflows/system-maintenance.yml)** - Geplante System-Wartung & Paketupdates
|
|
|
|
---
|
|
|
|
## ?? Security & VPN
|
|
|
|
- **[vault-password.md](guides/vault-password.md)** - Ansible Vault Password Dokumentation
|
|
- **[docs/WIREGUARD-SETUP.md](../../docs/WIREGUARD-SETUP.md)** - WireGuard VPN Setup
|
|
- **[ansible/playbooks/README-WIREGUARD.md](../ansible/playbooks/README-WIREGUARD.md)** - WireGuard Ansible Playbooks
|
|
|
|
---
|
|
|
|
## ?? Troubleshooting
|
|
|
|
### Workflow-Probleme
|
|
|
|
- **[workflow-troubleshooting.md](reference/workflow-troubleshooting.md)** - Workflow Troubleshooting
|
|
- **[quick-start.md](guides/quick-start.md)** - Troubleshooting Quick Reference
|
|
|
|
### Staging-Probleme
|
|
|
|
- **[staging-502-nginx-phpfpm.md](troubleshooting/staging-502-nginx-phpfpm.md)** - Staging 502 Bad Gateway: Nginx kann nicht zu PHP-FPM verbinden
|
|
|
|
### Test-Dokumentation
|
|
|
|
- **[test-results.md](tests/test-results.md)** - Test Ergebnisse
|
|
- **[git-deployment-test.md](tests/git-deployment-test.md)** - Git Deployment Tests
|
|
- **[git-deployment-issue.md](tests/git-deployment-issue.md)** - Git Deployment Issues
|
|
- **[test-git-deployment.md](tests/test-git-deployment.md)** - Git Deployment Test Guide
|
|
- **[quick-test.md](tests/quick-test.md)** - Quick Tests
|
|
- **[recommended-test-flow.md](tests/recommended-test-flow.md)** - Empfohlene Test-Workflows
|
|
|
|
---
|
|
|
|
## ?? Historie & Logs
|
|
|
|
- **[cleanup-log.md](history/cleanup-log.md)** - Cleanup Log
|
|
- **[cleanup-summary.md](history/cleanup-summary.md)** - Cleanup Zusammenfassung
|
|
|
|
---
|
|
|
|
## ?? Haupt-Dokumentation
|
|
|
|
- **[README.md](../README.md)** - Haupt-Dokumentation & Architektur-?bersicht
|
|
|
|
---
|
|
|
|
## ?? Empfohlene Lesereihenfolge
|
|
|
|
### F?r neue Nutzer
|
|
|
|
1. **[quick-start.md](guides/quick-start.md)** - Schneller ?berblick
|
|
2. **[code-change-workflow.md](guides/code-change-workflow.md)** - Code deployen lernen
|
|
3. **[deployment-summary.md](status/deployment-summary.md)** - Projekt-Status verstehen
|
|
|
|
### F?r Deployment-Verst?ndnis
|
|
|
|
1. **[application-stack.md](reference/application-stack.md)** - Wie Deployment funktioniert
|
|
2. **[ci-cd-status.md](status/ci-cd-status.md)** - CI/CD Pipeline verstehen
|
|
3. **[setup-guide.md](guides/setup-guide.md)** - Komplette Setup-Anleitung
|
|
|
|
### F?r Troubleshooting
|
|
|
|
1. **[quick-start.md](guides/quick-start.md)** - Quick Troubleshooting
|
|
2. **[workflow-troubleshooting.md](reference/workflow-troubleshooting.md)** - Workflow-Probleme
|
|
3. **[staging-502-nginx-phpfpm.md](troubleshooting/staging-502-nginx-phpfpm.md)** - Staging 502 Fehler (Nginx/PHP-FPM)
|
|
4. Stack-spezifische READMEs f?r Details
|
|
|
|
---
|
|
|
|
## ?? Dokumentations-Standards
|
|
|
|
**Alle Dokumentationsdateien:**
|
|
- Verwenden Markdown-Format
|
|
- Haben klare ?berschriften-Struktur
|
|
- Enthalten Code-Beispiele
|
|
- Haben Troubleshooting-Abschnitte (wenn relevant)
|
|
- Verlinken zu verwandten Dokumenten
|
|
|
|
**Standards:**
|
|
- ? Beispiele sind ausf?hrbar
|
|
- ? Pfade sind absolut oder relativ klar
|
|
- ? Screenshots/Links sind aktuell
|
|
- ? Status ist klar markiert (?/??/?)
|
|
|
|
---
|
|
|
|
**Letzte Aktualisierung:** 2025-11-01
|
|
**Status:** ? Dokumentation vollst?ndig
|