Panoramica
Gli upgrade di WSO2 API Manager che attraversano più major version sono migrazioni, non upgrade. Cambiano la struttura del registry, le definizioni delle API, i modelli delle policy di throttling e l'integrazione dell'identità, e gli strumenti di migrazione presuppongono uno stato di partenza pulito che la maggior parte dei deployment di lunga data non ha.
Sfida
Il deployment era indietro di diverse major version, con componenti carbon personalizzati, configurazioni synapse modificate a mano e un'integrazione dello user store costruita su un modello di identità più vecchio. Su un salto di quell'ampiezza non esisteva un percorso di upgrade in-place, e il catalogo API serviva applicazioni di più campus che non potevano essere coordinate tutte per un unico fermo.
Ambiente
WSO2 API Manager e Identity Server on-premise con tenant dedicati ai singoli campus, integrati con un'identità basata su LDAP e con un sistema informativo studenti condiviso.
Approccio
AceMQ ha progettato una migrazione a costruzione parallela: installare da zero la versione di destinazione, migrare definizioni delle API e subscription in batch controllati e spostare il traffico tenant per tenant. Le personalizzazioni sono state rivalutate anziché portate così com'erano, perché diverse esistevano solo per aggirare comportamenti che la versione più recente gestisce in modo nativo.
Soluzione
- Inventario di API, subscription, policy di throttling e personalizzazioni rispetto a quanto supportato dalla versione di destinazione
- Costruzione del deployment di destinazione in parallelo, invece di tentare un upgrade in-place attraverso più versioni
- Rivalutazione di ogni personalizzazione, dismettendo quelle che aggiravano comportamenti ormai nativi
- Migrazione di definizioni delle API e subscription in batch, con verifica automatizzata per ciascun batch
- Revisione dell'integrazione di identità e user store per il nuovo modello di identità
- Spostamento del traffico tenant per tenant, con rollback disponibile a ogni passaggio
Esito
Il patrimonio di API è arrivato a una versione supportata tramite cutover per singolo tenant anziché con un unico fermo coordinato, e l'insieme delle personalizzazioni si è ridotto in modo sostanziale, perché gran parte di esse non era più necessaria.