Projektanforderung: Zentrale CI/CD-Pipeline-Verwaltung

Projektziel

Entwicklung eines zentralen Repositories für standardisierte CI/CD-Pipelines, die in verschiedenen Projekten über GitHub Actions (primär) und perspektivisch auch GitLab CI/CD (sekundär) eingesetzt werden können. Ziel ist die Vereinheitlichung von DevOps-Prozessen durch wiederverwendbare, versionierte Pipeline-Definitionen.

Hauptanforderungen

1. Zentrale Pipeline-Verwaltung

• Erstellung eines dedizierten GitHub-Repositories zur zentralen Verwaltung aller CI/CD-Workflow-Definitionen
• Klare Verzeichnisstruktur mit Trennung nach Plattformen (GitHub/GitLab)
• Einfache Referenzierung der Workflows in Zielprojekten durch direkte Repository-Verweise

2. Standardisierte Workflows

• Semantische Versionierung: Automatische Versionsverwaltung basierend auf Commit-Nachrichten
• Testing Pipelines: Automatische e2e und Unit-Tests
• Container-Build: Parametrisierte Workflows für das Erstellen und Veröffentlichen von Container-Images
• Deployment-Pipelines: Differenzierte Workflows für verschiedene Umgebungen (DEV für dev-Branch, PROD für main-Branch)
• Unterstützung für verschiedene Projekttypen (Web-Anwendungen, Python-Projekte, etc.)

3. Konfigurierbarkeit & Parametrisierung

• Alle Workflows müssen projektspezifische Parameter akzeptieren (z.B. Container-Namen, Registry-URLs)
• Variable Inputs sollten konsistent zwischen GitHub- und GitLab-Implementierungen sein
• Gemeinsame Hilfsskripte für plattformübergreifende Logik, wo möglich

4. Versionierung der Pipeline-Definitionen

• Explizite Versionierung mittels Git-Tags (v1.0.0, v2.0.0, etc.)
• Projekte referenzieren spezifische Versionen der Workflows
• Dokumentierte Breaking Changes und Upgrade-Pfade
• Unterstützung mehrerer Versionen parallel für schrittweise Migration

5. Plattformübergreifende Konsistenz

• Einheitliche Konzepte und Namenskonventionen zwischen GitHub- und GitLab-Implementierungen
• Parallele Verzeichnisstrukturen mit äquivalenten Workflow-Definitionen für beide Plattformen
• Gemeinsame Dokumentation für alle Plattformen

Implementierungsphasen

1. Phase 1: Basis-Setup mit GitHub Actions-Workflows

   • Semantisches Versioning
   • Grundlegende Dokumentation

2. Phase 2: Erweiterung GitHub Actions

   • Container-Build-Workflow
   • Deployment-Workflow

3. Phase 3: GitLab CI/CD Integration

   • Äquivalente GitLab CI/CD-Templates
   • Gemeinsame Skripte für plattformübergreifende Logik

4. Phase 4: Erweiterte Features

   • Zusätzliche Projekttypen
   • Erweiterte Test-Integrationen

Erfolgskriterien

• Erfolgreiche Implementierung der grundlegenden Workflows
• Nachweis der Funktionalität in mindestens einem Pilotprojekt
• Dokumentierte Prozesse für die Erstellung neuer Workflow-Versionen
• Klare Anleitung zur Integration in Zielprojekte

Diese überarbeitete Anforderung stellt sicher, dass die CI/CD-Pipelines direkt über die Repository-Mechanismen eingebunden werden und bietet eine zukunftssichere Struktur für die Unterstützung mehrerer CI/CD-Plattformen.