Seminar CrafterCMS – DevContentOps, Git und CI/CD

Dieses praxisorientierte Seminar verbindet fachliche Einordnung, nachvollziehbare Konfigurationsschritte und kontrollierte Übungen an einer durchgängigen CrafterCMS-Laborumgebung. Ein kontrollierter, automatisierter und revisionsfähiger Änderungsfluss für Code, Konfiguration und Content-Modell entsteht.

Inhaltsverzeichnis

1. Zielsetzung
2. 1. Repository- und Verantwortungsmodell
3. 2. Lokaler Entwicklerworkflow und CLI
4. 3. Umgebungen, Konfiguration und Secrets
5. 4. Automatisierte Qualitätsprüfungen
6. 5. CI/CD, Promotion und Deployment
7. 6. Rollback, Fehlerbehandlung und Teamprozess
8. Praxisprojekt und Qualitätssicherung
9. Zielgruppe und Voraussetzungen
10. Didaktik und Arbeitsweise

Zielsetzung

Ein kontrollierter, automatisierter und revisionsfähiger Änderungsfluss für Code, Konfiguration und Content-Modell entsteht. Die einzelnen Arbeitsschritte werden jeweils mit einem definierten Ausgangszustand, einem erwarteten Prüfergebnis und einer dokumentierten Korrekturmöglichkeit durchgeführt.

Seminarinhalte

1. Repository- und Verantwortungsmodell

Code, Konfiguration und Content-Artefakte werden so organisiert, dass Änderungen nachvollziehbar und konfliktarm bearbeitet werden können. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Repository-Inhalte und Eigentümerschaft nach Artefaktklasse erfassen. Prüfpunkt: Verantwortung für Änderungen ist eindeutig.
2. Schritt 2: Branch-, Tag- und Releasekonventionen festlegen. Prüfpunkt: Änderungsstände sind zuverlässig identifizierbar.
3. Schritt 3: Review- und Freigaberegeln je Risiko definieren. Prüfpunkt: Kritische Änderungen benötigen geeignete Kontrolle.
4. Schritt 4: Konfliktfälle zwischen redaktionellen und technischen Änderungen simulieren. Prüfpunkt: Ein abgestimmter Lösungsweg liegt vor.

2. Lokaler Entwicklerworkflow und CLI

Projektquellen werden reproduzierbar bereitgestellt und mit klaren Arbeitsbefehlen bearbeitet. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Projekt auschecken und lokale Voraussetzungen prüfen. Prüfpunkt: Arbeitsumgebung ist vollständig reproduzierbar.
2. Schritt 2: CrafterCMS CLI für Projekt- und Umgebungsaufgaben konfigurieren. Prüfpunkt: Befehle greifen auf die richtige Zielumgebung zu.
3. Schritt 3: Eine Modell- oder Templateänderung lokal umsetzen. Prüfpunkt: Änderung ist in Vorschau und Datenstruktur sichtbar.
4. Schritt 4: Diff, Commit und technische Dokumentation erstellen. Prüfpunkt: Änderung ist klein, verständlich und prüfbar.
5. Schritt 5: Arbeitsstand zurücksetzen und erneut aufbauen. Prüfpunkt: Reproduzierbarkeit ist nachgewiesen.

3. Umgebungen, Konfiguration und Secrets

Umgebungsspezifische Werte werden von versionierbarer Projektlogik getrennt und sicher bereitgestellt. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Gemeinsame und umgebungsspezifische Konfigurationen klassifizieren. Prüfpunkt: Konfigurationsgrenzen sind klar.
2. Schritt 2: Variablen, Endpunkte und Feature-Schalter je Umgebung definieren. Prüfpunkt: Promotion benötigt keine manuellen Codeänderungen.
3. Schritt 3: Secrets aus dem Repository entfernen und sicher referenzieren. Prüfpunkt: Vertrauliche Werte sind nicht versioniert.
4. Schritt 4: Konfigurationsvalidierung vor Deployment ausführen. Prüfpunkt: Fehlende oder falsche Werte werden früh erkannt.
5. Schritt 5: Eine fehlerhafte Konfiguration kontrolliert ablehnen. Prüfpunkt: Pipeline verhindert riskante Auslieferung.

4. Automatisierte Qualitätsprüfungen

Struktur, Syntax, Inhalte und Integrationsverträge werden vor der Auslieferung automatisiert geprüft. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Linting und Syntaxprüfung für Templates, Skripte und Konfiguration einrichten. Prüfpunkt: Formale Fehler stoppen den Build.
2. Schritt 2: Schema- und Modelltests für Content-Typen ergänzen. Prüfpunkt: Inkompatible Änderungen werden erkannt.
3. Schritt 3: API- und Rendering-Smoke-Tests definieren. Prüfpunkt: Kernfunktionen sind nach jedem Build überprüft.
4. Schritt 4: Sicherheits- und Abhängigkeitsprüfungen integrieren. Prüfpunkt: Bekannte Risiken werden sichtbar.
5. Schritt 5: Prüfergebnisse als Pipeline-Artefakt speichern. Prüfpunkt: Entscheidungen sind revisionsfähig.

5. CI/CD, Promotion und Deployment

Eine mehrstufige Pipeline erzeugt geprüfte Artefakte und überführt sie kontrolliert in Zielumgebungen. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Build-, Test-, Paket- und Deployment-Stufen definieren. Prüfpunkt: Pipeline besitzt klare Ein- und Ausgaben.
2. Schritt 2: Artefaktversion und Quellrevision miteinander verknüpfen. Prüfpunkt: Auslieferung ist eindeutig rückverfolgbar.
3. Schritt 3: Deployment in eine Testumgebung automatisieren. Prüfpunkt: Änderung ist ohne manuelle Dateikopien verfügbar.
4. Schritt 4: Abnahme-Gate und Promotion in die nächste Umgebung ausführen. Prüfpunkt: Nur freigegebene Stände werden weitergegeben.
5. Schritt 5: Delivery- und Suchzustand nach Deployment prüfen. Prüfpunkt: Technischer Erfolg ist fachlich bestätigt.

6. Rollback, Fehlerbehandlung und Teamprozess

Fehlerhafte Änderungen werden schnell begrenzt, zurückgenommen und als Lernfall in den Prozess eingebaut. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Rollback-Kriterien und zulässige Rückfallmechanismen definieren. Prüfpunkt: Entscheidung kann unter Zeitdruck getroffen werden.
2. Schritt 2: Fehlerhaftes Artefakt gezielt ausrollen und Alarm auslösen. Prüfpunkt: Überwachung erkennt die Abweichung.
3. Schritt 3: Rollback auf den letzten freigegebenen Stand durchführen. Prüfpunkt: Service und Inhalte sind wieder konsistent.
4. Schritt 4: Ursache analysieren und fehlenden Test ergänzen. Prüfpunkt: Wiederholungsrisiko wird reduziert.
5. Schritt 5: Zusammenarbeit zwischen Redaktion, Entwicklung und Betrieb als Ablauf dokumentieren. Prüfpunkt: Übergaben und Verantwortlichkeiten sind eindeutig.

Praxisprojekt und Qualitätssicherung

Ein Beispielprojekt wird lokal ausgecheckt, verändert, geprüft, paketiert und über mehrere Umgebungen bis zu einem Delivery-Ziel promoted. Fehlerhafte Änderungen werden erkannt und kontrolliert zurückgenommen. Die Übung wird mit einer Abnahmeliste abgeschlossen, die Funktionsprüfung, Fehlerfall, Dokumentation und reproduzierbaren Wiederanlauf umfasst.

Zielgruppe und Voraussetzungen

Zielgruppe: CrafterCMS-Entwicklung, DevOps, Plattformbetrieb, Release Engineering, Qualitätssicherung und technische Projektleitung.

Voraussetzungen: Sicherer Umgang mit Git, Kommandozeile und grundlegenden CI/CD-Konzepten; CrafterCMS-Projektkenntnisse sind hilfreich.

Didaktik und Arbeitsweise

Kurze Fachimpulse wechseln mit Demonstrationen, geführten Konfigurationsschritten, eigenständigen Übungen, negativen Testfällen und strukturierten Auswertungen. Ergebnisse werden in Checklisten, Mappingtabellen, Testfällen oder Runbooks festgehalten, damit die erarbeiteten Verfahren im Projekt- und Betriebsalltag wiederholbar bleiben.