Seminar Structurizr Migration: Lite, On-Premises und Cloud zu Local und Server

Migration wird als kontrollierter Produkt- und Betriebswechsel behandelt, nicht als reines Kopieren von Workspace-Dateien. Modellinhalte, Layoutinformationen, API-Automatisierung, Rollen, Einbettungen und Betriebsdaten werden getrennt inventarisiert und gemeinsam abgenommen.

Inhaltsverzeichnis

1. Einordnung
2. Zielgruppe
3. Voraussetzungen
4. Lernziele
5. Seminarinhalte
6. Praxisfall und Übungsartefakte

Einordnung

Der frühere Lite-Workflow wird durch Local abgelöst, während die frühere On-Premises-Installation in den Server-Betrieb übergeht. Auch bestehende Cloud-Workspaces benötigen einen Self-hosted-Zielpfad. Besonders wichtig sind Unterschiede der neuen Commands und Workspace-API sowie der Umgang mit manuellen Layouts.

Zielgruppe

Softwarearchitektinnen und Softwarearchitekten, Plattform- und DevOps-Teams, Systemadministration, Security-Verantwortliche und technische Projektleitungen für Structurizr-Migrationen.

Voraussetzungen

Kenntnisse der vorhandenen Structurizr-Umgebung sowie Grundlagen zu DSL, JSON, API-Schlüsseln, Datensicherung und Zielplattform. Für Servermigrationen sind Administrationskenntnisse erforderlich.

Lernziele

• Bestandsworkspaces, Layouts, Automatisierungen, Benutzer und Integrationen vollständig inventarisieren.
• Ein passendes Local- und Server-Zielbild mit klaren Verantwortungsgrenzen erstellen.
• Workspace-Dateien und API-Prozesse in einer isolierten Testmigration überführen.
• Berechtigungen, Einbettungen, Versionen und Betriebsdaten gezielt prüfen.
• Cutover, Rückfall, Abnahme und Stilllegung mit belastbaren Runbooks planen.

Seminarinhalte

1. Bestandsinventur und Risikoklassifizierung

Alle migrationsrelevanten Artefakte und Abhängigkeiten werden systematisch erfasst.

1. Workspaces, DSL-, JSON-, Dokumentations-, ADR-, Bild- und Theme-Dateien katalogisieren.
2. Manuelle Layouts, Branches, Versionen, API-Clients und Einbettungen identifizieren.
3. Kritikalität, Eigentum, Zielsystem und Rückfallbedarf je Workspace bewerten.

2. Zielbild Local und Server

Für jede Nutzungsart wird ein passender Zielpfad festgelegt.

1. Einzelplatz-Autorentätigkeit Local zuordnen.
2. Teamweite Veröffentlichung, Zugriffsschutz und Integration Server zuordnen.
3. Datenhaltung, Authentifizierung, URL-Struktur und Betriebsverantwortung definieren.

3. Workspace- und Layoutmigration

Modelldaten werden kontrolliert exportiert, bereinigt und im Ziel geprüft.

1. DSL und JSON sichern und auf portable Abhängigkeiten untersuchen.
2. Workspaces in Local laden und Layoutübernahme verifizieren.
3. Auf Server erstellen, übertragen und gegen die Quellfassung vergleichen.

4. Commands, APIs und Automatisierung anpassen

Alte Skripte werden nicht unverändert übernommen, sondern gegen die neue Schnittstelle neu getestet.

1. Verwendete CLI-Aufrufe und API-Endpunkte erfassen.
2. Neue Commands, Header und Schlüsselverwaltung in einer Testpipeline umsetzen.
3. Fehler-, Sperr-, Branch- und Rollbackpfade automatisiert prüfen.

5. Identitäten, Rollen und Integrationen

Zugriff und Nutzung in angebundenen Systemen werden separat abgenommen.

1. Benutzer-, Rollen- und Admin-Konzept in die Zielauthentifizierung übertragen.
2. Public- und Sharing-Varianten sowie Einbettungen neu konfigurieren.
3. Negative Zugriffstests und Datenschutzanforderungen dokumentieren.

6. Cutover, Rückfall und Stilllegung

Der Produktivwechsel wird als wiederholbarer Ablauf mit klaren Entscheidungspunkten vorbereitet.

1. Migrationsfenster, Freeze, finale Sicherung und Verantwortlichkeiten festlegen.
2. Cutover-Probe und Rückfall unter Zeitvorgabe durchführen.
3. Abnahmekriterien erfüllen und alte Komponenten kontrolliert außer Betrieb nehmen.

Praxisfall und Übungsartefakte

Eine vollständige Testmigration überführt mehrere Beispiel-Workspaces einschließlich manueller Layouts, API-Automatisierung und Berechtigungsmodell. Erarbeitet werden Inventarliste, Mapping, Testprotokoll, Cutover- und Rückfall-Runbook.