Skip to content

Commit 2b5693b

Browse files
committed
[zh-cn] sync endpoints-v1.md and ingress-class-v1.md
Signed-off-by: xin.li <xin.li@daocloud.io>
1 parent 176eb18 commit 2b5693b

File tree

2 files changed

+84
-23
lines changed

2 files changed

+84
-23
lines changed

content/zh-cn/docs/reference/kubernetes-api/service-resources/endpoints-v1.md

Lines changed: 56 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -109,14 +109,14 @@ Endpoints 是实现实际服务的端点的集合。举例:
109109
<!--
110110
- **subsets.addresses.ip** (string), required
111111
112-
The IP of this endpoint. May not be loopback (127.0.0.0/8), link-local (169.254.0.0/16), or link-local multicast ((224.0.0.0/24). IPv6 is also accepted but not fully supported on all platforms. Also, certain kubernetes components, like kube-proxy, are not IPv6 ready.
112+
The IP of this endpoint. May not be loopback (127.0.0.0/8 or ::1), link-local (169.254.0.0/16 or fe80::/10), or link-local multicast ((224.0.0.0/24).
113113
-->
114114

115115
- **subsets.addresses.ip** (string), 必需
116116

117-
端点的 IP。不可以是本地回路(127.0.0.0/8)、链路本地(169.254.0.0/16)或链路本地多播(224.0.0.0/24)地址。
118-
IPv6 也被接受,但并非在所有平台上都完全支持。
119-
此外,诸如 kube-proxy 等某些 Kubernetes 组件还没有准备好支持 IPv6
117+
端点的 IP。不可以是本地回路(127.0.0.0/8 或 ::1)、
118+
链路本地(169.254.0.0/16 或 fe80::/10)或链路本地多播(224.0.0.0/24
119+
或 ff02::/16))地址
120120

121121
- **subsets.addresses.hostname** (string)
122122

@@ -158,14 +158,14 @@ Endpoints 是实现实际服务的端点的集合。举例:
158158
<!--
159159
- **subsets.notReadyAddresses.ip** (string), required
160160
161-
The IP of this endpoint. May not be loopback (127.0.0.0/8), link-local (169.254.0.0/16), or link-local multicast ((224.0.0.0/24). IPv6 is also accepted but not fully supported on all platforms. Also, certain kubernetes components, like kube-proxy, are not IPv6 ready.
161+
The IP of this endpoint. May not be loopback (127.0.0.0/8 or ::1), link-local (169.254.0.0/16 or fe80::/10), or link-local multicast (224.0.0.0/24 or ff02::/16).
162162
-->
163163

164164
- **subsets.notReadyAddresses.ip** (string), 必需
165165

166-
端点的 IP。不可以是本地环路(127.0.0.0/8)、链路本地(169.254.0.0/16)或链路本地多播(224.0.0.0/24)地址。
167-
IPv6 也被接受,但并非在所有平台上都完全支持。
168-
此外,诸如 kube-proxy 等某些 Kubernetes 组件还没有准备好支持 IPv6
166+
端点的 IP。不可以是本地环路(127.0.0.0/8 或 ::1)、
167+
链路本地(169.254.0.0/16 或 fe80::/10)或链路本地多播(224.0.0.0/24
168+
或 ff02::/16)地址
169169

170170
- **subsets.notReadyAddresses.hostname** (string)
171171

@@ -237,12 +237,27 @@ Endpoints 是实现实际服务的端点的集合。举例:
237237
- **subsets.ports.appProtocol** (string)
238238

239239
<!--
240-
The application protocol for this port. This field follows standard Kubernetes label syntax. Un-prefixed names are reserved for IANA standard service names (as per RFC-6335 and http://www.iana.org/assignments/service-names). Non-standard protocols should use prefixed names such as mycompany.com/my-custom-protocol.
240+
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:
241241
-->
242242

243-
端口的应用程序协议。此字段遵循标准的 Kubernetes 标签语法。
244-
未加前缀的名称保留给 IANA 标准服务名称(遵循 RFC-6335 和 http://www.iana.org/assignments/service-names)。
245-
非标准协议应使用带前缀名称,如 `mycompany.com/my-custom-protocol`
243+
端口的应用程序协议。这被用作实现的提示,为他们理解的协议提供更丰富的行为。
244+
此字段遵循标准的 Kubernetes 标签语法。有效值为:
245+
246+
<!--
247+
* Un-prefixed protocol names - reserved for IANA standard service names (as per RFC-6335 and http://www.iana.org/assignments/service-names).
248+
249+
* Kubernetes-defined prefixed names:
250+
* 'kubernetes.io/h2c' - HTTP/2 over cleartext as described in http://www.rfc-editor.org/rfc/rfc7540
251+
252+
* Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol.
253+
-->
254+
255+
* 未加前缀的名称保留给 IANA 标准服务名称(遵循 RFC-6335 和 http://www.iana.org/assignments/service-names)。
256+
257+
* Kubernetes 定义的前缀名称
258+
* 'kubernetes.io/h2c' - HTTP/2 明文,如 http://www.rfc-editor.org/rfc/rfc7540 中所述
259+
260+
* 其他协议应使用实现定义的前缀名称,如 mycompany.com/my-custom-protocol。
246261

247262
## EndpointsList {#EndpointsList}
248263

@@ -409,6 +424,15 @@ GET /api/v1/namespaces/{namespace}/endpoints
409424

410425
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
411426

427+
<!--
428+
- **sendInitialEvents** (*in query*): boolean
429+
430+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
431+
-->
432+
- **sendInitialEvents** (**查询参数**): boolean
433+
434+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
435+
412436
<!--
413437
- **timeoutSeconds** (*in query*): integer
414438
-->
@@ -521,6 +545,15 @@ GET /api/v1/endpoints
521545

522546
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
523547

548+
<!--
549+
- **sendInitialEvents** (*in query*): boolean
550+
551+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
552+
-->
553+
- **sendInitialEvents** (**查询参数**): boolean
554+
555+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
556+
524557
<!--
525558
- **timeoutSeconds** (*in query*): integer
526559
@@ -571,7 +604,7 @@ POST /api/v1/namespaces/{namespace}/endpoints
571604
572605
- **body**: <a href="{{< ref "../service-resources/endpoints-v1#Endpoints" >}}">Endpoints</a>, required
573606
-->
574-
- **namespace** (**路径参数**):string,必需
607+
- **namespace** (**路径参数**):string,必需
575608

576609
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
577610

@@ -734,7 +767,7 @@ PATCH /api/v1/namespaces/{namespace}/endpoints/{name}
734767
-->
735768
- **name** (**路径参数**):string,必需
736769

737-
Endpoints名称
770+
Endpoints 名称
738771

739772
<!--
740773
- **namespace** (*in path*): string, required
@@ -1007,6 +1040,15 @@ DELETE /api/v1/namespaces/{namespace}/endpoints
10071040

10081041
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
10091042

1043+
<!--
1044+
- **sendInitialEvents** (*in query*): boolean
1045+
1046+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
1047+
-->
1048+
- **sendInitialEvents** (**查询参数**): boolean
1049+
1050+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
1051+
10101052
<!--
10111053
- **timeoutSeconds** (*in query*): integer
10121054

content/zh-cn/docs/reference/kubernetes-api/service-resources/ingress-class-v1.md

Lines changed: 28 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -72,8 +72,9 @@ IngressClassSpec 提供有关 Ingress 类的信息。
7272
- **controller** (string)
7373

7474
<!--
75-
Controller refers to the name of the controller that should handle this class. This allows for different "flavors" that are controlled by the same controller. For example, you may have different Parameters for the same implementing controller. This should be specified as a domain-prefixed path no more than 250 characters in length, e.g. "acme.io/ingress-controller". This field is immutable.
75+
controller refers to the name of the controller that should handle this class. This allows for different "flavors" that are controlled by the same controller. For example, you may have different Parameters for the same implementing controller. This should be specified as a domain-prefixed path no more than 250 characters in length, e.g. "acme.io/ingress-controller". This field is immutable.
7676
-->
77+
7778
controller 是指应该处理此类的控制器名称。
7879
这允许由同一控制器控制不同“口味”。例如,对于同一个实现的控制器你可能有不同的参数。
7980
此字段应该指定为长度不超过 250 个字符的域前缀路径,例如 “acme.io/ingress-controller”。
@@ -82,8 +83,9 @@ IngressClassSpec 提供有关 Ingress 类的信息。
8283
- **parameters** (IngressClassParametersReference)
8384

8485
<!--
85-
Parameters is a link to a custom resource containing additional configuration for the controller. This is optional if the controller does not require extra parameters.
86+
parameters is a link to a custom resource containing additional configuration for the controller. This is optional if the controller does not require extra parameters.
8687
-->
88+
8789
parameters 是指向控制器中包含额外配置的自定义资源的链接。
8890
如果控制器不需要额外的属性,这是可选的。
8991

@@ -96,7 +98,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
9698
<!--
9799
- **parameters.kind** (string), required
98100
99-
Kind is the type of resource being referenced.
101+
kind is the type of resource being referenced.
100102
-->
101103

102104
- **parameters.kind** (string),必需
@@ -106,7 +108,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
106108
<!--
107109
- **parameters.name** (string), required
108110
109-
Name is the name of resource being referenced.
111+
name is the name of resource being referenced.
110112
-->
111113

112114
- **parameters.name** (string),必需
@@ -115,7 +117,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
115117

116118
- **parameters.apiGroup** (string)
117119
<!--
118-
APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
120+
apiGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
119121
-->
120122

121123
apiGroup 是被引用资源的组。
@@ -124,7 +126,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
124126

125127
- **parameters.namespace** (string)
126128
<!--
127-
Namespace is the namespace of the resource being referenced. This field is required when scope is set to "Namespace" and must be unset when scope is set to "Cluster".
129+
namespace is the namespace of the resource being referenced. This field is required when scope is set to "Namespace" and must be unset when scope is set to "Cluster".
128130
-->
129131

130132
namespace 是被引用资源的命名空间。
@@ -133,7 +135,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
133135

134136
- **parameters.scope** (string)
135137
<!--
136-
Scope represents if this refers to a cluster or namespace scoped resource. This may be set to "Cluster" (default) or "Namespace".
138+
scope represents if this refers to a cluster or namespace scoped resource. This may be set to "Cluster" (default) or "Namespace".
137139
-->
138140

139141
scope 表示是否引用集群或者命名空间范围的资源。
@@ -162,7 +164,7 @@ IngressClassList 是 IngressClasses 的集合。
162164
<!--
163165
- **items** ([]<a href="{{< ref "../service-resources/ingress-class-v1#IngressClass" >}}">IngressClass</a>), required
164166
165-
Items is the list of IngressClasses.
167+
items is the list of IngressClasses.
166168
-->
167169
- **items** ([]<a href="{{< ref "../service-resources/ingress-class-v1#IngressClass" >}}">IngressClass</a>),必需
168170

@@ -287,6 +289,15 @@ GET /apis/networking.k8s.io/v1/ingressclasses
287289

288290
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
289291

292+
<!--
293+
- **sendInitialEvents** (*in query*): boolean
294+
295+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
296+
-->
297+
- **sendInitialEvents** (**查询参数**): boolean
298+
299+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
300+
290301
<!--
291302
- **timeoutSeconds** (*in query*): integer
292303
-->
@@ -669,6 +680,15 @@ DELETE /apis/networking.k8s.io/v1/ingressclasses
669680

670681
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
671682

683+
<!--
684+
- **sendInitialEvents** (*in query*): boolean
685+
686+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
687+
-->
688+
- **sendInitialEvents** (**查询参数**): boolean
689+
690+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
691+
672692
<!--
673693
- **timeoutSeconds** (*in query*): integer
674694
-->
@@ -684,4 +704,3 @@ DELETE /apis/networking.k8s.io/v1/ingressclasses
684704
200 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status</a>): OK
685705

686706
401: Unauthorized
687-

0 commit comments

Comments
 (0)