Retour à tous les cas d'usage

ConseilÉducation

Franchir plusieurs versions majeures de WSO2 sans perdre votre parc d'API

Réseau d'enseignement supérieur

Planification d'une mise à niveau de WSO2 API Manager sur plusieurs versions, incluant la migration du registre, le redéploiement des API et l'évolution de l'intégration d'identité.

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

  1. Inventaire des API, abonnements, politiques de throttling et personnalisations au regard de ce que prend en charge la version cible
  2. Construction du déploiement cible en parallèle plutôt qu'une tentative de mise à niveau en place sur plusieurs versions
  3. Réévaluation de chaque personnalisation et retrait de celles qui contournaient un comportement désormais natif
  4. Migration des définitions d'API et des abonnements par lots, avec vérification automatisée de chaque lot
  5. Refonte de l'intégration d'identité et du user store pour le nouveau modèle d'identité
  6. 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.

Technologies

WSO2PostgreSQLKubernetesDocker

Besoin de conseils en architecture WSO2 ?

Les ingénieurs WSO2 seniors d'AceMQ ont déjà mené exactement ce type de mission. Que vous ayez besoin de conseils d'architecture, d'une remédiation concrète ou d'un partenariat managé dans la durée, nous sommes prêts à vous aider.