Présentation
Une mise à niveau de WSO2 API Manager qui franchit plusieurs versions majeures est une migration, pas une simple mise à niveau. La structure du registre, les définitions d'API, les modèles de politiques de throttling et l'intégration d'identité changent tous, et l'outillage de migration suppose un point de départ propre que la plupart des déploiements anciens n'offrent pas.
Défi
Le déploiement avait plusieurs versions majeures de retard, avec des composants carbon personnalisés, des configurations synapse modifiées à la main et une intégration de user store construite sur un ancien modèle d'identité. Aucun chemin de mise à niveau en place n'existait sur un tel écart, et le catalogue d'API servait des applications de plusieurs campus qu'il était impossible de coordonner toutes pour une seule interruption.
Environnement
WSO2 API Manager et Identity Server sur site, avec des tenants propres à chaque campus, une identité adossée à LDAP et un système d'information étudiant partagé.
Approche
AceMQ a conçu une migration par construction parallèle : monter proprement la version cible, migrer les définitions d'API et les abonnements par lots contrôlés, et basculer le trafic tenant par tenant. Les personnalisations ont été réévaluées plutôt que portées telles quelles, car plusieurs d'entre elles servaient à contourner un comportement que la nouvelle version gère nativement.
Solution
- Inventaire des API, abonnements, politiques de throttling et personnalisations au regard de ce que prend en charge la version cible
- Construction du déploiement cible en parallèle plutôt qu'une tentative de mise à niveau en place sur plusieurs versions
- Réévaluation de chaque personnalisation et retrait de celles qui contournaient un comportement désormais natif
- Migration des définitions d'API et des abonnements par lots, avec vérification automatisée de chaque lot
- Refonte de l'intégration d'identité et du user store pour le nouveau modèle d'identité
- Bascule du trafic tenant par tenant, avec retour arrière possible à chaque étape
Résultat obtenu
Le parc a atteint une version supportée grâce à des bascules tenant par tenant plutôt qu'à une interruption unique coordonnée, et l'empreinte des personnalisations s'est nettement réduite, une grande partie n'étant plus nécessaire.