Descripción general
Las actualizaciones de WSO2 API Manager que saltan varias versiones mayores son migraciones, no actualizaciones. Cambian la estructura del registro, las definiciones de las APIs, los modelos de políticas de throttling y la integración de identidad, y las herramientas de migración dan por hecho un punto de partida limpio que la mayoría de los despliegues con muchos años de funcionamiento no tienen.
Reto
El despliegue llevaba varias versiones mayores de retraso, con componentes carbon personalizados, configuraciones de synapse editadas a mano y una integración del user store construida sobre un modelo de identidad más antiguo. No existía una ruta de actualización in situ para ese salto, y el catálogo de APIs daba servicio a aplicaciones de varios campus que no podían coordinarse todas para una única parada.
Entorno
WSO2 API Manager e Identity Server on-premise con tenants específicos por campus, integrados con una identidad basada en LDAP y un sistema de información académica compartido.
Enfoque
AceMQ diseñó una migración con construcción en paralelo: levantar la versión de destino desde cero, migrar las definiciones de APIs y las suscripciones en lotes controlados y trasladar el tráfico tenant a tenant. Las personalizaciones se reevaluaron en lugar de portarse, porque varias existían para sortear comportamientos que la nueva versión resuelve de forma nativa.
Solución
- Inventario de APIs, suscripciones, políticas de throttling y personalizaciones frente al soporte de la versión de destino
- Construcción del despliegue de destino en paralelo en lugar de intentar una actualización in situ a través de varias versiones
- Reevaluación de cada personalización y retirada de las que sorteaban comportamientos que ahora son nativos
- Migración de definiciones de APIs y suscripciones por lotes, con verificación automatizada en cada lote
- Rediseño de la integración de identidad y del user store para el nuevo modelo de identidad
- Traslado del tráfico tenant a tenant, con marcha atrás disponible en cada paso
Resultado final
El entorno llegó a una versión con soporte mediante cambios tenant a tenant en lugar de una única parada coordinada, y la huella de personalizaciones se redujo considerablemente porque gran parte de ellas ya no era necesaria.