Seminar Strapi 5 – Upgrade und Migration von Strapi 4 auf Strapi 5

Die Schulung vermittelt ein kontrolliertes Vorgehen für die Migration von Strapi 4 auf Strapi 5. Bestandsaufnahme, Breaking Changes, documentId, API-Verträge, Datenmodell, Anpassungen, Plugins, Datenmigration, Tests, Cutover, Rollback und Nachkontrolle werden als zusammenhängendes Projekt bearbeitet. Die Umsetzung erfolgt an einem durchgängigen Seminarprojekt mit nachvollziehbaren Prüfschritten.

Inhaltsübersicht

• Bestandsaufnahme und Migrationsgrenzen
• Zielarchitektur und Kompatibilitätsmatrix
• API- und Dokumentänderungen in Strapi 5
• Backend-Code und Erweiterungen anpassen
• Plugins und Admin Panel migrieren
• Datenmodell und Datenmigration
• Automatisierte und manuelle Teststufen
• Generalprobe und Cutover-Plan
• Rollback, Nachkontrolle und Stilllegung

Lernziele und Kompetenzen

• Umfang, Abhängigkeiten und Risiken einer Migration vollständig erfassen
• wichtige API- und Datenmodelländerungen von Strapi 5 bewerten
• eigenen Code und Plugins systematisch anpassen
• Datenmigration und Teststufen reproduzierbar durchführen
• Cutover und Rollback mit belastbaren Kriterien steuern

Zielgruppe

Erfahrene Strapi-Entwickler, Administratoren, DevOps-Teams, technische Architekten und Projektleitungen mit Upgradeverantwortung

Voraussetzungen

Praktische Erfahrung mit einer Strapi-4-Installation, JavaScript- oder TypeScript-Kenntnisse, Datenbank- und Deploymentgrundlagen

Seminarinhalte

Modul 1: Bestandsaufnahme und Migrationsgrenzen

Versionen, Plugins, eigene APIs, Admin-Anpassungen, Datenbank, Provider, Frontends, Integrationen, Datenvolumen und Betriebsanforderungen.

1. Schritt 1: Ziel, Abhängigkeiten und Einsatzgrenzen des Themenblocks „Bestandsaufnahme und Migrationsgrenzen“ einordnen.
2. Schritt 2: Konfiguration oder Implementierung schrittweise umsetzen: Versionen, Plugins, eigene APIs, Admin-Anpassungen, Datenbank, Provider, Frontends, Integrationen, Datenvolumen und Betriebsanforderungen.
3. Schritt 3: Praxisergebnis herstellen und dokumentieren: Ein vollständiges Migrationsinventar mit Verantwortlichkeiten und Abhängigkeiten erstellen.
4. Schritt 4: Ergebnis mit repräsentativen Daten, Rollen, API-Anfragen und Fehlerfällen prüfen; Abweichungen korrigieren und Betriebsfolgen festhalten.

Modul 2: Zielarchitektur und Kompatibilitätsmatrix

Zielversion, Laufzeit, Datenbank, Plugins, Provider, Hosting, Frontends, unterstützte Schnittstellen und schrittweise Übergangsoptionen.

1. Schritt 1: Ziel, Abhängigkeiten und Einsatzgrenzen des Themenblocks „Zielarchitektur und Kompatibilitätsmatrix“ einordnen.
2. Schritt 2: Konfiguration oder Implementierung schrittweise umsetzen: Zielversion, Laufzeit, Datenbank, Plugins, Provider, Hosting, Frontends, unterstützte Schnittstellen und schrittweise Übergangsoptionen.
3. Schritt 3: Praxisergebnis herstellen und dokumentieren: Eine Kompatibilitätsmatrix mit Blockern, Ersatzlösungen und Entscheidungen aufbauen.
4. Schritt 4: Ergebnis mit repräsentativen Daten, Rollen, API-Anfragen und Fehlerfällen prüfen; Abweichungen korrigieren und Betriebsfolgen festhalten.

Modul 3: API- und Dokumentänderungen in Strapi 5

documentId, REST- und GraphQL-Antworten, Query-Parameter, Publikationsstatus, Dokumentkonzept und Folgen für Consumer.

1. Schritt 1: Ziel, Abhängigkeiten und Einsatzgrenzen des Themenblocks „API- und Dokumentänderungen in Strapi 5“ einordnen.
2. Schritt 2: Konfiguration oder Implementierung schrittweise umsetzen: documentId, REST- und GraphQL-Antworten, Query-Parameter, Publikationsstatus, Dokumentkonzept und Folgen für Consumer.
3. Schritt 3: Praxisergebnis herstellen und dokumentieren: Bestehende Clientabfragen identifizieren und auf neue Verträge umstellen.
4. Schritt 4: Ergebnis mit repräsentativen Daten, Rollen, API-Anfragen und Fehlerfällen prüfen; Abweichungen korrigieren und Betriebsfolgen festhalten.

Modul 4: Backend-Code und Erweiterungen anpassen

Routen, Controller, Services, Document Service API, Policies, Middlewares, Lifecycle-Logik und entfernte oder geänderte Schnittstellen.

1. Schritt 1: Ziel, Abhängigkeiten und Einsatzgrenzen des Themenblocks „Backend-Code und Erweiterungen anpassen“ einordnen.
2. Schritt 2: Konfiguration oder Implementierung schrittweise umsetzen: Routen, Controller, Services, Document Service API, Policies, Middlewares, Lifecycle-Logik und entfernte oder geänderte Schnittstellen.
3. Schritt 3: Praxisergebnis herstellen und dokumentieren: Eine typische Strapi-4-Erweiterung schrittweise auf die Zielarchitektur migrieren.
4. Schritt 4: Ergebnis mit repräsentativen Daten, Rollen, API-Anfragen und Fehlerfällen prüfen; Abweichungen korrigieren und Betriebsfolgen festhalten.

Modul 5: Plugins und Admin Panel migrieren

Pluginstruktur, Plugin SDK, Admin Panel API, React-Abhängigkeiten, Custom Fields, Einstellungen, Berechtigungen und Build.

1. Schritt 1: Ziel, Abhängigkeiten und Einsatzgrenzen des Themenblocks „Plugins und Admin Panel migrieren“ einordnen.
2. Schritt 2: Konfiguration oder Implementierung schrittweise umsetzen: Pluginstruktur, Plugin SDK, Admin Panel API, React-Abhängigkeiten, Custom Fields, Einstellungen, Berechtigungen und Build.
3. Schritt 3: Praxisergebnis herstellen und dokumentieren: Ein lokales Plugin technisch bewerten und einen konkreten Anpassungsplan umsetzen.
4. Schritt 4: Ergebnis mit repräsentativen Daten, Rollen, API-Anfragen und Fehlerfällen prüfen; Abweichungen korrigieren und Betriebsfolgen festhalten.

Modul 6: Datenmodell und Datenmigration

Schemaänderungen, Relationen, Komponenten, UIDs, Publikationszustände, IDs, Medien, Bereinigung und referenzielle Integrität.

1. Schritt 1: Ziel, Abhängigkeiten und Einsatzgrenzen des Themenblocks „Datenmodell und Datenmigration“ einordnen.
2. Schritt 2: Konfiguration oder Implementierung schrittweise umsetzen: Schemaänderungen, Relationen, Komponenten, UIDs, Publikationszustände, IDs, Medien, Bereinigung und referenzielle Integrität.
3. Schritt 3: Praxisergebnis herstellen und dokumentieren: Eine Testkopie migrieren und technische sowie fachliche Integrität prüfen.
4. Schritt 4: Ergebnis mit repräsentativen Daten, Rollen, API-Anfragen und Fehlerfällen prüfen; Abweichungen korrigieren und Betriebsfolgen festhalten.

Modul 7: Automatisierte und manuelle Teststufen

Build, Unit, Integration, API-Verträge, Rollen, Frontend, Medien, Performance, Migration, Wiederholung und Abnahmedokumentation.

1. Schritt 1: Ziel, Abhängigkeiten und Einsatzgrenzen des Themenblocks „Automatisierte und manuelle Teststufen“ einordnen.
2. Schritt 2: Konfiguration oder Implementierung schrittweise umsetzen: Build, Unit, Integration, API-Verträge, Rollen, Frontend, Medien, Performance, Migration, Wiederholung und Abnahmedokumentation.
3. Schritt 3: Praxisergebnis herstellen und dokumentieren: Eine regressionsorientierte Testmatrix für Alt- und Zielsystem durchführen.
4. Schritt 4: Ergebnis mit repräsentativen Daten, Rollen, API-Anfragen und Fehlerfällen prüfen; Abweichungen korrigieren und Betriebsfolgen festhalten.

Modul 8: Generalprobe und Cutover-Plan

Freeze, Backup, Laufzeitmessung, Datenkopie, Migration, Smoke Tests, Frontendumstellung, Freigabe, Kommunikationspunkte und Abbruchkriterien.

1. Schritt 1: Ziel, Abhängigkeiten und Einsatzgrenzen des Themenblocks „Generalprobe und Cutover-Plan“ einordnen.
2. Schritt 2: Konfiguration oder Implementierung schrittweise umsetzen: Freeze, Backup, Laufzeitmessung, Datenkopie, Migration, Smoke Tests, Frontendumstellung, Freigabe, Kommunikationspunkte und Abbruchkriterien.
3. Schritt 3: Praxisergebnis herstellen und dokumentieren: Eine vollständige Generalprobe mit gemessenen Zeiten und dokumentierten Problemen durchführen.
4. Schritt 4: Ergebnis mit repräsentativen Daten, Rollen, API-Anfragen und Fehlerfällen prüfen; Abweichungen korrigieren und Betriebsfolgen festhalten.

Modul 9: Rollback, Nachkontrolle und Stilllegung

Rückkehrpunkt, Datenrückfluss, DNS oder Routing, Token, Jobs, Monitoring, Nachmigration, Altbetrieb und revisionssichere Abschlussdokumentation.

1. Schritt 1: Ziel, Abhängigkeiten und Einsatzgrenzen des Themenblocks „Rollback, Nachkontrolle und Stilllegung“ einordnen.
2. Schritt 2: Konfiguration oder Implementierung schrittweise umsetzen: Rückkehrpunkt, Datenrückfluss, DNS oder Routing, Token, Jobs, Monitoring, Nachmigration, Altbetrieb und revisionssichere Abschlussdokumentation.
3. Schritt 3: Praxisergebnis herstellen und dokumentieren: Ein Fehlschlagszenario zurückrollen und anschließend die kontrollierte Stilllegung des Altsystems planen.
4. Schritt 4: Ergebnis mit repräsentativen Daten, Rollen, API-Anfragen und Fehlerfällen prüfen; Abweichungen korrigieren und Betriebsfolgen festhalten.

Praxisübungen und Qualitätssicherung

• Migrationsinventar und Kompatibilitätsmatrix für ein Beispielprojekt
• Anpassung einer Strapi-4-API und eines lokalen Plugins
• Generalprobe mit Datenmigration, Smoke Test und vollständigem Rollback

Arbeitsunterlagen

Die Unterlagen enthalten Konfigurationsbeispiele, Prüflisten, Übungsaufgaben, Fehlerbilder und eine strukturierte Dokumentationsvorlage für die Übertragung in eigene Projekte.