Seminar Sulu Migration und Upgrade auf Sulu 3

Das Seminar führt strukturiert durch die Migration bestehender Sulu-2.6-Projekte auf Sulu 3.x. Inventur, Vorbereitungen, Content-Migration, Abhängigkeitswechsel, Anpassung eigener Erweiterungen, Tests und Cutover werden als kontrollierter Upgrade-Pfad geplant.

Inhaltsverzeichnis

• Zielgruppe
• Voraussetzungen
• Lernziele
• Lernfelder
• Praxisprojekt Schritt für Schritt
• Qualitätskontrollen
• Empfohlene Anschlussseminare

Zielgruppe

Erfahrene Sulu- und Symfony-Entwickelnde, Software Architects, technische Projektleitungen und DevOps-Verantwortliche für bestehende Sulu-Installationen.

Voraussetzungen

Gute Kenntnisse der vorhandenen Sulu-2.x-Anwendung, Composer, Symfony, Doctrine, Datenbanken und Deployment. Vollständige Sicherungen und eine isolierte Testumgebung sind erforderlich.

Lernziele

• Upgrade-Umfang und projektspezifische Risiken vollständig erfassen
• notwendige Vorarbeiten in Sulu 2.6 korrekt durchführen
• Content und Artikel in die Sulu-3-Architektur migrieren
• eigene Bundles, Twig-Code und Abhängigkeiten anpassen
• Cutover, Validierung und Rückfallstrategie belastbar planen

Lernfelder

Lerneinheit 1: Bestandsaufnahme und Zielbild

• Versionen, Bundles, Templates, Webspaces und Datenmengen
• Eigene Erweiterungen, externe Integrationen und Betriebsabhängigkeiten
• Zielversion, Wartungsfenster und Akzeptanzkriterien

Lerneinheit 2: Upgrade-Bereitschaft von Sulu 2.6

• Aktuellen 2.6-Patchstand herstellen
• Offene Migrationen, veraltete Konfiguration und Datenfehler bereinigen
• Backups und reproduzierbare Testkopie verifizieren

Lerneinheit 3: Schlüssel und Content-Strukturen vorbereiten

• Webspace-, Template- und Navigationsschlüssel prüfen
• Nicht kompatible Namen kontrolliert umstellen
• Content- und Referenzintegrität vor der Migration messen

Lerneinheit 4: Artikel- und Bundle-Änderungen

• Ehemalige Artikel-Erweiterung auf Kernfunktionalität abbilden
• Bundle-Registrierung und Konfiguration anpassen
• Template-Gruppen, Berechtigungen und Suchverhalten prüfen

Lerneinheit 5: Content-Migration

• Migration aus dem bisherigen Content-Speicher vorbereiten
• Seiten, Artikel, Snippets, Routen und Dimensionen übertragen
• Protokolle, Wiederholbarkeit und Datenabgleich

Lerneinheit 6: PHP-, Symfony- und Doctrine-Abhängigkeiten

• Kompatible Versionskombinationen und Composer-Konflikte
• Schrittweise Aktualisierung statt gleichzeitiger Großsprünge
• Deprecated APIs, Konfiguration und Datenbanktreiber

Lerneinheit 7: Twig- und Website-Anpassungen

• Geänderte Ladefunktionen und verpflichtende Properties
• Seiten-, Artikel- und Snippet-Auflösung aktualisieren
• Navigation, Medien, URL und Cache-Ausgabe testen

Lerneinheit 8: Eigene Erweiterungen migrieren

• Namespaces, Services, Events und Schnittstellen prüfen
• Admin-UI, Sicherheit, Suche und eigene Entitäten anpassen
• Automatisierte Tests als Migrationssicherheitsnetz

Lerneinheit 9: Cutover und Nachkontrolle

• Probeläufe, Delta-Strategie und Wartungsmodus
• Produktionsmigration, Smoke Tests und Monitoring
• Rollback-Kriterien, Fehlerbehebung und technische Nacharbeiten

Praxisprojekt Schritt für Schritt

Als durchgängige Übung entsteht einen vollständigen Upgrade-Plan für ein produktives Sulu-2.6-Projekt mit eigenen Erweiterungen, Artikeln, Suche und mehreren Sprachen.

1. Schritt 1: Ausgangslage, Rollen, Systemgrenzen und Abnahmekriterien für einen vollständigen Upgrade-Plan für ein produktives Sulu-2.6-Projekt mit eigenen Erweiterungen, Artikeln, Suche und mehreren Sprachen festhalten.
2. Schritt 2: Den Lernbereich „Bestandsaufnahme und Zielbild“ konfigurieren und mit einem Positivfall prüfen.
3. Schritt 3: Den Lernbereich „Schlüssel und Content-Strukturen vorbereiten“ umsetzen und mit realistischen Testdaten verbinden.
4. Schritt 4: Den Lernbereich „Artikel- und Bundle-Änderungen“ durch einen Negativfall und eine Korrektur absichern.
5. Schritt 5: Den Lernbereich „PHP-, Symfony- und Doctrine-Abhängigkeiten“ analysieren und die benötigten Artefakte festlegen.
6. Schritt 6: Den Lernbereich „Twig- und Website-Anpassungen“ konfigurieren und mit einem Positivfall prüfen.
7. Schritt 7: Den Lernbereich „Cutover und Nachkontrolle“ umsetzen und mit realistischen Testdaten verbinden.
8. Schritt 8: Die Teilkonfigurationen zu einem durchgängigen Anwendungsszenario verbinden und Abhängigkeiten sichtbar dokumentieren.
9. Schritt 9: Berechtigungs-, Locale-, Publikations- und Fehlerfälle mit einer standardisierten Prüfliste ausführen.
10. Schritt 10: Den erreichten Stand als Konfigurationsübersicht, Betriebscheckliste und priorisierte nächste Ausbaustufe festhalten.

Qualitätskontrollen

• Fachliche Anforderungen, Systemgrenzen und Verantwortlichkeiten sind eindeutig dokumentiert.
• Konfigurationen und Implementierungen sind reproduzierbar, versionierbar, vollständig und eigenständig beschrieben.
• Positiv-, Negativ-, Berechtigungs-, Locale- und Fehlerfälle sind nachvollziehbar geprüft.
• Betriebs-, Sicherheits-, Performance- und Wartungsaspekte sind passend zum Thema berücksichtigt.
• Die nächsten Vertiefungsschritte sind nach Risiko und Nutzen priorisiert.

Empfohlene Anschlussseminare

• Sulu Automatisierte Tests und Qualitätssicherung
• Sulu Deployment, Betrieb und Monitoring
• Sulu Architektur und Projektplanung