第12章 EndpointSlice [discovery.k8s.io/v1]

addresses

array (string)

このエンドポイントのアドレス。addressType "IPv4" または "IPv6" の EndpointSlices の場合、値は正規の形式の IP アドレスです。他の addressType 値の構文およびセマンティクスは定義されません。これには、少なくとも 1 つのアドレスが含まれている必要がありますが、100 を超えてはなりません。EndpointSlice コントローラーによって生成された endpoint スライスには、常に 1 つのアドレスがあります。最初を超える追加のアドレスにはセマンティクスが定義されておらず、kube-proxy はこれらを確認しません。

conditions

object

EndpointConditions は、エンドポイントの現在の状態を表します。

deprecatedTopology

object (string)

deprecatedTopology には、v1beta1API のトポロジー情報部分が含まれています。このフィールドは非推奨であり、v1beta1 API が削除されると削除されます (kubernetes v1.24 より早く)。このフィールドは値を保持できますが、v1 API を介して書き込むことはできず、このフィールドに書き込もうとすると、黙って無視されます。トポロジー情報は、代わりに zone フィールドと nodeName フィールドにあります。

hints

object

EndpointHints は、エンドポイントの消費方法を説明するヒントを提供します。

hostname

string

このエンドポイントのホスト名。このフィールドは、エンドポイントのコンシューマーがエンドポイントを相互に区別するために使用できます (DNS 名など)。同じホスト名を使用する複数のエンドポイントは代替可能と見なす必要があります (たとえば、DNS の複数の A 値)。小文字で、DNS ラベル (RFC 1123) 検証に合格する必要があります。

nodeName

string

nodeName は、このエンドポイントをホストしているノードの名前を表します。これは、ノードにローカルなエンドポイントを決定するために使用できます。

targetRef

ObjectReference

targetRef は、このエンドポイントを表す Kubernetes オブジェクトへの参照です。

zone

string

zone は、このエンドポイントが存在するゾーンの名前です。

ready

boolean

ready は、エンドポイントを管理しているシステムに応じて、このエンドポイントがトラフィックを受信する準備ができていることを示します。nil 値は true として解釈する必要があります。一般に、エンドポイントは提供され、終了していない場合は準備完了としてマークする必要がありますが、関連付けられたサービスが publishNotReadyAddresses フラグを設定した場合など、これは場合によっては上書きできます。

サービング

boolean

serving は、エンドポイントを管理しているシステムに応じて、このエンドポイントがトラフィックを受信できることを示します。Pod でサポートされるエンドポイントの場合、EndpointSlice コントローラーは、Pod の Ready 状態が True の場合に、エンドポイントを機能としてマークします。nil 値は true として解釈する必要があります。

terminating

boolean

終了は、このエンドポイントが終了していることを示します。nil 値は false として解釈する必要があります。

forNodes

array

forNodes は、トポロジー対応ルーティングを使用する場合に、このエンドポイントが消費する必要があるノードを示します。最大 8 つのエントリーを含めることができます。これはアルファベット機能であり、PreferSameTrafficDistribution フィーチャーゲートが有効になっている場合にのみ使用されます。

forNodes[]

object

ForNode は、このエンドポイントを消費するノードに関する情報を提供します。

forZones

array

forZones は、トポロジー対応ルーティングを使用する場合に、このエンドポイントが消費する必要があるゾーンを示します。最大 8 つのエントリーを含めることができます。

forZones[]

object

ForZone は、このエンドポイントを消費するゾーンに関する情報を提供します。

name

string

name はノードの名前を表します。

name

string

name はゾーンの名前を表します。

appProtocol

string

このポートのアプリケーションプロトコル。これは、実装が理解できるプロトコルの動作をさらに多く提供できるようにヒントとして使用されます。このフィールドは、標準の Kubernetes ラベル構文に従います。有効な値は以下のいずれかになります。

* 接頭辞のないプロトコル名 - IANA 標準サービス名用に予約されています (RFC-6335 および https://www.iana.org/assignments/service-names に準拠)。

* Kubernetes によって定義された接頭辞の名前: * 'kubernetes.io/h2c' - クリアテキスト経由の HTTP/2 事前知識 (https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior- を参照)。* 'kubernetes.io/ws' - クリアテキスト経由の WebSocket (https://www.rfc-editor.org/rfc/rfc6455 を参照)。* 'kubernetes.io/wss' - TLS 経由の WebSocket (https://www.rfc-editor.org/rfc/rfc6455 を参照)。

* 他のプロトコルは、mycompany.com/my-custom-protocol など、実装定義の接頭辞名を使用する必要があります。

name

string

name は、このポートの名前を表します。EndpointSlice のすべてのポートには、一意の名前を付ける必要があります。EndpointSlice が Kubernetes サービスから派生している場合、これは Service.ports[].name に対応します。名前は空の文字列であるか、DNS_LABEL 検証に合格する必要があります。*長さは 63 文字以下である必要があります。* 小文字の英数字または '-' で構成する必要があります。*英数字で開始および終了する必要があります。デフォルトは空の文字列です。

port

integer

port は、エンドポイントのポート番号を表します。EndpointSlice が Kubernetes サービスから派生している場合、これはサービスのターゲットポートに設定する必要があります。他の目的で使用されるエンドポイントスライスは、nil ポートを持つ場合があります。

protocol

string

protocol は、このポートの IP プロトコルを表します。UDP、TCP、または SCTP である必要があります。デフォルトは TCP です。

使用可能な列挙値: - "SCTP" は SCTP プロトコル、"TCP" は TCP プロトコル、"UDP" は UDP プロトコルです。