전체 사례로 돌아가기

컨설팅교육

API 자산을 잃지 않고 WSO2 메이저 버전 여러 개를 건너뛰기

고등교육 기관 네트워크

레지스트리 마이그레이션, API 재배포, ID 연동 변경을 포함해 여러 버전을 건너뛰는 WSO2 API Manager 업그레이드를 계획했습니다.

개요

여러 메이저 버전을 건너뛰는 WSO2 API Manager 업그레이드는 업그레이드가 아니라 마이그레이션입니다. 레지스트리 구조, API 정의, 스로틀링 정책 모델, ID 연동이 모두 바뀌며, 마이그레이션 도구는 오래 운영된 대부분의 배포 환경이 갖추지 못한 깨끗한 시작 상태를 전제로 합니다.

과제

배포 환경은 메이저 버전이 여러 개 뒤처져 있었고, 커스터마이징된 carbon 컴포넌트, 수작업으로 편집한 synapse 구성, 이전 ID 모델을 기준으로 구축한 사용자 저장소 연동이 있었습니다. 그만큼의 버전 차이를 건너는 인플레이스 업그레이드 경로는 존재하지 않았고, API 카탈로그는 여러 캠퍼스의 애플리케이션에 서비스하고 있어 한 번의 중단 작업에 모두를 맞출 수 없었습니다.

환경

캠퍼스별 테넌트를 둔 온프레미스 WSO2 API Manager 및 Identity Server로, LDAP 기반 ID와 공용 학사 정보 시스템을 연동합니다.

접근 방식

AceMQ는 병렬 구축 방식의 마이그레이션을 설계했습니다. 대상 버전을 깨끗하게 구축하고, API 정의와 구독을 통제된 배치 단위로 옮기며, 테넌트별로 트래픽을 전환합니다. 커스터마이징은 그대로 이식하지 않고 다시 평가했습니다. 그중 여러 개는 새 버전이 기본으로 처리하는 동작을 우회하기 위해 존재했기 때문입니다.

해결책

  1. API, 구독, 스로틀링 정책, 커스터마이징을 목록화하고 대상 버전의 지원 여부와 대조
  2. 여러 버전을 건너뛰는 인플레이스 업그레이드를 시도하지 않고 대상 배포 환경을 병렬로 구축
  3. 각 커스터마이징을 다시 평가해, 이제 기본 기능이 된 동작을 우회하던 것들을 폐기
  4. 배치별 자동 검증을 거치며 API 정의와 구독을 배치 단위로 마이그레이션
  5. 새 ID 모델에 맞춰 ID 및 사용자 저장소 연동 재작업
  6. 단계마다 롤백이 가능한 상태로 테넌트별 트래픽 전환

성과

한 번의 일괄 중단 작업이 아니라 테넌트별 전환으로 전체 환경이 지원 대상 버전에 도달했고, 상당 부분이 더 이상 필요 없어지면서 커스터마이징 규모가 크게 줄었습니다.

기술

WSO2PostgreSQLKubernetesDocker

WSO2 아키텍처 가이드가 필요하신가요?

AceMQ의 시니어 WSO2 엔지니어는 바로 이런 유형의 프로젝트를 수행한 경험이 있습니다. 아키텍처 가이드, 실무 문제 해결, 지속적인 매니지드 파트너십 등 무엇이 필요하든 도와드릴 준비가 되어 있습니다.