Überblick
Upgrades von WSO2 API Manager über mehrere Hauptversionen hinweg sind Migrationen, keine Upgrades. Registry-Struktur, API-Definitionen, das Modell der Throttling Policies und die Identitätsintegration ändern sich – und das Migrationswerkzeug setzt einen sauberen Ausgangszustand voraus, den die meisten lange laufenden Deployments nicht haben.
Herausforderung
Das Deployment lag mehrere Hauptversionen zurück, mit angepassten Carbon-Komponenten, von Hand bearbeiteten Synapse-Konfigurationen und einer User-Store-Integration, die auf einem älteren Identitätsmodell aufbaute. Über diese Spanne gab es keinen In-place-Upgrade-Pfad, und der API-Katalog bediente Anwendungen an mehreren Standorten, die sich nicht alle für einen einzigen Ausfall koordinieren ließen.
Umgebung
WSO2 API Manager und Identity Server On-Premises mit Tenants pro Standort, angebunden an eine LDAP-gestützte Identitätsverwaltung und ein gemeinsames Studierendenverwaltungssystem.
Vorgehen
AceMQ entwarf eine Migration per Parallelaufbau: die Zielversion sauber aufsetzen, API-Definitionen und Subscriptions in kontrollierten Batches migrieren und den Traffic Tenant für Tenant umstellen. Anpassungen wurden neu bewertet statt portiert, denn mehrere existierten nur, um Verhalten zu umgehen, das die neuere Version nativ beherrscht.
Lösung
- Inventur von APIs, Subscriptions, Throttling Policies und Anpassungen im Abgleich mit der Unterstützung in der Zielversion
- Paralleler Aufbau des Ziel-Deployments statt eines In-place-Upgrades über mehrere Versionen
- Neubewertung jeder Anpassung und Stilllegung derjenigen, die inzwischen natives Verhalten umgingen
- Migration von API-Definitionen und Subscriptions in Batches mit automatisierter Prüfung pro Batch
- Überarbeitung der Identitäts- und User-Store-Integration für das neuere Identitätsmodell
- Umstellung des Traffics pro Tenant mit Rollback-Möglichkeit bei jedem Schritt
Resultat
Die Landschaft erreichte eine unterstützte Version über Umstellungen pro Tenant statt über einen einzigen koordinierten Ausfall, und der Umfang der Anpassungen schrumpfte erheblich, weil vieles davon nicht mehr gebraucht wurde.