From c4a046b9d643beb387a9ed447d3a16187edee900 Mon Sep 17 00:00:00 2001 From: Michael Date: Sat, 29 Apr 2023 10:57:35 +0800 Subject: [PATCH] [zh] sync network-policy-v1.md --- .../policy-resources/network-policy-v1.md | 174 ++++++++++-------- 1 file changed, 99 insertions(+), 75 deletions(-) diff --git a/content/zh-cn/docs/reference/kubernetes-api/policy-resources/network-policy-v1.md b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/network-policy-v1.md index 77c311f503..595af3826f 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/policy-resources/network-policy-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/network-policy-v1.md @@ -46,15 +46,15 @@ NetworkPolicy 描述针对一组 Pod 所允许的网络流量。 - **spec** (}}">NetworkPolicySpec) - spec 定义特定网络策略所需的所有信息. + spec 表示 NetworkPolicy 预期行为的规约。 - **status** (}}">NetworkPolicyStatus) - status 是 NetworkPolicy 的当前状态。更多信息: + status 表示 NetworkPolicy 的当前状态。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status ## NetworkPolicySpec {#NetworkPolicySpec} @@ -69,7 +69,7 @@ NetworkPolicySpec 定义特定 NetworkPolicy 所需的所有信息. - **podSelector** (}}">LabelSelector),必需 @@ -81,11 +81,11 @@ NetworkPolicySpec 定义特定 NetworkPolicy 所需的所有信息. - **policyTypes** ([]string) - NetworkPolicy 相关的规则类型列表。有效选项为 `[“Ingress”]`、`[“Egress”]` 或 `[“Ingress”, “Egress”]`。 + policyTypes 是 NetworkPolicy 相关的规则类型列表。有效选项为 `[“Ingress”]`、`[“Egress”]` 或 `[“Ingress”, “Egress”]`。 如果不指定此字段,则默认值取决是否存在 Ingress 或 Egress 规则;规则里包含 Egress 部分的策略将会影响出站流量, 并且所有策略(无论它们是否包含 Ingress 部分)都将会影响 入站流量。 如果要仅定义出站流量策略,则必须明确指定 `[ "Egress" ]`。 @@ -95,26 +95,26 @@ NetworkPolicySpec 定义特定 NetworkPolicy 所需的所有信息. - **ingress** ([]NetworkPolicyIngressRule) - 定义所选 Pod 的入站规则列表。在没有被任何 NetworkPolicy 选择到 Pod 的情况下(同时假定集群策略允许对应流量), + ingress 是应用到所选 Pod 的入站规则列表。在没有被任何 NetworkPolicy 选择到 Pod 的情况下(同时假定集群策略允许对应流量), 或者如果流量源是 Pod 的本地节点,或者流量与所有 NetworkPolicy 中的至少一个入站规则(Ingress) 匹配, 则进入 Pod 的流量是被允许的。如果此字段为空,则此 NetworkPolicy 不允许任何入站流量 (这种设置用来确保它所选择的 Pod 在默认情况下是被隔离的)。 **NetworkPolicyIngressRule 定义 NetworkPolicySpec 的 podSelector 所选 Pod 的入站规则的白名单列表, - 流量必须同时匹配 ports 和 from 。** + 流量必须同时匹配 ports 和 from。** - **ingress.from.ipBlock.cidr** (string),必需 - CIDR 是指定 IP 组块的字符串,例如 `"192.168.1.0/24"` 或 `"2001:db8::/64"`。 + cidr 是表示 IP 组块的字符串,例如 `"192.168.1.0/24"` 或 `"2001:db8::/64"`。 - **ingress.from.ipBlock.except** ([]string) @@ -171,14 +171,14 @@ NetworkPolicySpec 定义特定 NetworkPolicy 所需的所有信息. - **ingress.from.namespaceSelector** (}}">LabelSelector) - 此选择器使用集群范围标签来选择特定的 Namespace。此字段遵循标准标签选择算符语义; + namespaceSelector 使用集群范围标签来选择特定的 Namespace。此字段遵循标准标签选择算符语义; 如果此字段存在但为空值,则会选择所有名字空间。 如果 podSelector 也被定义了, 那么 NetworkPolicyPeer 将选择那些同时满足 namespaceSelector @@ -188,14 +188,14 @@ NetworkPolicySpec 定义特定 NetworkPolicy 所需的所有信息. - **ingress.from.podSelector** (}}">LabelSelector) - 这个标签选择算符负责选择 Pod。该字段遵循标准标签选择算符语义;如果字段存在但为空值,则选择所有 Pod。 + podSelector 是负责选择 Pod 的标签选择算符。该字段遵循标准标签选择算符语义;如果字段存在但为空值,则选择所有 Pod。 如果 namespaceSelector 也被定义,那么 NetworkPolicyPeer 将选择那些同时满足 namespaceSelector 定义的名字空间下和 podSelector 规则匹配的 Pod。 @@ -204,7 +204,7 @@ NetworkPolicySpec 定义特定 NetworkPolicy 所需的所有信息. - **ingress.ports.endPort** (int32) - 如果设置了此字段,则表明策略应该允许 port 与 endPort 之间(包含二者)的所有端口。 + endPort 表示如果设置了此字段,则策略应该允许 port 与 endPort 之间(包含二者)的所有端口。 如果未定义 port 或将 port 字段值为命名端口(字符串),则不可以使用 endPort。 endPort 必须等于或大于 port 值。 - **ingress.ports.protocol** (string) - 流量必须匹配的网络协议(TCP、UDP 或 SCTP)。如果未指定,此字段默认为 TCP。 + protocol 表示流量必须匹配的网络协议(TCP、UDP 或 SCTP)。如果未指定,此字段默认为 TCP。 - - **egress** ([]NetworkPolicyEgressRule) - egress 定义所选 Pod 的出站规则的列表。如果没有 NetworkPolicy 选中指定 Pod(并且其他集群策略也允许出口流量), + egress 是应用到所选 Pod 的出站规则的列表。如果没有 NetworkPolicy 选中指定 Pod(并且其他集群策略也允许出口流量), 或者在所有通过 podSelector 选中了某 Pod 的 NetworkPolicy 中,至少有一条出站规则与出站流量匹配, 则该 Pod 的出站流量是被允许的。 如果此字段为空,则此 NetworkPolicy 拒绝所有出站流量(这策略可以确保它所选中的 Pod 在默认情况下是被隔离的)。 egress 字段在 1.8 中为 Beta 级别。 - NetworkPolicyEgressRule 针对被 NetworkPolicySpec 的 podSelector 所选中 Pod,描述其被允许的出站流量。 - 流量必须同时匹配 ports 和 to 设置。此类型在 1.8 中为 Beta 级别。 + **NetworkPolicyEgressRule 针对被 NetworkPolicySpec 的 podSelector 所选中 Pod,描述其被允许的出站流量。 + 流量必须同时匹配 ports 和 to 设置。此类型在 1.8 中为 Beta 级别。** - **egress.to.ipBlock.cidr** (string),必需 - CIDR 是用来表达 IP 组块的字符串,例如 `"192.168.1.0/24"` 或 `"2001:db8::/64"`。 + cidr 是用来表达 IP 组块的字符串,例如 `"192.168.1.0/24"` 或 `"2001:db8::/64"`。 - **egress.to.ipBlock.except** ([]string) @@ -336,31 +335,31 @@ NetworkPolicySpec 定义特定 NetworkPolicy 所需的所有信息. - **egress.to.namespaceSelector** (}}">LabelSelector) - 此选择算符使用集群范围标签来选择特定的名字空间。该字段遵循标准标签选择算符语义; + namespaceSelector 使用集群范围标签来选择特定的名字空间。该字段遵循标准标签选择算符语义; 如果字段存在但为空值,那会选择所有名字空间。 - 如果 egress.to.podSelector 也被定义了, 那么 NetworkPolicyPeer 将选择那些同时满足 namespaceSelector + 如果 podSelector 也被定义了, 那么 NetworkPolicyPeer 将选择那些同时满足 namespaceSelector 指定的名字空间下和 podSelector 规则匹配的 Pod。 反之选择 namespaceSelector 指定的名字空间下所有的 Pod。 - **egress.to.podSelector** (}}">LabelSelector) - 这个标签选择器负责选择一组 Pod。该字段遵循标准标签选择算符语义; + podSelector 是负责选择一组 Pod 的标签选择算符。该字段遵循标准标签选择算符语义; 如果字段存在但为空值,则选择所有 Pod。 如果 egress.to.namespaceSelector 也被定义,则 NetworkPolicyPeer 将选择 namespaceSelector @@ -370,7 +369,7 @@ NetworkPolicySpec 定义特定 NetworkPolicy 所需的所有信息. - **egress.ports.port** (IntOrString) - 给定协议上的端口。字段值可以是 Pod 上的数字或命名端口。如果未提供此字段,则匹配所有端口名和端口号。 + port 表示符合给定协议的端口。字段值可以是 Pod 上的数字或命名端口。如果未提供此字段,则匹配所有端口名和端口号。 如果定义此字段,则仅允许针对给定的协议和端口的出站流量。 - IntOrString 是一种可以包含 int32 或字符串值的类型。在 JSON 或 YAML 编组和解组中使用时,它会生成或使用内部类型。 - 例如,这允许你拥有一个可以接受名称或数字的 JSON 字段。 + **IntOrString 是一种可以包含 int32 或字符串值的类型。在 JSON 或 YAML 编组和解组中使用时,它会生成或使用内部类型。 + 例如,这允许你拥有一个可以接受名称或数字的 JSON 字段。** + - **egress.ports.endPort** (int32) 如果设置了 endPort,则用来指定策略所允许的从 port 到 endPort 的端口范围(包含边界值)。 @@ -419,14 +419,13 @@ NetworkPolicySpec 定义特定 NetworkPolicy 所需的所有信息. - **egress.ports.protocol** (string) - 流量必须匹配的网络协议(TCP、UDP 或 SCTP)。如果未指定,此字段默认为 TCP。 + protocol 表示流量必须匹配的网络协议(TCP、UDP 或 SCTP)。如果未指定,此字段默认为 TCP。 ## NetworkPolicyStatus {#NetworkPolicyStatus} - NetworkPolicyStatus 描述有关此 NetworkPolicy 的当前状态。
@@ -438,7 +437,7 @@ NetworkPolicyStatus 描述有关此 NetworkPolicy 的当前状态。 *Map: unique values on key type will be kept during a merge* - Conditions holds an array of metav1.Condition that describe the state of the NetworkPolicy. Current service state + conditions holds an array of metav1.Condition that describe the state of the NetworkPolicy. Current service state *Condition contains details for one aspect of the current state of this API Resource.* @@ -549,13 +548,13 @@ NetworkPolicyList 是 NetworkPolicy 的集合。 - **metadata** (}}">ListMeta) - 标准的对象元数据。 - 更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata。 + 标准的对象元数据。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata。 - **items** ([]}}">NetworkPolicy),必需 @@ -767,6 +766,15 @@ GET /apis/networking.k8s.io/v1/namespaces/{namespace}/networkpolicies }}">resourceVersionMatch + +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents +