概要
複数のメジャーバージョンをまたぐWSO2 API Managerのアップグレードは、アップグレードではなく移行です。レジストリの構造、APIの定義、スロットリングポリシーのモデル、ID連携のすべてが変わり、しかも移行ツールは、長年運用されてきた多くの環境にはないクリーンな初期状態を前提としています。
課題
この環境は数メジャーバージョン遅れており、カスタマイズされたCarbonコンポーネント、手作業で編集されたSynapseの設定、旧来のIDモデルに基づいて構築されたユーザーストアの連携を抱えていました。それだけのバージョン差をインプレースでアップグレードする手段はなく、APIカタログは複数のキャンパスにまたがるアプリケーションにサービスを提供していたため、すべてを1回の停止に合わせて調整することもできませんでした。
環境
キャンパスごとのテナントを持つオンプレミスのWSO2 API ManagerとIdentity Server。LDAPベースのIDと共有の学生情報システムと連携。
アプローチ
AceMQは、並行構築による移行を設計しました。移行先のバージョンをクリーンな状態で立ち上げ、APIの定義とサブスクリプションを管理されたバッチ単位で移行し、テナントごとにトラフィックを切り替えます。カスタマイズはそのまま移植するのではなく、改めて評価しました。そのいくつかは、新しいバージョンではネイティブに処理される挙動を回避するために存在していたからです。
ソリューション
- API、サブスクリプション、スロットリングポリシー、カスタマイズを洗い出し、移行先のバージョンでの対応状況と照合
- 複数バージョンをまたぐインプレースのアップグレードを試みるのではなく、移行先の環境を並行して構築
- 各カスタマイズを再評価し、ネイティブ対応となった挙動を回避するためのものは廃止
- APIの定義とサブスクリプションをバッチ単位で移行し、バッチごとに自動で検証
- 新しいIDモデルに合わせて、IDとユーザーストアの連携を再構築
- 各ステップでロールバック可能な状態を保ちながら、テナントごとにトラフィックを切り替え
結果
1回の調整された停止ではなく、テナントごとの切り替えによって、環境全体がサポート対象のバージョンに到達しました。また、カスタマイズの多くはもはや不要だったため、カスタマイズの規模も大幅に縮小しました。