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

addresses

数组（字符串）

此端点的地址。对于 addressType "IPv4" 或 "IPv6" 的 EndpointSlices，值是规范形式的 IP 地址。未定义其他 addressType 值的语法和语义。这必须至少包含一个地址，但没有超过 100 个。EndpointSlice 控制器生成的 endpointslices 始终具有 1 地址。没有为第一个地址以外的其他地址定义语义，kube-proxy 不会查看它们。

conditions

对象

EndpointConditions 代表端点的当前条件。

deprecatedTopology

对象（字符串）

deprecatedTopology 包含 v1beta1 API 的拓扑信息部分。此字段已弃用，并在 v1beta1 API 被删除时删除（不早于 kubernetes v1.24）。虽然此字段可以保存值，但无法通过 v1 API 写入值，但任何尝试写入它都将静默忽略。拓扑信息可在 zone 和 nodeName 字段中找到。

hints

对象

EndpointHints 提供了描述如何使用端点的提示。

hostname

字符串

此端点的主机名。此字段可由端点使用者使用，以区分不同的端点（例如在 DNS 名称中）。使用相同主机名的多个端点应被视为无限（例如，DNS 中的多个 A 值）。必须是小写并传递 DNS 标签(RFC 1123)验证。

nodeName

字符串

nodeName 代表托管此端点的节点的名称。这可用于确定本地到节点的端点。

targetRef

ObjectReference

TargetRef 是代表此端点的 Kubernetes 对象的引用。

zone

字符串

zone 是此端点所在的区域的名称。

ready

布尔值

Ready 表示此端点已准备好接收流量，具体取决于任何系统正在管理端点。nil 值应解释为 "true"。通常，如果端点服务且未终止，则端点应标记为 ready，但在某些情况下可以被覆盖，比如在关联的服务设置了 publishNotReadyAddresses 标志时。

serving

布尔值

serving 表示此端点可以根据管理端点的任何系统接收流量。对于 pod 支持的端点，如果 pod 的 Ready 条件为 True，则 EndpointSlice 控制器会将端点标记为 service。nil 值应解释为 "true"。

Terminating

布尔值

Terminating 表示此端点正在终止。nil 值应解释为 "false"。

forNodes

数组

forNodes 表示在使用拓扑感知路由时此端点应该被消耗的节点。最多可包含 8 个条目。这是一个 Alpha 功能，仅在启用 PreferSameTrafficDistribution 功能门时使用。

forNodes[]

object

ForNode 提供有关哪些节点应该消耗此端点的信息。

forZones

数组

forZones 表示在使用拓扑感知路由时此端点应使用的区域。最多可包含 8 个条目。

forZones[]

对象

ForZone 提供有关哪些区域应使用此端点的信息。

name

string

name 代表节点的名称。

name

字符串

name 代表区域的名称。

appProtocol

字符串

此端口的应用程序协议。这用作实现的提示，以便为它们理解的协议提供更丰富的行为。此字段遵循标准 Kubernetes 标签语法。有效值为：

* 未前缀的协议名称 - 为 IANA 标准服务名称保留（如 RFC-6335 和 https://www.iana.org/assignments/service-names）。

* Kubernetes-defined prefixed name: * 'kubernetes.io/h2c' - HTTP/2 before knowledge overtext as https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior- * 'kubernetes.io/ws' - WebSocket over cleartext，如 https://www.rfc-editor.org/rfc/rfc6455 * 'kubernetes.io/wss' - WebSocket over TLS 所述

* 其他协议应使用定义实施的前缀名称，如 mycompany.com/my-custom-protocol。

name

string

name 表示此端口的名称。EndpointSlice 中的所有端口都必须具有唯一的名称。如果 EndpointSlice 派生自 Kubernetes 服务，则对应于 Service.ports[].name。name 必须是空字符串或传递 DNS_LABEL 验证：* 不得超过 63 个字符。* 必须包含小写字母数字字符或 '-'。* 必须以字母数字字符开头和结尾。默认为空字符串。

port

整数

port 代表端点的端口号。如果 EndpointSlice 派生自 Kubernetes 服务，则必须将其设置为服务的目标端口。用于其他目的的端点slices 可能会有一个 nil 端口。

protocol

string

protocol 代表此端口的 IP 协议。必须是 UDP、TCP 或 SCTP。默认为 TCP。

可能枚举值： - "SCTP" 是 SCTP 协议。- "TCP" 是 TCP 协议。- "UDP" 是 UDP 协议。