第16章 GatewayClass [gateway.networking.k8s.io/v1]

controllerName

string

ControllerName は、このクラスのゲートウェイを管理しているコントローラーの名前です。このフィールドの値は、接頭辞としてドメインが追加されたパスである必要があります。

例: "example.net/gateway-controller"

このフィールドは変更不可であり、空にすることはできません。

サポート: Core

description

string

description は、GatewayClass をより詳細に説明するために役立ちます。

parametersRef

object

ParametersRef は、GatewayClass に対応する設定パラメーターが含まれるリソースへの参照です。コントローラーに追加の設定が必要ない場合はオプションです。

ParametersRef は、標準の Kubernetes リソース (つまり ConfigMap) または実装固有のカスタムリソースを参照できます。タースコープと namespace スコープのリソースが対象です。

参照先が見つからない場合、サポートされていない kind を参照している場合、またはそのリソース内のデータが不正な形式である場合、GatewayClass は "Accepted" ステータス条件が "False" に設定され、"InvalidParameters" の理由で拒否される必要があります。

この GatewayClass のゲートウェイは独自の parametersRef を提供する場合があります。両方が指定されている場合、マージ動作は実装固有です。一般的に、GatewayClass では、ゲートウェイによってオーバーライドできるデフォルトを指定することが推奨されます。

サポート: 実装固有

group

string

group は参照先のグループです。

kind

string

kind は参照先の kind です。

name

string

name は参照先の名前です。

namespace

string

namespace は参照先の namespace です。このフィールドは、namespace スコープのリソースを参照する場合は必須です。クラスタースコープのリソースを参照する場合は、設定を解除する必要があります。

conditions

array

Conditions は、この GatewayClass のコントローラーからの現在のステータスです。

コントローラーは、各 condition のタイプに応じて GatewayClassConditionType の値を使用して条件を公開することを優先する必要があります。

conditions[]

object

条件には、この API リソースの現在の状態の詳細が含まれます。

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。

message

string

message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。

observedGeneration

integer

observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。

reason

string

reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。

status

string

条件のステータス、True、False、Unknown のいずれか。

type

string

CamelCase または foo.example.com/CamelCase の条件のタイプ。