APIゲートウェイのコントロールプレーンとデータプレーン
設定管理とライブAPIリクエスト処理を分離するための、短く実践的なアーキテクチャガイドです。
目次
pi 的agent 架构
APIゲートウェイは、設定管理とリクエスト処理を別の責務として扱うと運用しやすくなります。
2つのプレーンと役割
| プレーン | 主な役割 | 代表的なデータ |
|---|---|---|
| コントロール | 望ましい状態を管理 | ルート、プロバイダー、価格、ポリシー |
| データ | ライブリクエストを処理 | 認証、ルーティング、計測、レスポンス |
コントロールプレーンは完全な設定を検証して公開します。データプレーンは承認済みバージョンを読み、トラフィック処理を継続します。
安全な更新手順
- 候補設定全体を検証する。
- 変更不能なバージョンとして公開する。
- アクティブポインターを原子的に切り替える。
- 影響するキャッシュだけを無効化する。
- 実リクエストを確認し、旧版をロールバック用に残す。
監視と判断
設定バージョン、ルーティングエラー、上流遅延、ロールバック状態を分けて監視します。編集とレビューはコントロール側に、認証、ルーティング、クォータ、ストリーミングはデータ側に置くのが明確です。