[zh] Fix links in setup section

2020-09-07 13:35:20 +08:00
parent 9dac2841ff
commit 3fda142df9
7 changed files with 175 additions and 119 deletions
@@ -761,7 +761,7 @@ first [drain the node](/docs/reference/generated/kubectl/kubectl-commands#drain)
 and make sure that the node is empty, then deconfigure the node.
 -->
 但是，如果要更干净地取消配置群集，
-则应首先[清空节点](/zh/docs/reference/generated/kubectl/kubectl-commands#drain)并确保该节点为空，
+则应首先[清空节点](/docs/reference/generated/kubectl/kubectl-commands#drain)并确保该节点为空，
 然后取消配置该节点。


@@ -146,6 +146,6 @@ A minimum of three hosts for control plane nodes and three hosts for etcd nodes
 <!--
 - [Set up a highly available cluster with kubeadm](/docs/setup/production-environment/tools/kubeadm/high-availability/)
 -->
- -  [使用 kubeadm 设置高可用集群](/docs/setup/production-environment/tools/kubeadm/high-availability/)
+ -  [使用 kubeadm 设置高可用集群](/zh/docs/setup/production-environment/tools/kubeadm/high-availability/)


@@ -42,12 +42,12 @@ in the kubeadm [issue tracker](https://github.com/kubernetes/kubeadm/issues/new)

 See also [The upgrade documentation](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-15).
 -->
-在下一步之前，您应该仔细考虑哪种方法更好的满足您的应用程序和环境的需求。 [这是对比文档](/docs/setup/production-environment/tools/kubeadm/ha-topology/) 讲述了每种方法的优缺点。
+在下一步之前，您应该仔细考虑哪种方法更好的满足您的应用程序和环境的需求。 
+[这是对比文档](/zh/docs/setup/production-environment/tools/kubeadm/ha-topology/) 讲述了每种方法的优缺点。

 如果您在安装 HA 集群时遇到问题，请在 kubeadm [问题跟踪](https://github.com/kubernetes/kubeadm/issues/new)里向我们提供反馈。

-您也可以阅读 [升级文件](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-15)。
-
+您也可以阅读 [升级文件](/zh/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade/)
 <!--
 This page does not address running your cluster on a cloud provider. In a cloud
 environment, neither approach documented here works with Service objects of type
@@ -133,7 +133,6 @@ option. Your cluster requirements may need a different configuration.
    - Read the [Options for Software Load Balancing](https://github.com/kubernetes/kubeadm/blob/master/docs/ha-considerations.md#options-for-software-load-balancing)
      guide for more details.
 -->
-
 1.  创建一个名为 kube-apiserver 的负载均衡器解析 DNS。

    - 在云环境中，应该将控制平面节点放置在 TCP 后面转发负载平衡。 该负载均衡器将流量分配给目标列表中所有运行状况良好的控制平面节点。健康检查 apiserver 是在 kube-apiserver 监听端口(默认值 `:6443`)上的一个 TCP 检查。
@@ -161,17 +160,16 @@ option. Your cluster requirements may need a different configuration.

 1.  Add the remaining control plane nodes to the load balancer target group.
 -->
+2.  添加第一个控制平面节点到负载均衡器并测试连接：

-1.  添加第一个控制平面节点到负载均衡器并测试连接：
-
-    ```sh
+    ```shell
    nc -v LOAD_BALANCER_IP PORT
    ```

    - 由于 apiserver 尚未运行，预期会出现一个连接拒绝错误。然而超时意味着负载均衡器不能和控制平面节点通信。
   如果发生超时，请重新配置负载均衡器与控制平面节点进行通信。

-1.  将其余控制平面节点添加到负载均衡器目标组。
+3.  将其余控制平面节点添加到负载均衡器目标组。

 <!-- ## Stacked control plane and etcd nodes -->
 ## 使用堆控制平面和 etcd 节点
@@ -180,7 +178,6 @@ option. Your cluster requirements may need a different configuration.
 ### 控制平面节点的第一步

 <!--
-
 1.  Initialize the control plane:

    ```sh
@@ -203,7 +200,6 @@ option. Your cluster requirements may need a different configuration.
    sudo kubeadm init --control-plane-endpoint "LOAD_BALANCER_DNS:LOAD_BALANCER_PORT" --upload-certs
    ```

-
    - 您可以使用 `--kubernetes-version` 标志来设置要使用的 Kubernetes 版本。建议将 kubeadm、kebelet、kubectl 和 Kubernetes 的版本匹配。
    - 这个 `--control-plane-endpoint` 标志应该被设置成负载均衡器的地址或 DNS 和端口。
    - 这个 `--upload-certs` 标志用来将在所有控制平面实例之间的共享证书上传到集群。如果正好相反，你更喜欢手动地通过控制平面节点或者使用自动化
@@ -224,7 +220,8 @@ To add a pod CIDR pass the flag `--pod-network-cidr`, or if you are using a kube
 set the `podSubnet` field under the `networking` object of `ClusterConfiguration`.
 -->
 {{< note >}}
-一些 CNI 网络插件如 Calico 需要 CIDR 例如 `192.168.0.0/16` 和一些像 Weave 没有。参考 [CNI 网络文档](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/#pod-network)。
+一些 CNI 网络插件如 Calico 需要 CIDR 例如 `192.168.0.0/16` 和一些像 Weave 没有。参考
+[CNI 网络文档](/zh/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/#pod-network)。
 通过传递 `--pod-network-cidr` 标志添加 pod CIDR，或者您可以使用 kubeadm 配置文件，在 `ClusterConfiguration` 的 `networking` 对象下设置 `podSubnet` 字段。
 {{< /note >}}

@@ -323,7 +320,8 @@ As stated in the command output, the certificate key gives access to cluster sen

 -->
 1.  应用您选择的 CNI 插件：
-    [请遵循以下指示](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/#pod-network) 安装 CNI 提供程序。如果适用，请确保配置与 kubeadm 配置文件中指定的 Pod CIDR 相对应。
+    [请遵循以下指示](/zh/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/#pod-network)
+    安装 CNI 提供程序。如果适用，请确保配置与 kubeadm 配置文件中指定的 Pod CIDR 相对应。

    在此示例中，我们使用 Weave Net：

@@ -414,7 +412,7 @@ in the kubeadm config file.

 ### 设置 ectd 集群

-1.  按照 [这些指示](/docs/setup/production-environment/tools/kubeadm/setup-ha-etcd-with-kubeadm/) 去设置 etcd 集群。
+1.  按照 [这些指示](/zh/docs/setup/production-environment/tools/kubeadm/setup-ha-etcd-with-kubeadm/) 去设置 etcd 集群。

 1.  设置 SSH 在 [这](#manual-certs)描述。

@@ -8,7 +8,6 @@ card:
  title: 安装 kubeadm 设置工具
 ---
 <!--
---
 title: Installing kubeadm
 content_type: task
 weight: 10
@@ -16,7 +15,6 @@ card:
  name: setup
  weight: 20
  title: Install the kubeadm setup tool
---
 -->

 <!-- overview -->
@@ -26,13 +24,11 @@ card:
 For information how to create a cluster with kubeadm once you have performed this installation process, see the [Using kubeadm to Create a Cluster](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/) page.
 -->
 <img src="https://raw.githubusercontent.com/kubernetes/kubeadm/master/logos/stacked/color/kubeadm-stacked-color.png" align="right" width="150px">本页面显示如何安装 `kubeadm` 工具箱。
-有关在执行此安装过程后如何使用 kubeadm 创建集群的信息，请参见[使用 kubeadm 创建集群](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/) 页面。
-
-
+有关在执行此安装过程后如何使用 kubeadm 创建集群的信息，请参见
+[使用 kubeadm 创建集群](/zh/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/) 页面。

 ## {{% heading "prerequisites" %}}

-
 <!--
 * One or more machines running one of:
  - Ubuntu 16.04+
@@ -65,7 +61,6 @@ For information how to create a cluster with kubeadm once you have performed thi
 * 禁用交换分区。为了保证 kubelet 正常工作，您 **必须** 禁用交换分区。


-
 <!-- steps -->

 <!--
@@ -187,7 +182,7 @@ documentation for the plugins about what port(s) those need.
 | TCP      | 入站   | 10250       | Kubelet API           | kubelet 自身、控制平面组件     |
 | TCP      | 入站   | 30000-32767 | NodePort 服务**   | 所有组件                     |

-** [NodePort 服务](/docs/concepts/services-networking/service/) 的默认端口范围。
+** [NodePort 服务](/zh/docs/concepts/services-networking/service/) 的默认端口范围。

 使用 * 标记的任意端口号都可以被覆盖，所以您需要保证所定制的端口是开放的。

@@ -255,7 +250,7 @@ Refer to the [CRI installation instructions](/docs/setup/cri) for more informati
 - [cri-o](https://cri-o.io/)
 - [frakti](https://github.com/kubernetes/frakti)

-请参考 [CRI 安装指南](/docs/setup/cri) 获取更多信息。
+请参考 [CRI 安装指南](/zh/docs/setup/production-environment/container-runtimes/)获取更多信息。

 <!--
 ## Installing kubeadm, kubelet and kubectl
@@ -294,7 +289,7 @@ kubeadm **不能** 帮您安装或者管理 `kubelet` 或 `kubectl`，所以您
 然而，控制平面与 kubelet 间的相差一个次要版本不一致是支持的，但 kubelet 的版本不可以超过 API 服务器的版本。
 例如，1.7.0 版本的 kubelet 可以完全兼容 1.8.0 版本的 API 服务器，反之则不可以。

-有关安装 `kubectl` 的信息，请参阅[安装和设置 kubectl](/docs/tasks/tools/install-kubectl/)文档。
+有关安装 `kubectl` 的信息，请参阅[安装和设置 kubectl](/zh/docs/tasks/tools/install-kubectl/)文档。

 {{< warning >}}
 <!--
@@ -302,7 +297,8 @@ These instructions exclude all Kubernetes packages from any system upgrades.
 This is because kubeadm and Kubernetes require
 [special attention to upgrade](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-14/).
 -->
-这些指南不包括系统升级时使用的所有 Kubernetes 程序包。这是因为 kubeadm 和 Kubernetes 有[特殊的升级注意事项](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-14/)。
+这些指南不包括系统升级时使用的所有 Kubernetes 程序包。这是因为 kubeadm 和 Kubernetes
+有[特殊的升级注意事项](/zh/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade/)。
 {{</ warning >}}

 <!--
@@ -313,8 +309,8 @@ For more information on version skews, see:
 -->
 关于版本偏差的更多信息，请参阅以下文档：

-* Kubernetes [版本与版本间的偏差策略](/docs/setup/release/version-skew-policy/)
-* Kubeadm-specific [版本偏差策略](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/#version-skew-policy)
+* Kubernetes [版本与版本间的偏差策略](/zh/docs/setup/release/version-skew-policy/)
+* Kubeadm-specific [版本偏差策略](/zh/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/#version-skew-policy)

 {{< tabs name="k8s_install" >}}
 {{% tab name="Ubuntu、Debian 或 HypriotOS" %}}
@@ -506,7 +502,8 @@ If you are running into difficulties with kubeadm, please consult our [troublesh
 -->
 ## 故障排查

-如果您在使用 kubeadm 时遇到困难，请参阅我们的[故障排查文档](/docs/setup/production-environment/tools/kubeadm/troubleshooting-kubeadm/)。
+如果您在使用 kubeadm 时遇到困难，请参阅我们的
+[故障排查文档](/zh/docs/setup/production-environment/tools/kubeadm/troubleshooting-kubeadm/)。

 ## {{% heading "whatsnext" %}}

@@ -514,6 +511,5 @@ If you are running into difficulties with kubeadm, please consult our [troublesh
 <!--
 * [Using kubeadm to Create a Cluster](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/)
 -->
-* [使用 kubeadm 创建集群](/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/)
-
+* [使用 kubeadm 创建集群](/zh/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/)

@@ -36,7 +36,7 @@ characteristics of a given machine, such as OS, storage, and networking. You can
 of your kubelets manually, but [kubeadm now provides a `KubeletConfiguration` API type for managing your
 kubelet configurations centrally](#configure-kubelets-using-kubeadm).
 -->
-kubeadm CLI 工具的生命周期与 [kubelet](/docs/reference/command-line-tools-reference/kubelet)解耦，它是一个守护程序，在 Kubernetes 集群中的每个节点上运行。
+kubeadm CLI 工具的生命周期与 [kubelet](/zh/docs/reference/command-line-tools-reference/kubelet)解耦，它是一个守护程序，在 Kubernetes 集群中的每个节点上运行。
 当 Kubernetes 初始化或升级时，kubeadm CLI 工具由用户执行，而 kubelet 始终在后台运行。

 由于kubelet是守护程序，因此需要通过某种初始化系统或服务管理器进行维护。
@@ -414,17 +414,15 @@ kubeadm 包含生成下述证书所需的所有必要的密码学工具；在这
    -->
    - 将 `${HOST0}` 设置为要测试的主机的 IP 地址

-
-
 ## {{% heading "whatsnext" %}}

-
 <!--
 Once your have a working 3 member etcd cluster, you can continue setting up a
 highly available control plane using the [external etcd method with
 kubeadm](/docs/setup/independent/high-availability/).
 -->
-一旦拥有了一个正常工作的 3 成员的 etcd 集群，你就可以基于[使用 kubeadm 的外部 etcd 方法](/docs/setup/independent/high-availability/)，继续部署一个高可用的控制平面。
-
+一旦拥有了一个正常工作的 3 成员的 etcd 集群，你就可以基于
+[使用 kubeadm 的外部 etcd 方法](/zh/docs/setup/production-environment/tools/kubeadm/high-availability/)，
+继续部署一个高可用的控制平面。