Przegląd
Aktualizacje WSO2 API Manager obejmujące kilka wersji głównych to migracje, a nie aktualizacje. Zmieniają się struktura rejestru, definicje API, modele polityk throttlingu i integracja tożsamości, a narzędzia migracyjne zakładają czysty stan wyjściowy, którego większość długo działających wdrożeń nie ma.
Wyzwanie
Wdrożenie było opóźnione o kilka wersji głównych, miało zmodyfikowane komponenty carbon, ręcznie edytowane konfiguracje synapse i integrację user store zbudowaną pod starszy model tożsamości. Bezpośrednia aktualizacja w miejscu przez tak wiele wersji nie była możliwa, a katalog API obsługiwał aplikacje w wielu kampusach, których nie dało się skoordynować na jedną wspólną przerwę.
Środowisko
Lokalne WSO2 API Manager i Identity Server z osobnymi tenantami dla kampusów, zintegrowane z tożsamością opartą na LDAP i wspólnym systemem informacji o studentach.
Podejście
AceMQ zaprojektował migrację przez równoległą budowę: postawienie czystej instalacji wersji docelowej, migracja definicji API i subskrypcji w kontrolowanych partiach oraz przełączanie ruchu tenant po tenancie. Modyfikacje oceniliśmy na nowo zamiast je przenosić, bo kilka z nich istniało wyłącznie po to, by obejść zachowanie, które nowsza wersja obsługuje natywnie.
Rozwiązanie
- Inwentaryzacja API, subskrypcji, polityk throttlingu i modyfikacji pod kątem obsługi w wersji docelowej
- Równoległa budowa docelowego wdrożenia zamiast próby aktualizacji w miejscu o kilka wersji
- Ponowna ocena każdej modyfikacji i wycofanie tych, które obchodziły zachowanie dostępne już natywnie
- Migracja definicji API i subskrypcji partiami z automatyczną weryfikacją każdej partii
- Przebudowa integracji tożsamości i user store pod nowszy model tożsamości
- Przełączanie ruchu tenant po tenancie z możliwością wycofania na każdym etapie
Efekt
Środowisko osiągnęło wspieraną wersję dzięki przełączeniom poszczególnych tenantów zamiast jednej skoordynowanej przerwy, a zakres modyfikacji znacząco się zmniejszył, bo duża ich część nie była już potrzebna.