Microservices Engine:MSE Ingress ゲートウェイでサポートされるアノテーション

NGINX Ingress アノテーションのカバー率

MSE は NGINX とは異なる方法で機能を実装しています。NGINX Ingress アノテーションやコードスニペットで使用される NGINX 変数は、NGINX の対応するものと互換性がありません。

large リクエストボディ: nginx.ingress.kubernetes.io/proxy-body-size アノテーションは、NGINX のリクエストボディの最大サイズを設定し、それを超えるリクエストを拒否します。 MSE では代わりにチャンク転送エンコーディングを使用し、large な本文をサイズ制限なく自動的に処理します。 アップストリーム接続のバッファー制限を設定するには、MSE ゲートウェイの [パラメーター設定] ペインで [DownstreamConnectionBufferLimits] パラメーターを設定します。

リダイレクトと NGINX 変数： リダイレクトアノテーション内の NGINX 変数 (例：$host や $request_uri) は、一部の NGINX Ingress バージョンで動作する場合がありますが、公式にはドキュメント化されていません。NGINX Ingress でのリダイレクトに NGINX 変数を使用することは避けてください。これらは MSE と互換性がありません。

MSE 専用アノテーション

アノテーションのスコープ

各アノテーションは、次の 3 つのスコープのいずれかに適用されます。

• Ingress — Ingress リソースで定義されたルーティングルールに適用されます。

• ドメイン — Ingress リソースで定義されたホスト名に適用され、他の Ingress リソースの同じホスト名にも効果があります。

• サービス — Ingress リソースによって参照されるバックエンドサービスに適用され、他の Ingress リソースによって参照される同じサービスにも効果があります。

アノテーションのプレフィックス

MSE 互換のアノテーションは、nginx または mse のプレフィックスのいずれかを受け入れます。例えば、nginx.ingress.kubernetes.io/ssl-redirect と mse.ingress.kubernetes.io/ssl-redirect は同等です。

MSE 専用のアノテーションは mse プレフィックスのみを使用します。これらのアノテーションで mse を nginx に置き換えても効果はありません。

クイックリファレンスインデックス

次の表は、サポートされているすべてのアノテーションとその互換性ステータスおよびカテゴリを一覧表示しています。この表を使用して、以下の詳細を読む前に特定のアノテーションがサポートされているかどうかをすばやく確認してください。

トラフィックガバナンス

annotations:
  # トラフィックの 60% を foo に、40% を bar にルーティング
  mse.ingress.kubernetes.io/destination: |
    60% foo.default.svc.cluster.local:8080
    40% bar.default.svc.cluster.local:9090

セキュリティ保護