[zh-cn] sync endpoints-v1.md and ingress-class-v1.md
Signed-off-by: xin.li <xin.li@daocloud.io>pull/41122/head
xin.li
parent
176eb1816a
commit
2b5693b841
|
|
@ -109,14 +109,14 @@ Endpoints 是实现实际服务的端点的集合。举例:
|
|||
<!--
|
||||
- **subsets.addresses.ip** (string), required
|
||||
|
||||
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.
|
||||
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).
|
||||
-->
|
||||
|
||||
- **subsets.addresses.ip** (string), 必需
|
||||
|
||||
端点的 IP。不可以是本地回路（127.0.0.0/8）、链路本地（169.254.0.0/16）或链路本地多播（224.0.0.0/24）地址。
|
||||
IPv6 也被接受，但并非在所有平台上都完全支持。
|
||||
此外，诸如 kube-proxy 等某些 Kubernetes 组件还没有准备好支持 IPv6。
|
||||
端点的 IP。不可以是本地回路（127.0.0.0/8 或 ::1）、
|
||||
链路本地（169.254.0.0/16 或 fe80::/10）或链路本地多播（224.0.0.0/24
|
||||
或 ff02::/16)）地址。
|
||||
|
||||
- **subsets.addresses.hostname** (string)
|
||||
|
||||
|
|
@ -158,14 +158,14 @@ Endpoints 是实现实际服务的端点的集合。举例:
|
|||
<!--
|
||||
- **subsets.notReadyAddresses.ip** (string), required
|
||||
|
||||
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.
|
||||
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).
|
||||
-->
|
||||
|
||||
- **subsets.notReadyAddresses.ip** (string), 必需
|
||||
|
||||
端点的 IP。不可以是本地环路（127.0.0.0/8）、链路本地（169.254.0.0/16）或链路本地多播（224.0.0.0/24）地址。
|
||||
IPv6 也被接受，但并非在所有平台上都完全支持。
|
||||
此外，诸如 kube-proxy 等某些 Kubernetes 组件还没有准备好支持 IPv6。
|
||||
端点的 IP。不可以是本地环路（127.0.0.0/8 或 ::1）、
|
||||
链路本地（169.254.0.0/16 或 fe80::/10）或链路本地多播（224.0.0.0/24
|
||||
或 ff02::/16）地址。
|
||||
|
||||
- **subsets.notReadyAddresses.hostname** (string)
|
||||
|
||||
|
|
@ -237,12 +237,27 @@ Endpoints 是实现实际服务的端点的集合。举例:
|
|||
- **subsets.ports.appProtocol** (string)
|
||||
|
||||
<!--
|
||||
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 https://www.iana.org/assignments/service-names). Non-standard protocols should use prefixed names such as mycompany.com/my-custom-protocol.
|
||||
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 标签语法。
|
||||
未加前缀的名称保留给 IANA 标准服务名称（遵循 RFC-6335 和 https://www.iana.org/assignments/service-names)。
|
||||
非标准协议应使用带前缀名称，如 `mycompany.com/my-custom-protocol`。
|
||||
端口的应用程序协议。这被用作实现的提示，为他们理解的协议提供更丰富的行为。
|
||||
此字段遵循标准的 Kubernetes 标签语法。有效值为：
|
||||
|
||||
<!--
|
||||
* 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.
|
||||
-->
|
||||
|
||||
* 未加前缀的名称保留给 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。
|
||||
|
||||
## EndpointsList {#EndpointsList}
|
||||
|
||||
|
|
@ -409,6 +424,15 @@ GET /api/v1/namespaces/{namespace}/endpoints
|
|||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
|
||||
|
||||
<!--
|
||||
- **sendInitialEvents** (*in query*): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
-->
|
||||
- **sendInitialEvents** (**查询参数**): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
|
||||
<!--
|
||||
- **timeoutSeconds** (*in query*): integer
|
||||
-->
|
||||
|
|
@ -521,6 +545,15 @@ GET /api/v1/endpoints
|
|||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
|
||||
|
||||
<!--
|
||||
- **sendInitialEvents** (*in query*): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
-->
|
||||
- **sendInitialEvents** (**查询参数**): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
|
||||
<!--
|
||||
- **timeoutSeconds** (*in query*): integer
|
||||
|
||||
|
|
@ -571,7 +604,7 @@ POST /api/v1/namespaces/{namespace}/endpoints
|
|||
|
||||
- **body**: <a href="{{< ref "../service-resources/endpoints-v1#Endpoints" >}}">Endpoints</a>, required
|
||||
-->
|
||||
- **namespace** (**路径参数**)：string，必需
|
||||
- **namespace** (**路径参数**)：string，必需
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
|
||||
|
||||
|
|
@ -734,7 +767,7 @@ PATCH /api/v1/namespaces/{namespace}/endpoints/{name}
|
|||
-->
|
||||
- **name** (**路径参数**)：string，必需
|
||||
|
||||
Endpoints名称
|
||||
Endpoints 名称
|
||||
|
||||
<!--
|
||||
- **namespace** (*in path*): string, required
|
||||
|
|
@ -1007,6 +1040,15 @@ DELETE /api/v1/namespaces/{namespace}/endpoints
|
|||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
|
||||
|
||||
<!--
|
||||
- **sendInitialEvents** (*in query*): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
-->
|
||||
- **sendInitialEvents** (**查询参数**): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
|
||||
<!--
|
||||
- **timeoutSeconds** (*in query*): integer
|
||||
|
||||
|
|
|
|||
|
|
@ -72,8 +72,9 @@ IngressClassSpec 提供有关 Ingress 类的信息。
|
|||
- **controller** (string)
|
||||
|
||||
<!--
|
||||
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.
|
||||
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.
|
||||
-->
|
||||
|
||||
controller 是指应该处理此类的控制器名称。
|
||||
这允许由同一控制器控制不同“口味”。例如，对于同一个实现的控制器你可能有不同的参数。
|
||||
此字段应该指定为长度不超过 250 个字符的域前缀路径，例如 “acme.io/ingress-controller”。
|
||||
|
|
@ -82,8 +83,9 @@ IngressClassSpec 提供有关 Ingress 类的信息。
|
|||
- **parameters** (IngressClassParametersReference)
|
||||
|
||||
<!--
|
||||
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.
|
||||
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.
|
||||
-->
|
||||
|
||||
parameters 是指向控制器中包含额外配置的自定义资源的链接。
|
||||
如果控制器不需要额外的属性，这是可选的。
|
||||
|
||||
|
|
@ -96,7 +98,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
|
|||
<!--
|
||||
- **parameters.kind** (string), required
|
||||
|
||||
Kind is the type of resource being referenced.
|
||||
kind is the type of resource being referenced.
|
||||
-->
|
||||
|
||||
- **parameters.kind** (string)，必需
|
||||
|
|
@ -106,7 +108,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
|
|||
<!--
|
||||
- **parameters.name** (string), required
|
||||
|
||||
Name is the name of resource being referenced.
|
||||
name is the name of resource being referenced.
|
||||
-->
|
||||
|
||||
- **parameters.name** (string)，必需
|
||||
|
|
@ -115,7 +117,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
|
|||
|
||||
- **parameters.apiGroup** (string)
|
||||
<!--
|
||||
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.
|
||||
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.
|
||||
-->
|
||||
|
||||
apiGroup 是被引用资源的组。
|
||||
|
|
@ -124,7 +126,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
|
|||
|
||||
- **parameters.namespace** (string)
|
||||
<!--
|
||||
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".
|
||||
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".
|
||||
-->
|
||||
|
||||
namespace 是被引用资源的命名空间。
|
||||
|
|
@ -133,7 +135,7 @@ IngressClassSpec 提供有关 Ingress 类的信息。
|
|||
|
||||
- **parameters.scope** (string)
|
||||
<!--
|
||||
Scope represents if this refers to a cluster or namespace scoped resource. This may be set to "Cluster" (default) or "Namespace".
|
||||
scope represents if this refers to a cluster or namespace scoped resource. This may be set to "Cluster" (default) or "Namespace".
|
||||
-->
|
||||
|
||||
scope 表示是否引用集群或者命名空间范围的资源。
|
||||
|
|
@ -162,7 +164,7 @@ IngressClassList 是 IngressClasses 的集合。
|
|||
<!--
|
||||
- **items** ([]<a href="{{< ref "../service-resources/ingress-class-v1#IngressClass" >}}">IngressClass</a>), required
|
||||
|
||||
Items is the list of IngressClasses.
|
||||
items is the list of IngressClasses.
|
||||
-->
|
||||
- **items** ([]<a href="{{< ref "../service-resources/ingress-class-v1#IngressClass" >}}">IngressClass</a>)，必需
|
||||
|
||||
|
|
@ -287,6 +289,15 @@ GET /apis/networking.k8s.io/v1/ingressclasses
|
|||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
|
||||
|
||||
<!--
|
||||
- **sendInitialEvents** (*in query*): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
-->
|
||||
- **sendInitialEvents** (**查询参数**): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
|
||||
<!--
|
||||
- **timeoutSeconds** (*in query*): integer
|
||||
-->
|
||||
|
|
@ -669,6 +680,15 @@ DELETE /apis/networking.k8s.io/v1/ingressclasses
|
|||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
|
||||
|
||||
<!--
|
||||
- **sendInitialEvents** (*in query*): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
-->
|
||||
- **sendInitialEvents** (**查询参数**): boolean
|
||||
|
||||
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
|
||||
|
||||
<!--
|
||||
- **timeoutSeconds** (*in query*): integer
|
||||
-->
|
||||
|
|
@ -684,4 +704,3 @@ DELETE /apis/networking.k8s.io/v1/ingressclasses
|
|||
200 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status</a>): OK
|
||||
|
||||
401: Unauthorized
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue