michaelschiemer/deployment/docs/guides/pipeline-testing-guide.md

CI/CD Pipeline Testing Guide

Stand: 2025-11-07
Status: Anleitung für End-to-End Pipeline-Tests

---

Übersicht

Dieses Dokument erklärt, wie die CI/CD Pipeline getestet wird. Die Tests sollten sowohl für Staging als auch für Production durchgeführt werden.

📖 Verwandte Dokumentation:

• Pipeline Test Checklist ⭐ - Detaillierte Schritt-für-Schritt Checkliste
• CI/CD Workflow Guide - Workflow-Dokumentation
• CI/CD Status - Aktueller Status
• Troubleshooting Guide - Probleme und Lösungen

🔧 Test-Scripts:

• deployment/scripts/test-pipeline-prerequisites.sh - Prüft alle Voraussetzungen für Pipeline-Tests

---

Voraussetzungen prüfen

Schnellcheck mit Script:

cd /home/michael/dev/michaelschiemer
./deployment/scripts/test-pipeline-prerequisites.sh

Dieses Script prüft automatisch alle Voraussetzungen und gibt eine Zusammenfassung aus.

1. Secrets konfiguriert

Erforderliche Secrets in Gitea:

• ✅ REGISTRY_USER - Docker Registry Benutzername
• ✅ REGISTRY_PASSWORD - Docker Registry Passwort
• ✅ SSH_PRIVATE_KEY - SSH Private Key für Production-Server
• ✅ ANSIBLE_VAULT_PASSWORD - Ansible Vault Password

Prüfen:

https://git.michaelschiemer.de/michael/michaelschiemer/settings/secrets/actions

2. Gitea Runner läuft

Prüfen:

cd deployment/gitea-runner
docker compose ps

Erwartet:

• gitea-runner: Up
• gitea-runner-dind: Up

In Gitea UI prüfen:

https://git.michaelschiemer.de/admin/actions/runners

Runner sollte als "Idle" oder "Active" angezeigt werden.

3. Application Stack läuft

Prüfen:

ssh deploy@94.16.110.151
cd ~/deployment/stacks/production
docker compose -f docker-compose.base.yml -f docker-compose.production.yml ps

Erwartet:

• Alle Container: Up (healthy)

---

Staging Pipeline Test

Schritt 1: Test-Commit erstellen

# Auf staging Branch
git checkout staging
git pull origin staging

# Kleine Änderung
echo "# Test CI/CD Pipeline - $(date)" >> README.md
git add README.md
git commit -m "test: CI/CD pipeline test"
git push origin staging

Schritt 2: Pipeline beobachten

Gitea Actions UI:

https://git.michaelschiemer.de/michael/michaelschiemer/actions

Erwartete Jobs:

1. changes - Prüft ob Build notwendig ist
2. test - Führt Tests aus
3. build - Baut Docker Image
4. deploy-staging - Deploy zu Staging

Schritt 3: Verifikation

Code-Deployment:

ssh deploy@94.16.110.151
cd /home/deploy/michaelschiemer/current
git log -1  # Sollte Test-Commit zeigen

Composer Dependencies:

docker compose -f docker-compose.base.yml -f docker-compose.production.yml \
  exec php test -f /var/www/html/vendor/autoload.php && echo "EXISTS"

Image-Deployment:

docker compose -f docker-compose.base.yml -f docker-compose.production.yml \
  ps  # Container sollten mit neuem Image laufen

Health-Check:

curl -f https://staging.michaelschiemer.de/health

Schritt 4: Fehler beheben

Falls Fehler auftreten:

1. Logs in Gitea Actions UI prüfen
2. Container Logs prüfen: docker compose logs
3. Siehe Troubleshooting Guide

---

Production Pipeline Test

Schritt 1: Test-Commit erstellen

Wichtig: Nur nach erfolgreichem Staging-Test!

# Auf main Branch
git checkout main
git pull origin main

# Merge staging (oder direkter Commit für Test)
echo "# Test CI/CD Pipeline Production - $(date)" >> README.md
git add README.md
git commit -m "test: CI/CD pipeline production test"
git push origin main

Schritt 2: Pipeline beobachten

Gitea Actions UI:

https://git.michaelschiemer.de/michael/michaelschiemer/actions

Erwartete Jobs:

1. changes - Prüft ob Build notwendig ist
2. test - Führt Tests aus
3. build - Baut Docker Image
4. deploy-production - Deploy zu Production

Schritt 3: Verifikation

Gleiche Checks wie Staging:

• Code-Deployment verifizieren
• Composer Dependencies verifizieren
• Image-Deployment verifizieren
• Health-Check durchführen

Production URL:

curl -f https://michaelschiemer.de/health

Schritt 4: Rollback-Test (Optional)

Falls Deployment fehlschlägt:

cd deployment/ansible
ansible-playbook -i inventory/production.yml \
  playbooks/rollback.yml \
  --vault-password-file secrets/.vault_pass

---

Manueller Workflow-Test

Via Gitea UI

Schritte:

1. Gehe zu: https://git.michaelschiemer.de/michael/michaelschiemer/actions
2. Wähle: "Manual Deployment"
3. Klicke: "Run workflow"
4. Wähle:
   • Environment: staging oder production
   • Image Tag: Optional (z.B. latest oder git-abc1234)
   • Branch: Optional
5. Klicke: "Run workflow"
6. Beobachte Logs

---

Checkliste für erfolgreichen Test

Staging Test

• Test-Commit gepusht
• Pipeline gestartet
• Alle Jobs erfolgreich:
  • changes
  • test
  • build
  • deploy-staging
• Code-Deployment erfolgreich
• Composer Dependencies installiert
• Image-Deployment erfolgreich
• Health-Check erfolgreich
• Application läuft korrekt

Production Test

• Staging Test erfolgreich
• Test-Commit auf main gepusht
• Pipeline gestartet
• Alle Jobs erfolgreich:
  • changes
  • test
  • build
  • deploy-production
• Code-Deployment erfolgreich
• Composer Dependencies installiert
• Image-Deployment erfolgreich
• Health-Check erfolgreich
• Application läuft korrekt

---

Bekannte Probleme & Workarounds

Problem: Pipeline startet nicht

Ursache: Runner läuft nicht oder ist nicht registriert

Lösung:

cd deployment/gitea-runner
docker compose restart gitea-runner
# Prüfe Runner-Status in Gitea UI

Problem: Code-Deployment schlägt fehl

Ursache: Git Repository existiert nicht auf Server

Lösung:

# Initial Deployment durchführen
ansible-playbook -i inventory/production.yml \
  playbooks/sync-application-code.yml \
  --vault-password-file secrets/.vault_pass

Problem: Image-Deployment schlägt fehl

Ursache: Registry Login fehlgeschlagen

Lösung:

• Prüfe REGISTRY_USER und REGISTRY_PASSWORD Secrets
• Teste Registry Login manuell

Problem: Health-Check schlägt fehl

Ursache: Container starten nicht oder Application hat Fehler

Lösung:

• Prüfe Container Status
• Prüfe Container Logs
• Siehe Troubleshooting Guide

---

Referenz

• CI/CD Workflow Guide - Workflow-Dokumentation
• CI/CD Status - Aktueller Status
• Troubleshooting Guide - Probleme und Lösungen
• Backup & Rollback Guide - Rollback-Prozess