From 0cf8861a49775c8a3a324cf13c89b2db778d156d Mon Sep 17 00:00:00 2001 From: Alan Date: Sat, 29 Dec 2018 11:20:15 +0800 Subject: [PATCH] ZH-trans: Update install-kubeadm.md (#11955) * fix typo of install-kubeadm.md fix typo of install-kubeadm.md * Update install-kubeadm.md --- .../docs/setup/independent/install-kubeadm.md | 77 ++++++++++++------- 1 file changed, 49 insertions(+), 28 deletions(-) diff --git a/content/zh/docs/setup/independent/install-kubeadm.md b/content/zh/docs/setup/independent/install-kubeadm.md index b6427b2547..815ce46da5 100644 --- a/content/zh/docs/setup/independent/install-kubeadm.md +++ b/content/zh/docs/setup/independent/install-kubeadm.md @@ -18,7 +18,10 @@ weight: 20 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/independent/create-cluster-kubeadm/) page. --> - 本文会告诉您如何安装 `kubeadm` 工具。完成本文提到的安装步骤后，您可以阅读 [使用 kubeadm 来创建集群](/docs/setup/independent/create-cluster-kubeadm/) 了解如何使用 kubeadm 来创建集群。 + + 本文会告诉您如何安装 `kubeadm` 工具。 + 完成本文提到的安装步骤后，您可以阅读[使用 kubeadm 来创建集群](/docs/setup/independent/create-cluster-kubeadm/)， + 了解如何使用 kubeadm 来创建集群。 {{% /capture %}} @@ -51,9 +54,9 @@ see the [Using kubeadm to Create a Cluster](/docs/setup/independent/create-clust * 每台机器 2 GB 或更多的 RAM (如果少于这个数字将会影响您应用的运行内存) * 2 CPU 核心或更多 * 集群中的所有机器的网络彼此均能相互连接(公网和内网都可以) -* 节点之中不可以有重复的主机名，MAC 地址，product_uuid。更多详细信息请参见[这里](#verify-the-mac-address-and-product-uuid-are-unique-for-every-node) 。 -* 开启主机上的一些特定端口. 更多详细信息请参见[这里](#check-required-ports)。 -* 禁用 Swap 交换分区。为了保证 kubelet 正确运行，您 **必须** 禁用交换分区。 +* 节点之中不可以有重复的主机名、MAC 地址或 product_uuid。请参见[这里](#verify-the-mac-address-and-product-uuid-are-unique-for-every-node)了解更多细节。 +* 开启主机上的一些特定端口。请参见[这里](#check-required-ports)了解更多细节。 +* 禁用 Swap 交换分区。为了保证 kubelet 正确运行，您**必须**禁用交换分区。 {{% /capture %}} @@ -62,14 +65,16 @@ see the [Using kubeadm to Create a Cluster](/docs/setup/independent/create-clust + ## 确保每个节点上 MAC 地址和 product_uuid 的唯一性。 -* 您可以使用下列命令获取网络接口的 MAC 地址：`ip link` 或是 `ifconfig -a` -* 下列命令可以用来获取 product_uuid `sudo cat /sys/class/dmi/id/product_uuid` + +* 您可以使用命令 `ip link` 或 `ifconfig -a` 来获取网络接口的 MAC 地址 +* 用来获取 product_uuid 的命令是 `sudo cat /sys/class/dmi/id/product_uuid` -一般来讲，硬件设备会拥有独一无二的地址，但是有些虚拟机可能会雷同。Kubernetes 使用这些值来唯一确定集群中的节点。如果这些值在集群中不唯一，可能会导致安装[失败](https://github.com/kubernetes/kubeadm/issues/31)。 + +一般来讲，硬件设备会拥有独一无二的地址，但是有些虚拟机可能会雷同。Kubernetes 使用这些值来唯一确定集群中的节点。 +如果这些值在集群中不唯一，可能会导致安装[失败](https://github.com/kubernetes/kubeadm/issues/31)。 + 如果您有一个以上的网络适配器，同时您的 Kubernetes 组件通过默认路由不可达，我们建议您预先添加 IP 路由规则，这样 Kubernetes 集群就可以通过对应的适配器完成连接。 + ### Master 节点 + | 规则 | 方向 | 端口范围 | 作用 | 使用者 | |----------|-----------|------------|-------------------------|---------------------------| | TCP | Inbound | 6443* | Kubernetes API server | All | @@ -109,10 +119,12 @@ route, we recommend you add IP route(s) so Kubernetes cluster addresses go via t | TCP | Inbound | 10250 | Kubelet API | Self, Control plane | | TCP | Inbound | 10251 | kube-scheduler | Self | | TCP | Inbound | 10252 | kube-controller-manager | Self | + + ### Worker 节点 | 规则 | 方向 | 端口范围 | 作用 | 使用者 | @@ -122,19 +134,23 @@ route, we recommend you add IP route(s) so Kubernetes cluster addresses go via t -** [NodePort 服务](/docs/concepts/services-networking/service/) 的默认端口范围。 + +** [NodePort 服务](/docs/concepts/services-networking/service/)的默认端口范围。 -使用 * 标记的任意端口号都有可能被覆盖，所以您需要保证您的自定义端口的状态是开放的。 + +使用 * 标记的任意端口号都有可能被覆盖，所以您需要保证所提供的自定义端口的是开放的。 + 虽然 master 节点已经包含了 etcd 的端口，您也可以使用自定义的外部 etcd 集群，或是指定自定义端口。 + -从 v1.6.0 起，Kubernetes 开始允许使用 CRI，容器运行时接口。默认的容器运行时是 Docker，这是由 `kubelet` 内置的 CRI 实现： `dockershim` 开启的。 + +从 v1.6.0 起，Kubernetes 开始默认允许使用 CRI（容器运行时接口）。 +默认的容器运行时是 Docker，这是由 `kubelet` 内置的 CRI 实现 `dockershim` 开启的。 + 其他的容器运行时有： - [containerd](https://github.com/containerd/cri) (containerd 的内置 CRI 插件) @@ -170,30 +189,27 @@ Other CRI-based runtimes include: -参考 [CRI 安装指南](/docs/setup/cri) 获取更多信息。 +参考 [CRI 安装指南](/docs/setup/cri)获取更多信息。 -## 安装 kubeadm, kubelet 和 kubectl +## 安装 kubeadm、kubelet 和 kubectl -您需要在每台机器上都安装以下的软件包： +您需要在每台机器上安装以下的软件包： - * `kubeadm`: 用来初始化集群的指令。 + * `kubeadm`：用来初始化集群的指令。 - * `kubelet`: 在集群中的每个节点上用来启动 pod 和 container 等。 + * `kubelet`：在集群中的每个节点上用来启动 pod 和容器等。 - * `kubectl`: 用来与集群通信的命令行工具。 + * `kubectl`：用来与集群通信的命令行工具。 -kubeadm **不能** 帮您安装或管理 `kubelet` 或 `kubectl` ，所以您得保证它们满足通过 kubeadm 安装的 Kubernetes 控制层对版本的要求。如果版本没有满足要求，就有可能导致一些难以想到的错误或问题。然而控制层与 kubelet 间的 _小版本号_ 不一致无伤大雅，不过请记住 kubelet 的版本不可以超过 API server 的版本。例如 1.8.0 的 API server 可以适配 1.7.0 的 kubelet，反之则不可以。 +kubeadm **不能**帮您安装或管理 `kubelet` 或 `kubectl`，所以您得保证它们满足通过 kubeadm 安装的 Kubernetes 控制面对版本的要求。 +如果版本没有满足要求，就有可能导致一些难以想到的错误或问题。 +控制面与 kubelet 间的_小版本号_不一致无伤大雅，不过请记住 kubelet 的版本不可以超过 API 服务器的版本。 +例如 1.7.0 版本的 kubelet 可以兼容 1.8.0 版本的 API 服务器，反之则不可以。 {{< warning >}} -这些指南不包括所有系统升级时使用的 Kubernetes 程序包。这是因为 kubeadm 和 Kubernetes 需要 [升级时的特别注意事项](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-11/). +这些指南不包括系统升级时使用的所有 Kubernetes 程序包。这是因为 kubeadm 和 Kubernetes 需要[特殊的升级注意事项](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-11/)。 {{}} -更多关于版本冲突的信息，请参阅 [版本冲突政策](/docs/setup/independent/create-cluster-kubeadm/#version-skew-policy)。 +更多关于版本冲突的信息，请参阅[版本冲突政策](/docs/setup/independent/create-cluster-kubeadm/#version-skew-policy)。 {{< tabs name="k8s_install" >}} {{% tab name="Ubuntu, Debian or HypriotOS" %}} @@ -243,6 +262,7 @@ apt-mark hold kubelet kubeadm kubectl {{% /tab %}} {{% tab name="CentOS, RHEL or Fedora" %}} + ```bash cat < /etc/yum.repos.d/kubernetes.repo [kubernetes] @@ -291,7 +311,7 @@ systemctl enable kubelet && systemctl start kubelet -安装 CNI 插件（大多数 pod network 都需要）： +安装 CNI 插件（大多数 pod 网络都需要）： ```bash CNI_VERSION="v0.6.0" @@ -302,7 +322,7 @@ curl -L "https://github.com/containernetworking/plugins/releases/download/${CNI_ -安装 crictl (kubeadm / Kubelet 的容器运行时接口 (CRI) 要求) +安装 crictl (kubeadm/Kubelet 的容器运行时接口 (CRI) 要求) ```bash CRICTL_VERSION="v1.11.1" @@ -313,7 +333,7 @@ curl -L "https://github.com/kubernetes-incubator/cri-tools/releases/download/${C -安装 `kubeadm`, `kubelet`, `kubectl` 并且添加一个 `kubelet` systemd 服务: +安装 `kubeadm`、`kubelet` 和 `kubectl` 并且添加一个 `kubelet` systemd 服务: ```bash RELEASE="$(curl -sSL https://dl.k8s.io/release/stable.txt)" @@ -354,7 +374,7 @@ kubelet 现在每隔几秒就会重启，因为它陷入了一个等待 kubeadm When using Docker, kubeadm will automatically detect the cgroup driver for the kubelet and set it in the `/var/lib/kubelet/kubeadm-flags.env` file during runtime. --> -使用 Docker 时，kubeadm 会自动为其检测 cgroup 驱动在运行时对 `/var/lib/kubelet/kubeadm-flags.env` 文件进行配置。 +使用 Docker 时，kubeadm 会自动为其检测 cgroup 驱动并在运行时对 `/var/lib/kubelet/kubeadm-flags.env` 文件进行配置。 -请注意，您**只**需要在您的 cgroup driver 不是 `cgroupfs` 时这么做，因为 `cgroupfs` 已经是 kubelet 的默认值了。 +请注意，您**只**需要在您的 cgroup 驱动程序不是 `cgroupfs` 时这么做，因为 `cgroupfs` 是 kubelet 的默认值。 -如果您在使用 kubeadm 时候遇到问题，请查看我们的 [疑难解答文档](/docs/setup/independent/troubleshooting-kubeadm/)。 +如果您在使用 kubeadm 时候遇到问题，请查看我们的[疑难解答文档](/docs/setup/independent/troubleshooting-kubeadm/)。 + {{% capture whatsnext %}}