Seminar Umbraco – Migration und Upgrade auf Umbraco 17 oder 18

Ein Versionswechsel ist ein Projekt aus Abhängigkeiten, Daten, Eigenentwicklungen, Betriebsanforderungen und redaktioneller Kontinuität. Die Auswahl des Zielsystems muss deshalb mit Supportzeitraum, Funktionsbedarf und Migrationsaufwand zusammen betrachtet werden.

Im Seminar wird eine vorbereitete ältere Lösung inventarisiert und in eine neue Zielumgebung überführt. Der Schwerpunkt liegt auf einer wiederholbaren Generalprobe, messbaren Abnahmekriterien und einer realistischen Rückfallentscheidung.

Inhaltsverzeichnis

• Zielsetzung
• Zielgruppe
• Voraussetzungen
• Seminarinhalte
• Praxisübungen
• Methodik

Zielsetzung

Ziel ist ein belastbarer Migrationsplan und die praktische Fähigkeit, Code, Erweiterungen, Daten und Betrieb kontrolliert auf Umbraco 17 oder 18 zu überführen.

Zielgruppe

Erfahrene Umbraco-Entwickler, technische Projektleitungen, Plattformteams und Personen mit Verantwortung für Versionswechsel.

Voraussetzungen

Gute Kenntnisse in Umbraco-Entwicklung, C#, ASP.NET Core, Datenbanken, Versionsverwaltung, Bereitstellung und Testverfahren.

Seminarinhalte

Die Themen werden in aufeinander aufbauenden Arbeitsschritten behandelt. Jeder Schritt wird demonstriert, in der Übungsumgebung umgesetzt und anhand festgelegter Prüfkriterien kontrolliert.

Tag 1 – Inventur, Zielwahl und Migrationspfad

Der erste Tag schafft eine belastbare Entscheidungs- und Planungsgrundlage.

1. Schritt 1: Ausgangsversion, Pakete, Eigenentwicklungen, Datenumfang, Medien, Integrationen und betriebliche Abhängigkeiten vollständig inventarisieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Umbraco 17 als langfristig unterstützte Basis und Umbraco 18 als aktuellere Funktionslinie anhand des konkreten Projektrisikos bewerten. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Direkte Upgrade-Schritte, Neuaufbau oder kombinierte Migration auswählen und technische Zwischenstände eindeutig festlegen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Sicherungen, isolierte Testumgebung, anonymisierte Testdaten und reproduzierbare Ausgangslage für alle Probeläufe vorbereiten. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Risiken, Verantwortlichkeiten, Abnahmekriterien, Zeitfenster und Rückfallgrenzen in einem Migrationsplan dokumentieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Tag 2 – Code, Erweiterungen und Datenübernahme

Der zweite Tag setzt die wesentlichen technischen Anpassungen um.

1. Schritt 1: Projektdateien, Laufzeit, Pakete und veränderte APIs schrittweise aktualisieren und jede Änderung mit Build und Test absichern. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Eigene Controller, Services, Ereignisse und Integrationen auf veränderte Verträge, Abhängigkeiten und Laufzeitverhalten prüfen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Ältere Backoffice-Erweiterungen für die moderne Erweiterungsarchitektur neu strukturieren und Funktionsgleichheit nachweisen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Datenbank, Inhalte, Medien und eigene Datenbestände mit protokollierten Migrationsschritten und wiederholbaren Skripten überführen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Fehler, Warnungen, nicht migrierte Elemente und manuelle Nacharbeiten in einem kontrollierten Abweichungsprotokoll erfassen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Tag 3 – Generalprobe, Cutover und Nachkontrolle

Der dritte Tag macht den Wechsel zeitlich und betrieblich beherrschbar.

1. Schritt 1: Automatisierte Tests, redaktionelle Stichproben, Sicherheitsprüfung und Leistungsmessung gegen die definierten Abnahmekriterien ausführen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Generalprobe mit vollständiger Zeitmessung, Datenabgleich, Inhaltskontrolle und dokumentierter Entscheidungsliste durchführen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Freeze, letzte Datendifferenz, Umschaltung, Cache-Aufbau, DNS- oder Proxy-Anpassung und Freigabe als exakten Cutover-Ablauf planen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Rückfall anhand vorab festgelegter Grenzen praktisch proben und Datenkonsistenz nach Rückkehr zum Ausgangssystem verifizieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Überwachung, Supportbereitschaft, Fehlertriage, redaktionelle Kommunikation und Abschlusskontrollen für die ersten Betriebstage vorbereiten. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Praxisübungen

• Erstellung einer vollständigen Abhängigkeits- und Risikoinventur für eine ältere Beispielinstallation.
• Migration eines eigenen Codesegments und einer Backoffice-Erweiterung in die moderne Architektur.
• Wiederholbare Übernahme ausgewählter Inhalte und Medien mit Abweichungsprotokoll.
• Durchführung einer zeitgemessenen Generalprobe mit Freigabe- und Rückfallentscheidung.

Methodik

Kurze Fachvorträge wechseln mit Live-Demonstrationen, geführten Umsetzungen und selbstständigen Übungen. Zwischenstände werden anhand nachvollziehbarer Prüfschritte kontrolliert. Typische Fehlkonfigurationen und Störungsszenarien werden bewusst einbezogen, damit nicht nur der Normalfall, sondern auch Diagnose, Korrektur und sichere Rücknahme beherrscht werden.