Status: Rejected Datum: 2025-12-31 Kontext: Lokale CI/CD-Pipeline-Ausführung Entscheider: Gernot
Kontext und Problem
Aquarius nutzt GitHub Actions für CI/CD:
- Linting (Ruff, ESLint)
- Tests (Pytest, Vitest)
- Builds (Docker Images)
- Deployment (Production)
Probleme mit Cloud-CI:
- Feedback-Loop langsam
- Debugging schwierig: Kein direkter Zugriff auf CI-Umgebung
- “Works locally, fails in CI”: Unterschiedliche Umgebungen
Anforderungen:
- GitHub Actions lokal ausführen ohne Push
- Gleiche Umgebung wie in GitHub Actions
Entscheidung
Act aktuell nicht benötigt, weil primär lokale Entwicklung.
Aktuell läuft einzige der jekyll-build auf GitHub Action, und den können wir lokal ausreichend testen.
Vorteile
| Vorteil | Beschreibung |
|---|---|
| Schnelles Feedback | 2-3 Min statt 5-10 Min |
| Kostenersparnis | Weniger CI-Minuten verbraucht |
| Debugging | Interaktiver Zugriff auf Container |
| Offline-Fähig | Arbeiten ohne Internet (nach initialem Pull) |
| Konsistenz | Gleiche Workflows lokal und Cloud |
Nachteile & Limitierungen
| Nachteil | Mitigation |
|---|---|
| Setup-Aufwand | Optional: Nicht jeder muss Act nutzen |
| Docker erforderlich | Bereits für Dev-Environment vorhanden |
| Nicht 100% kompatibel | GitHub-spezifische Features im echten CI testen |
Zusammenhang mit anderen ADRs:
- ADR-010: Makefile - Act führt
makeCommands aus - ADR-011: Docker - Act nutzt Docker für Container