Descripción general
Las actualizaciones de WSO2 API Manager que atraviesan varias versiones mayores son migraciones, no actualizaciones. Cambian la estructura del registry, las definiciones de las APIs, los modelos de políticas de throttling y la integración de identidad, y las herramientas de migración asumen un estado inicial limpio que la mayoría de los despliegues con muchos años de uso no tienen.
Desafío
El despliegue estaba varias versiones mayores atrasado, con componentes carbon personalizados, configuraciones de synapse editadas a mano y una integración de user store construida sobre un modelo de identidad más antiguo. No existía una ruta de actualización in-place que cubriera ese salto, y el catálogo de APIs atendía aplicaciones de varios campus que no podían coordinarse todos para una sola ventana de interrupción.
Entorno
WSO2 API Manager e Identity Server on-premise con tenants específicos por campus, integrados con identidad respaldada en LDAP y con un sistema de información estudiantil 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 pasar el tráfico tenant por tenant. Las personalizaciones se reevaluaron en lugar de trasladarse, porque varias existían para sortear comportamientos que la versión más nueva resuelve de forma nativa.
Solución
- Inventario de APIs, suscripciones, políticas de throttling y personalizaciones frente a lo que soporta la versión de destino
- Construcción del despliegue de destino en paralelo en lugar de intentar una actualización in-place a través de varias versiones
- Reevaluación de cada personalización y retiro de las que sorteaban comportamientos que ahora son nativos
- Migración de las definiciones de APIs y de las suscripciones en lotes, con verificación automatizada en cada lote
- Rediseño de la integración de identidad y de user store para el modelo de identidad más nuevo
- Corte del tráfico tenant por tenant, con rollback disponible en cada paso
Resultado final
El entorno llegó a una versión con soporte mediante cortes por tenant en lugar de una única interrupción coordinada, y la cantidad de personalizaciones se redujo de forma considerable porque buena parte ya no era necesaria.