概覽
跨越多個主要版本的 WSO2 API Manager 升級,實際上是遷移,而不是升級。Registry 結構、API 定義、流量限制政策模型與身分識別整合全都會改變,而遷移工具假設的是一個乾淨的起始狀態,大多數長期運作的部署並不具備。
挑戰
這套部署落後了好幾個主要版本,包含客製化的 carbon 元件、手動修改過的 synapse 設定,以及依據較舊身分識別模型建置的使用者存放區整合。橫跨這麼大的版本差距,並不存在就地升級的路徑;而且 API 目錄服務的是分布在多個校區的應用程式,不可能全部協調在同一次停機中完成。
環境
地端部署的 WSO2 API Manager 與 Identity Server,依校區劃分租戶,並整合以 LDAP 為後端的身分識別與共用的學生資訊系統。
做法
AceMQ 設計了平行建置的遷移方式:以乾淨的方式建立目標版本,分批有控制地遷移 API 定義與訂閱,再逐一租戶切換流量。客製化項目是重新評估,而不是直接移植,因為其中有好幾項原本是為了繞過新版本已能原生處理的行為。
解決方案
- 盤點 API、訂閱、流量限制政策與客製化項目,並對照目標版本的支援情形
- 以平行方式建置目標部署,而不是嘗試跨多個版本就地升級
- 重新評估每一項客製化,淘汰那些用來繞過如今已原生支援之行為的項目
- 分批遷移 API 定義與訂閱,並對每一批進行自動化驗證
- 針對新版身分識別模型,重新設計身分識別與使用者存放區整合
- 逐一租戶切換流量,每一步都保留回復選項
成效
整個環境透過逐一租戶切換升級到受支援的版本,而不需要一次全面協調的停機;客製化的範圍也大幅縮小,因為其中許多項目已不再需要。