概要
Kongはたいてい1チームずつ導入されていきます。その結果、認証方式に互換性がなく、ログの形式もばらばらで、何が公開されているのかを誰も一覧できない、個別に設定された複数のゲートウェイが生まれます。これらの統合は、Kongの問題である前に、アーキテクチャの問題です。
課題
4つの事業部門が、それぞれ独自のゲートウェイを立ち上げていました。認証はAPIキー、JWT、相互TLSとまちまちで、共通のコンシューマーモデルはありませんでした。設定は環境によって手作業で適用されたり宣言的な設定で適用されたりしていたため、環境間のプロモーションに再現性がありませんでした。外部から到達可能なルートの正確な一覧を作れる人もいませんでした。
環境
オンプレミスのデータセンターとマネージドKubernetesクラスターにまたがるKong。レガシーのSOAPサービスと新しいREST APIが混在する環境の前段に配置されています。
アプローチ
AceMQは、コントロールプレーンとデータプレーンを分けたハイブリッド構成のトポロジーを設計し、ゲートウェイの設定については、バージョン管理で保持し環境間でプロモーションする宣言的な唯一の情報源を用意しました。認証は共通のコンシューマーとクレデンシャルのモデルに標準化し、サービスごとの例外はその場しのぎにせず文書化しました。
ソリューション
- データプレーンをワークロードの近くに配置する、コントロールプレーン/データプレーンのハイブリッド構成のトポロジーを設計
- 設定をバージョン管理下の宣言的なファイルとして標準化し、環境間のプロモーションパイプラインを構築
- 単一のコンシューマーとクレデンシャルのモデルを定義し、レガシーサービス向けの例外を文書化
- ログ、トレーシング、リクエストサイズの制限、レート制限について、共通のプラグインのベースラインを確立
- サービスごとの並行稼働とロールバックを含め、各事業部門のルートを段階的に移行する計画を策定
- 外部から到達可能なルートとその認証の状況について、正式な一覧を作成
結果
各事業部門は、全社一斉の切り替えを行うことなく、順番に単一のゲートウェイトポロジーへ移行しました。ゲートウェイの設定は手作業で適用するものから、プルリクエストでレビューできるものに変わりました。