Visão geral
Upgrades do WSO2 API Manager que atravessam várias versões major são migrações, e não upgrades. A estrutura do registry, as definições das APIs, os modelos de políticas de throttling e a integração de identidade mudam, e as ferramentas de migração pressupõem um ponto de partida limpo que a maioria das implantações antigas não tem.
Desafio
A implantação estava várias versões major atrasada, com componentes carbon customizados, configurações synapse editadas à mão e uma integração de user store construída sobre um modelo de identidade mais antigo. Não existia um caminho de upgrade in-place para um salto desse tamanho, e o catálogo de APIs atendia aplicações de vários campi que não podiam ser todas coordenadas para uma única janela de indisponibilidade.
Ambiente
WSO2 API Manager e Identity Server on-premises com tenants por campus, integrando identidade baseada em LDAP e um sistema acadêmico compartilhado.
Abordagem
A AceMQ desenhou uma migração com ambiente paralelo: subir a versão de destino do zero, migrar as definições das APIs e as assinaturas em lotes controlados e fazer o cutover do tráfego por tenant. As customizações foram reavaliadas em vez de portadas, porque várias existiam apenas para contornar comportamentos que a versão mais nova já trata nativamente.
Solução
- Inventário de APIs, assinaturas, políticas de throttling e customizações em relação ao que a versão de destino suporta
- Construção da implantação de destino em paralelo, em vez de tentar um upgrade in-place atravessando várias versões
- Reavaliação de cada customização, aposentando as que contornavam comportamentos que agora são nativos
- Migração das definições das APIs e das assinaturas em lotes, com verificação automatizada em cada lote
- Reformulação da integração de identidade e de user store para o modelo de identidade mais recente
- Cutover do tráfego por tenant, com rollback disponível em cada etapa
Resultado obtido
O parque chegou a uma versão com suporte por meio de cutovers por tenant, em vez de uma única indisponibilidade coordenada, e o volume de customizações diminuiu bastante, porque boa parte delas já não era necessária.