Voltar para todos os casos de uso

ConsultoriaEducação

Atravessar várias versões major do WSO2 sem perder o seu parque de APIs

Sistema de ensino superior

Planejamento de um upgrade do WSO2 API Manager que atravessa várias versões, incluindo migração do registry, nova implantação das APIs e mudanças na integração de identidade.

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

  1. Inventário de APIs, assinaturas, políticas de throttling e customizações em relação ao que a versão de destino suporta
  2. Construção da implantação de destino em paralelo, em vez de tentar um upgrade in-place atravessando várias versões
  3. Reavaliação de cada customização, aposentando as que contornavam comportamentos que agora são nativos
  4. Migração das definições das APIs e das assinaturas em lotes, com verificação automatizada em cada lote
  5. Reformulação da integração de identidade e de user store para o modelo de identidade mais recente
  6. 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.

Tecnologias

WSO2PostgreSQLKubernetesDocker

Precisa de orientação de arquitetura para WSO2?

Os engenheiros WSO2 sêniores da AceMQ já conduziram exatamente este tipo de projeto. Seja para orientação de arquitetura, correção mão na massa ou uma parceria gerenciada contínua, estamos prontos para ajudar.