michael/michaelschiemer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
38af81e2dbca3847bda57614a105b8cd0ce964ba
michaelschiemer/deployment/docs/README.md
Michael Schiemer 1b9cda6dd3
Some checks failed
🚀 Build & Deploy Image / Auto-deploy to Staging (push) Failing after 40s
Details
🚀 Build & Deploy Image / Auto-deploy to Production (push) Has been skipped
Details
🚀 Build & Deploy Image / Determine Build Necessity (push) Successful in 46s
Details
Security Vulnerability Scan / Check for Dependency Changes (push) Successful in 1m0s
Details
🚀 Build & Deploy Image / Build Runtime Base Image (push) Successful in 11s
Details
🚀 Build & Deploy Image / Run Tests & Quality Checks (push) Has been skipped
Details
Security Vulnerability Scan / Composer Security Audit (push) Has been skipped
Details
🚀 Build & Deploy Image / Build Docker Image (push) Successful in 12s
Details
docs: Add CI image setup documentation
2025-11-08 13:38:46 +01:00

232 lines
7.1 KiB
Markdown
Raw Blame History

# Deployment Dokumentation - Index
**Stand:** 2025-11-07
**Status:** ✅ Vollständige Dokumentation vorhanden (inkl. CI/CD, Backup & Rollback)
---
## ?? 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. **[server-directory-structure.md](server-directory-structure.md)**
- Erklärung der Server-Verzeichnisstruktur
- Unterschied zwischen `~/deployment/` und `~/michaelschiemer/`
- Verwendungszweck und Wartung
- Troubleshooting
5. **[deployment-commands.md](guides/deployment-commands.md)**
- Command-Referenz für Deployment
- Ansible Playbook Befehle
- Docker Compose Kommandos
- Troubleshooting Kommandos
6. **[cicd-workflow-guide.md](guides/cicd-workflow-guide.md)** ⭐
- CI/CD Workflow-Dokumentation
- Automatische und manuelle Deployments
- Ansible Playbooks in Workflows
- Troubleshooting
7. **[backup-and-rollback-guide.md](guides/backup-and-rollback-guide.md)**
- Backup-Strategie
- Rollback-Prozess
- Automatisierung
- Best Practices
7. **[pipeline-testing-guide.md](guides/pipeline-testing-guide.md)** ⭐
- End-to-End Pipeline-Tests
- Staging & Production Test-Anleitung
- Verifikation & Troubleshooting
8. **[vault-password.md](guides/vault-password.md)**
- Ansible Vault Password Dokumentation
- Setup und Verwaltung
- CI/CD Integration
- Best Practices
### Deployment-Prozess
9. **[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/production/README.md](../stacks/production/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
### Gitea & CI/CD Setup
- **[gitea-traefik-cicd-setup.md](troubleshooting/gitea-traefik-cicd-setup.md)** ⭐ - Komplette Anleitung: Gitea, Traefik & CI/CD Setup (alle Probleme und Lösungen)
### 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-07
**Status:** ✅ Dokumentation vollständig (inkl. CI/CD, Backup & Rollback)
Reference in New Issue View Git Blame Copy Permalink