From fda7e0c9d1c4ef5c581904a94dffac3ebf0ba7f4 Mon Sep 17 00:00:00 2001 From: Qiming Teng Date: Sun, 12 Jun 2022 20:52:40 +0800 Subject: [PATCH] [zh] Resync concepts file (concepts-3) after lang name change --- .../services-networking/dual-stack.md | 221 +++++++++++------- 1 file changed, 136 insertions(+), 85 deletions(-) diff --git a/content/zh-cn/docs/concepts/services-networking/dual-stack.md b/content/zh-cn/docs/concepts/services-networking/dual-stack.md index 08383297d7..9476214ef3 100644 --- a/content/zh-cn/docs/concepts/services-networking/dual-stack.md +++ b/content/zh-cn/docs/concepts/services-networking/dual-stack.md @@ -9,18 +9,17 @@ weight: 70 --- @@ -29,14 +28,16 @@ weight: 70 {{< feature-state for_k8s_version="v1.23" state="stable" >}} IPv4/IPv6 双协议栈网络能够将 IPv4 和 IPv6 地址分配给 {{< glossary_tooltip text="Pod" term_id="pod" >}} 和 {{< glossary_tooltip text="Service" term_id="service" >}}。 从 1.21 版本开始,Kubernetes 集群默认启用 IPv4/IPv6 双协议栈网络, 以支持同时分配 IPv4 和 IPv6 地址。 @@ -54,9 +55,9 @@ IPv4/IPv6 dual-stack on your Kubernetes cluster provides the following features: Kubernetes 集群的 IPv4/IPv6 双协议栈可提供下面的功能: * 双协议栈 pod 网络 (每个 pod 分配一个 IPv4 和 IPv6 地址) * IPv4 和 IPv6 启用的服务 @@ -73,18 +74,20 @@ The following prerequisites are needed in order to utilize IPv4/IPv6 dual-stack 为了使用 IPv4/IPv6 双栈的 Kubernetes 集群,需要满足以下先决条件: * Kubernetes 1.20 版本或更高版本,有关更早 Kubernetes 版本的使用双栈服务的信息, 请参考对应版本的 Kubernetes 文档。 * 提供商支持双协议栈网络(云提供商或其他提供商必须能够为 Kubernetes 节点提供可路由的 IPv4/IPv6 网络接口) -* 支持双协议栈的[网络插件](/zh/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/) +* 支持双协议栈的[网络插件](/zh-cn/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/) 如果配置 IPv4/IPv6 双栈,请分配双栈集群网络: * kube-apiserver: * `--service-cluster-ip-range=,` * kube-controller-manager: * `--cluster-cidr=,` * `--service-cluster-ip-range=,` - * `--node-cidr-mask-size-ipv4|--node-cidr-mask-size-ipv6` 对于 IPv4 默认为 /24,对于 IPv6 默认为 /64 + * `--node-cidr-mask-size-ipv4|--node-cidr-mask-size-ipv6` 对于 IPv4 默认为 /24, + 对于 IPv6 默认为 /64 * kube-proxy: * `--cluster-cidr=,` * kubelet: @@ -131,7 +134,8 @@ To configure IPv4/IPv6 dual-stack, set dual-stack cluster network assignments: IPv4 CIDR 的一个例子:`10.244.0.0/16`(尽管你会提供你自己的地址范围)。 @@ -142,31 +146,35 @@ IPv6 CIDR 的一个例子:`fdXY:IJKL:MNOP:15::/64` -## 服务 +## 服务 {#services} 你可以使用 IPv4 或 IPv6 地址来创建 {{< glossary_tooltip text="Service" term_id="service" >}}。 + 服务的地址族默认为第一个服务集群 IP 范围的地址族(通过 kube-apiserver 的 `--service-cluster-ip-range` 参数配置)。 + 当你定义服务时,可以选择将其配置为双栈。若要指定所需的行为,你可以设置 `.spec.ipFamilyPolicy` 字段为以下值之一: - * `SingleStack`:单栈服务。控制面使用第一个配置的服务集群 IP 范围为服务分配集群 IP。 * `PreferDualStack`: * 为服务分配 IPv4 和 IPv6 集群 IP 地址。 @@ -175,14 +183,18 @@ set the `.spec.ipFamilyPolicy` field to one of the following values: 列表中选择 `.spec.ClusterIP` 如果你想要定义哪个 IP 族用于单栈或定义双栈 IP 族的顺序,可以通过设置 服务上的可选字段 `.spec.ipFamilies` 来选择地址族。 {{< note >}} `.spec.ipFamilies` 字段是不可变的,因为系统无法为已经存在的服务重新分配 `.spec.ClusterIP`。如果你想改变 `.spec.ipFamilies`,则需要删除并重新创建服务。 @@ -214,34 +226,46 @@ The first family you list is used for the legacy `.spec.ClusterIP` field. These examples demonstrate the behavior of various dual-stack Service configuration scenarios. --> -### 双栈服务配置场景 +### 双栈服务配置场景 {#dual-stack-service-configuration-scenarios} 以下示例演示多种双栈服务配置场景下的行为。 -#### 新服务的双栈选项 +#### 新服务的双栈选项 {#dual-stack-options-on-new-services} 1. 此服务规约中没有显式设定 `.spec.ipFamilyPolicy`。当你创建此服务时,Kubernetes 从所配置的第一个 `service-cluster-ip-range` 种为服务分配一个集群IP,并设置 `.spec.ipFamilyPolicy` 为 `SingleStack`。 - ([无选择算符的服务](/zh/docs/concepts/services-networking/service/#services-without-selectors) - 和[无头服务](/zh/docs/concepts/services-networking/service/#headless-services)的行为方式 + ([无选择算符的服务](/zh-cn/docs/concepts/services-networking/service/#services-without-selectors) + 和[无头服务](/zh-cn/docs/concepts/services-networking/service/#headless-services)的行为方式 与此相同。) {{< codenew file="service/networking/dual-stack-default-svc.yaml" >}} 2. 此服务规约显式地将 `.spec.ipFamilyPolicy` 设置为 `PreferDualStack`。 当你在双栈集群上创建此服务时,Kubernetes 会为该服务分配 IPv4 和 IPv6 地址。 @@ -259,7 +283,10 @@ These examples demonstrate the behavior of various dual-stack Service configurat {{< codenew file="service/networking/dual-stack-preferred-svc.yaml" >}} 3. 下面的服务规约显式地在 `.spec.ipFamilies` 中指定 `IPv6` 和 `IPv4`,并 将 `.spec.ipFamilyPolicy` 设定为 `PreferDualStack`。 @@ -272,16 +299,21 @@ These examples demonstrate the behavior of various dual-stack Service configurat -#### 现有服务的双栈默认值 +#### 现有服务的双栈默认值 {#dual-stack-defaults-on-existing-services} 下面示例演示了在服务已经存在的集群上新启用双栈时的默认行为。 (将现有集群升级到 1.21 或者更高版本会启用双协议栈支持。) 1. 在集群上启用双栈时,控制面会将现有服务(无论是 `IPv4` 还是 `IPv6`)配置 `.spec.ipFamilyPolicy` 为 `SingleStack` 并设置 `.spec.ipFamilies` @@ -324,10 +356,15 @@ These examples demonstrate the default behavior when dual-stack is newly enabled ``` 2. 在集群上启用双栈时,带有选择算符的现有 - [无头服务](/zh/docs/concepts/services-networking/service/#headless-services) + [无头服务](/zh-cn/docs/concepts/services-networking/service/#headless-services) 由控制面设置 `.spec.ipFamilyPolicy` 为 `SingleStack` 并设置 `.spec.ipFamilies` 为第一个服务集群 IP 范围的地址族(通过配置 kube-apiserver 的 `--service-cluster-ip-range` 参数),即使 `.spec.ClusterIP` 的设置值为 `None` 也如此。 @@ -368,7 +405,7 @@ These examples demonstrate the default behavior when dual-stack is newly enabled -#### 在单栈和双栈之间切换服务 +#### 在单栈和双栈之间切换服务 {#switching-services-between-single-stack-and-dual-stack} 1. 要将服务从单栈更改为双栈,根据需要将 `.spec.ipFamilyPolicy` 从 `SingleStack` 改为 `PreferDualStack` 或 `RequireDualStack`。 - 当你将此服务从单栈更改为双栈时,Kubernetes 将分配缺失的地址族,以便现在 - 该服务具有 IPv4 和 IPv6 地址。 + 当你将此服务从单栈更改为双栈时,Kubernetes 将分配缺失的地址族, + 以便现在该服务具有 IPv4 和 IPv6 地址。 编辑服务规约将 `.spec.ipFamilyPolicy` 从 `SingleStack` 改为 `PreferDualStack`。 - 2. 要将服务从双栈更改为单栈,请将 `.spec.ipFamilyPolicy` 从 `PreferDualStack` 或 `RequireDualStack` 改为 `SingleStack`。 当你将此服务从双栈更改为单栈时,Kubernetes 只保留 `.spec.ClusterIPs` @@ -419,24 +462,27 @@ Services can be changed from single-stack to dual-stack and from dual-stack to s -### 无选择算符的无头服务 +### 无选择算符的无头服务 {#headless-services-without-selector} -对于[不带选择算符的无头服务](/zh/docs/concepts/services-networking/service/#without-selectors), +对于[不带选择算符的无头服务](/zh-cn/docs/concepts/services-networking/service/#without-selectors), 若没有显式设置 `.spec.ipFamilyPolicy`,则 `.spec.ipFamilyPolicy` 字段默认设置为 `RequireDualStack`。 -### LoadBalancer 类型服务 +### LoadBalancer 类型服务 {#service-type-loadbalancer} 要为你的服务提供双栈负载均衡器: @@ -445,7 +491,8 @@ To provision a dual-stack load balancer for your Service: {{< note >}} 为了使用双栈的负载均衡器类型服务,你的云驱动必须支持 IPv4 和 IPv6 的负载均衡器。 {{< /note >}} @@ -453,10 +500,14 @@ To use a dual-stack `LoadBalancer` type Service, your cloud provider must suppor -## 出站流量 +## 出站流量 {#egress-traffic} 如果你要启用出站流量,以便使用非公开路由 IPv6 地址的 Pod 到达集群外地址 (例如公网),则需要通过透明代理或 IP 伪装等机制使 Pod 使用公共路由的 @@ -479,15 +530,8 @@ dual-stack IPv4/IPv6 networking for pods and nodes with single-family services is supported. You can use IPv4/IPv6 dual-stack networking with `l2bridge` networks. - -{{< note >}} -Overlay (VXLAN) networks on Windows **do not** support dual-stack networking. -{{< /note >}} - -You can read more about the different network modes for Windows within the -[Networking on Windows](/docs/concepts/services-networking/windows-networking#network-modes) topic. --> -## Windows 支持 +## Windows 支持 {#windows-support} Windows 上的 Kubernetes 不支持单栈“仅 IPv6” 网络。 然而, 对于 Pod 和节点而言,仅支持单栈形式服务的双栈 IPv4/IPv6 网络是被支持的。 @@ -495,11 +539,18 @@ Windows 上的 Kubernetes 不支持单栈“仅 IPv6” 网络。 然而, 你可以使用 `l2bridge` 网络来实现 IPv4/IPv6 双栈联网。 {{< note >}} + Windows 上的 Overlay (VXLAN) 网络**不**支持双栈网络。 {{< /note >}} + 关于 Windows 的不同网络模式,你可以进一步阅读 -[Windows 上的网络](/zh/docs/concepts/services-networking/windows-networking#network-modes)。 +[Windows 上的网络](/zh-cn/docs/concepts/services-networking/windows-networking#network-modes)。 ## {{% heading "whatsnext" %}} @@ -507,5 +558,5 @@ Windows 上的 Overlay (VXLAN) 网络**不**支持双栈网络。 * [Validate IPv4/IPv6 dual-stack](/docs/tasks/network/validate-dual-stack) networking * [Enable dual-stack networking using kubeadm](/docs/setup/production-environment/tools/kubeadm/dual-stack-support/) --> -* [验证 IPv4/IPv6 双协议栈](/zh/docs/tasks/network/validate-dual-stack)网络 -* [使用 kubeadm 启用双协议栈网络](/zh/docs/setup/production-environment/tools/kubeadm/dual-stack-support/) +* [验证 IPv4/IPv6 双协议栈](/zh-cn/docs/tasks/network/validate-dual-stack)网络 +* [使用 kubeadm 启用双协议栈网络](/zh-cn/docs/setup/production-environment/tools/kubeadm/dual-stack-support/)