From 88998d4a7fe96f4eee273906a7724c22a42061a2 Mon Sep 17 00:00:00 2001 From: "zhenghao.zhu" Date: Wed, 17 May 2023 22:19:35 +0800 Subject: [PATCH] [zh] resync 1.27 policy resources/ & endpoint-slice-v1.md --- .../policy-resources/limit-range-v1.md | 12 ++++ .../pod-disruption-budget-v1.md | 25 ++++++- .../policy-resources/resource-quota-v1.md | 12 ++++ .../service-resources/endpoint-slice-v1.md | 67 ++++++++++++------- 4 files changed, 92 insertions(+), 24 deletions(-) diff --git a/content/zh-cn/docs/reference/kubernetes-api/policy-resources/limit-range-v1.md b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/limit-range-v1.md index 1ee5af68a3..f00b43a084 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/policy-resources/limit-range-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/limit-range-v1.md @@ -256,6 +256,10 @@ GET /api/v1/namespaces/{namespace}/limitranges }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds @@ -327,6 +331,10 @@ GET /api/v1/limitranges }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds @@ -645,6 +653,10 @@ DELETE /api/v1/namespaces/{namespace}/limitranges }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds diff --git a/content/zh-cn/docs/reference/kubernetes-api/policy-resources/pod-disruption-budget-v1.md b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/pod-disruption-budget-v1.md index 152b0c4d48..baea2d148a 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/policy-resources/pod-disruption-budget-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/pod-disruption-budget-v1.md @@ -196,6 +196,16 @@ PodDisruptionBudgetStatus 表示有关此 PodDisruptionBudget 状态的信息。 当前允许的 Pod 干扰计数。 + + +- **expectedPods** (int32), 必需 + + 此干扰预算计入的 Pod 总数 + - **conditions** ([]Condition) @@ -585,6 +596,10 @@ GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + 必需 addressType 指定当前 EndpointSlice 携带的地址类型。一个 EndpointSlice 只能携带同一类型的地址。 EndpointSlice 对象创建完成后不可以再更改 addressType 字段。 - - 目前支持的地址类型为： * IPv4：表示 IPv4 地址。 @@ -109,17 +105,18 @@ EndpointSlice 是实现某 Service 的端点的子集。一个 Service 可以有 - **endpoints.conditions.ready** (boolean) ready 说明此端点已经准备好根据相关的系统映射接收流量。nil 值表示状态未知。 在大多数情况下，消费者应将这种未知状态视为就绪（ready）。 - 考虑到兼容性，对于正在结束状态下的端点，永远不能将 ready 设置为“true”。 + 考虑到兼容性，对于正在结束状态下的端点，永远不能将 ready 设置为“true”， + 除非正常的就绪行为被显式覆盖，例如当关联的服务设置了 publishNotReadyAddresses 标志时。 - **endpoints.conditions.serving** (boolean) serving 和 ready 非常相似。唯一的不同在于, @@ -139,7 +136,7 @@ EndpointSlice 是实现某 Service 的端点的子集。一个 Service 可以有 - **endpoints.deprecatedTopology** (map[string]string) deprecatedTopology 包含 v1beta1 API 的拓扑信息部分。目前已经弃用了此字段， @@ -255,26 +252,26 @@ EndpointSlice 是实现某 Service 的端点的子集。一个 Service 可以有 - **ports.port** (int32) - 端点的端口号。如果未指定，就不限制端口，且必须根据消费者的具体环境进行解释。 + port 表示端点的端口号。如果未指定，就不限制端口，且必须根据消费者的具体环境进行解释。 - **ports.protocol** (string) - 此端口的 IP 协议。必须为 UDP、TCP 或 SCTP。默认为 TCP。 + protocol 表示此端口的 IP 协议。必须为 UDP、TCP 或 SCTP。默认为 TCP。 - **ports.name** (string) - 此端口的名称。EndpointSlice 中所有端口的名称都不得重复。 + name 表示此端口的名称。EndpointSlice 中所有端口的名称都不得重复。 如果 EndpointSlice 是基于 Kubernetes Service 创建的， 那么此端口的名称和 Service.ports[].name 字段的值一致。默认为空字符串。 名称必须是空字符串，或者必须通过 DNS_LABEL 验证： @@ -286,12 +283,25 @@ EndpointSlice 是实现某 Service 的端点的子集。一个 Service 可以有 - **ports.appProtocol** (string) + The application protocol for this port. This is used as a hint for implementations to offer richer behavior for protocols that they understand. This field follows standard Kubernetes label syntax. Valid values are either: - 此端口的应用层协议。此字段遵循标准的 Kubernetes Label 句法。 - 不带前缀的名称是 IANA 标准服务的保留名称（参见 RFC-6335 和 https://www.iana.org/assignments/service-names）。 - 非标准协议应该使用带前缀的名称，例如 mycompany.com/my-custom-protocol。 + * Un-prefixed protocol names - reserved for IANA standard service names (as per RFC-6335 and https://www.iana.org/assignments/service-names). + + * Kubernetes-defined prefixed names: + * 'kubernetes.io/h2c' - HTTP/2 over cleartext as described in https://www.rfc-editor.org/rfc/rfc7540 + + * Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol. + --> + + 此端口的应用层协议。字段值被用作提示，允许协议实现为其所理解的协议提供更丰富的行为。 + 此字段遵循标准的 Kubernetes 标签句法。有效的取值是： + + * 不带前缀的协议名 - 是 IANA 标准服务的保留名称（参见 RFC-6335 和 https://www.iana.org/assignments/service-names）。 + + * Kubernetes 定义的前缀名称： + * 'kubernetes.io/h2c' - 使用明文的 HTTP/2 协议，详见 https://www.rfc-editor.org/rfc/rfc7540 + + * 其他协议应该使用带前缀的名称，例如 mycompany.com/my-custom-protocol。 ## EndpointSliceList {#EndpointSliceList} @@ -316,9 +326,9 @@ EndpointSliceList 是 EndpointSlice 的列表。 - **items** ([]}}">EndpointSlice), 必需 - EndpointSlice 列表 + items 是 EndpointSlice 列表 -- **timeoutSeconds** (*查询参数*)：integer +- **timeoutSeconds** (**查询参数**)：integer }}">timeoutSeconds @@ -552,6 +565,10 @@ GET /apis/discovery.k8s.io/v1/endpointslices }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + @@ -968,6 +985,10 @@ DELETE /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents +