サポートされているGateway API CRD
以下のセクションでは、最新リリースバージョンにおける各Kubernetes Gateway API CRDでサポートされているパラメータの概要を説明します。このトピックに記載されているサポート対象外のパラメータまたはCRDは、現在サポートされていません。
ゲートウェイクラスCRD
| プロパティ | 説明 | ステータス |
|---|---|---|
| spec.controllerName | コントローラーのデプロイ時に指定された名前と一致する必要があるコントローラーの名前。 | サポート対象 |
| spec.description | GatewayClassの人間が読める説明。 | サポート対象 |
| status.conditions | コントローラーからのこのGatewayClassのステータスは、「Conditions」で確認できます。 | サポート対象 |
ゲートウェイ CRD
| プロパティ | 説明 | ステータス |
|---|---|---|
| spec.addresses | IPアドレスのリスト。コントローラーはすべてのアドレスを使用し、ipsetを作成します。コントローラーは、NetScaler上に作成されたコンテンツスイッチング仮想サーバーの仮想IPアドレスとしてipsetを使用します。 | サポート対象 |
| spec.gatewayClassName | このGatewayが属するGatewayClassの名前。 | サポート対象 |
| spec.listeners | Gatewayが公開するネットワークエンドポイント（リスナー）のリスト。 | サポート対象 |
| spec.listeners.name | リスナーの名前。この名前は、Gateway内で一意である必要があります。 | サポートされています |
| spec.listeners[].ポート | リスナーのポート番号。コントローラーは、このポートをNetScaler上に作成されたコンテンツスイッチング仮想サーバーポートとして使用します。 | サポートされています |
| spec.listeners[].プロトコル | リスナーが受信を期待するネットワークプロトコル。コントローラーは、このプロトコルをNetScaler上に作成されたコンテンツスイッチング仮想サーバーの仮想サーバーIPアドレスとして使用します。 | サポートされています |
| spec.listeners[].tls.certificateRefs | CertificateRefsには、TLS証明書と秘密鍵を含むKubernetesオブジェクトへの一連の参照が含まれています。現在、コントローラーはKubernetesシークレットのみをサポートしています。 | 部分的にサポートされています |
HTTProute カスタムリソース定義
| プロパティ | 説明 | ステータス |
|---|---|---|
| spec.hostnames | このルートが一致するホスト名のリスト。コントローラーは、コンテンツスイッチングポリシーのルール式でホスト名を使用します。 | サポートされています |
| spec.parentRefs[] | このルートがアタッチするGatewayへの参照。 | 部分的にサポートされています |
| spec.parentRefs[].種類 | コントローラーは、以下のparentRefsのみをサポートします: Gateway | 部分的にサポートされています |
| spec.parentRefs[].名前 | Gatewayリソースの名前。 | サポートされています |
| spec.parentRefs[].ネームスペース | Gatewayリソースの名前空間。 | サポートされています |
| spec.rules[] | コントローラーは、コンテンツスイッチングポリシーのルール式を生成するためにこれらのルールを使用します。 | サポートされています |
| spec.ルール[].一致 | コントローラーは、パス、メソッド、クエリパラメータ、ヘッダーなどを使用して、NetScaler 上でコンテンツスイッチングポリシーのルールを作成します。 | サポートされています |
| spec.rules[].backendRefs | 現在、コントローラーは以下の backendRefs のみをサポートしています: service、name、namespace、および port。 | 部分的にサポートされています |
| spec.ルール[].フィルター | コントローラーは以下のフィルターをサポートしています: urlRewrite、requestRedirect、responseHeaderModifier、requestHeaderModifier、extensionRef | 部分的にサポートされています |
TCPRoute CRDについて
TCPRoute は、Gateway リスナーからバックエンドの Kubernetes サービスへの TCP トラフィックルーティングを可能にします。
| プロパティ | 説明 | ステータス |
|---|---|---|
| spec.parentRefs[] | このルートがアタッチするGatewayへの参照 | 部分的にサポート |
| spec.parentRefs[].種類 | 現在、コントローラーは以下のparentRefsのみをサポートしています: Gateway | サポート済み |
| spec.parentRefs[].名前 | Gatewayリソースの名前。 | サポート済み |
| spec.親参照[].名前空間 | Gatewayリソースの名前空間。 | サポート済み |
| spec.parentRefs[].sectionName | アタッチする特定のGatewayリスナーの名前。 | サポートされています |
| spec.rules[] | TCPトラフィックがバックエンドサービスにルーティングされる方法を定義するルールの一覧。 | サポートされています |
| spec.rules[].backendRefs[] | 現在、コントローラーは以下のbackendRefsのみをサポートしています: service、name、namespace、port。 | 部分的にサポートされています |
UDPRoute カスタムリソース定義
UDPRouteは、GatewayリスナーからバックエンドのKubernetesサービスへのUDPトラフィックルーティングを可能にします。
| プロパティ | 説明 | ステータス |
|---|---|---|
| spec.parentRefs[] | このルートがアタッチするGatewayへの参照 | 部分的にサポートされています |
| spec.parentRefs[].kind フィールド | 現在、コントローラーは以下のparentRefsのみをサポートしています: Gateway | 対応済み |
| spec.parentRefs[]のname | Gatewayリソースの名前。 | 対応済み |
| 仕様.親参照[].名前空間 | Gatewayリソースの名前空間。 | 対応済み |
| spec.parentRefs[].sectionName | アタッチする特定のGatewayリスナーの名前。 | 対応済み |
| spec.rules[] | UDPトラフィックがバックエンドサービスにルーティングされる方法を定義するルールの一覧。 | 対応済み |
| spec.rules[].backendRefs[] | 現在、コントローラーは以下のbackendRefsのみをサポートしています: service, name, namespace, port | 部分的にサポートされています |
注意点
-
コントローラーは、以前にリストされたサポートされているパラメーターのみを考慮し、サポートされていないパラメーターは無視されます。
-
将来のバージョンでは、追加のパラメーターのサポートが拡張される可能性があります。
-
コントローラーによって認識されるように、Gatewayリソースに対して
gatewayClassNameが正しく設定されていることを確認してください。 -
HTTPRoute内のすべてのparentRefsは、既存の有効なGatewayを正しく参照している必要があります。 -
ステータス更新は動的に管理され、システム負荷に基づいて反映されるまでに時間がかかる場合があります。
-
CRDを適用する際には、解析エラーや検証エラーがないかログを監視する必要があります。
-
Gateway CRDで使用されるIPアドレスは、IngressまたはCitrix® Listenerリソースと共有することはできません。