Visão geral
As atualizações do WSO2 API Manager que atravessam várias versões principais são migrações, e não atualizações. A estrutura do registry, as definições das APIs, os modelos de políticas de throttling e a integração de identidade mudam todos, e as ferramentas de migração partem de um estado inicial limpo que a maioria das implementações de longa duração não tem.
Desafio
A implementação estava várias versões principais atrás, com componentes carbon personalizados, 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 percurso de atualização no local que cobrisse esse intervalo, e o catálogo de APIs servia aplicações de vários campus que não podiam ser todas coordenadas para uma única paragem.
Ambiente
WSO2 API Manager e Identity Server on-premises com tenants por campus, integrados com identidade baseada em LDAP e com um sistema de informação de estudantes partilhado.
Abordagem
A AceMQ desenhou uma migração com construção em paralelo: instalar a versão de destino de raiz, migrar as definições das APIs e as subscrições em lotes controlados e transferir o tráfego tenant a tenant. As personalizações foram reavaliadas em vez de portadas, porque várias existiam para contornar comportamentos que a versão mais recente trata nativamente.
Solução
- Inventário de APIs, subscrições, políticas de throttling e personalizações face ao suporte da versão de destino
- Construção da implementação de destino em paralelo, em vez de tentar uma atualização no local ao longo de várias versões
- Reavaliação de cada personalização, retirando as que contornavam comportamentos agora nativos
- Migração das definições das APIs e das subscrições em lotes, com verificação automatizada por lote
- Revisão da integração de identidade e da user store para o modelo de identidade mais recente
- Transferência do tráfego tenant a tenant, com rollback disponível em cada passo
Resultado final
O parque chegou a uma versão suportada através de transições por tenant, em vez de uma única paragem coordenada, e o volume de personalizações diminuiu substancialmente, porque grande parte já não era necessária.