spring-cloud-gateway

Spring Cloud Gateway

ゲートウェイはエッジアダプターとして維持します。ドメインのワークフローをフィルターに移さないでください。

互換性を最優先

• Boot の正確なマイナーバージョンに対応する Spring Cloud リリーストレインを選択します。
• Spring Cloud BOM をインポートし、個々の Spring Cloud 依存関係のバージョン指定は省略します。
• プロジェクトで意図的に MVC バリアントを使用している場合を除き、リアクティブゲートウェイを優先します。

ルートのルール

• 安定したルート ID と明示的な述語を使用します。
• 信頼できない転送用、ID 用、内部用のヘッダーはエッジで削除します。
• クライアントから渡された値を削除してから、相関ヘッダーを追加します。
• パスの書き換えとホストの変更は、ルート設定で明確にします。
• 接続タイムアウトとレスポンスタイムアウトは全体に設定し、ルートごとの上書きは必要最小限にします。

セキュリティとレジリエンス

• エッジで認証し、下流のサービスでも認可を行います。
• トークンは、意図したオーディエンスにのみ中継します。
• レート制限には、未検証のヘッダーではなく、信頼できる ID または API キーを使用します。
• リトライするのは、レスポンスの確定前に限り、冪等性のある操作だけにします。
• 障害が発生している依存関係にはサーキットブレーカーを使用し、無制限のリトライで継続的な障害を隠さないでください。

テストと運用

• 述語、フィルター、ヘッダーの削除、ステータスのマッピング、タイムアウトをテストします。
• 統合テストには WireMock またはコンテナ化した上流サービスを使用します。
• タグの種類を制限して、ルート ID、結果、レイテンシー、上流のメトリクスを出力します。

例

• examples/good-routes.yml と examples/bad-routes.yml を参照してください。

注意点

• エージェントがパブリックリクエストの X-User-Id を信頼しています。認証後に ID を導出してください。
• エージェントが POST リクエストをデフォルトでリトライしています。冪等性が証明された操作だけをリトライしてください。
• エージェントがビジネスオーケストレーションをゲートウェイフィルターに追加しています。ドメインロジックは下流に置いてください。
• エージェントがレスポンスタイムアウトを設定していません。上流の応答停止により、ゲートウェイのリソースが枯渇するおそれがあります。
• エージェントが互換性のない Spring Cloud と Boot のバージョンを組み合わせています。公式の互換性マトリクスを使用してください。