1.13. GRPCRoute [gateway.networking.k8s.io/v1]

GRPCRoute は、gRPC 要求のルーティングに使用できます。これには、ホスト名、gRPC サービス、gRPC メソッド、または HTTP/2 ヘッダーで要求を照合する機能が含まれています。フィルターを使用して追加の処理ステップを指定できます。バックエンドは、一致する要求がルーティングされる場所を指定します。

GRPCRoute は、Gateway API 内の延長サポートの対象です。以下の仕様では、"〜する必要がある" という表現は、GRPCRoute をサポートする実装は示された要件に準拠する必要があることを示しています。ただし、このルートタイプをサポートしない実装は、明示的に示されない限り、要件に従う必要はありません。

HTTPS ProtocolType を使用して GRPCRoute をサポートする実装は、HTTP/1.1 からの初期アップグレードなし (つまり ALPN 経由) で HTTP/2 接続を受け入れる必要があります。実装がこれをサポートしていない場合は、影響を受けるリスナーの "Accepted" 条件を "False" に設定し、理由を "UnsupportedProtocol" にする必要があります。実装では、HTTP/1 からのアップグレードにより HTTP/2 接続も受け入れる場合があります。

HTTP ProtocolType で GRPCRoute をサポートする実装は、HTTP/1.1 からの初期アップグレードなし (つまり事前の知識なし https://www.rfc-editor.org/rfc/rfc7540#section-3.4) で、クリアテキスト TCP 経由の HTTP/2 (h2c、https://www.rfc-editor.org/rfc/rfc7540#section-3.1) をサポートする必要があります。実装がこれをサポートしていない場合は、影響を受けるリスナーの "Accepted" 条件を "False" に設定し、理由を "UnsupportedProtocol" にする必要があります。実装では、事前の知識なしで、HTTP/1 からのアップグレードにより HTTP/2 接続を受け入れる場合もあります。