安装 kubeadm | Kubernetes

此文档的更新日期比原文晚，因此其中的信息可能已过时。如果能阅读英文，请查看英文版本以获取最新信息： Installing kubeadm
本页面显示如何安装 kubeadm 工具箱。 有关在执行此安装过程后如何使用 kubeadm 创建集群的信息， 请参见使用 kubeadm 创建集群。
此 installation guide 适用于 Kubernetes v1.37。如果你想使用其他 Kubernetes 版本，请参考以下页面：
kubeadm 的安装是通过使用动态链接的二进制文件完成的，安装时假设你的目标系统提供 glibc。 这个假设在许多 Linux 发行版（包括 Debian、Ubuntu、Fedora、CentOS 等）上是合理的， 但对于不包含默认 glibc 的自定义和轻量级发行版（如 Alpine Linux），情况并非总是如此。 预期的情况是，发行版要么包含 glibc， 要么提供了一个兼容层以提供所需的符号。
欲了解更多信息，参阅 Linux 内核要求。
欲了解更多信息，参阅 Windows 操作系统版本兼容性。
由 kubeadm 创建的 Kubernetes 集群依赖于使用内核特性的相关软件。这些软件包括但不限于容器运行时、kubelet 和容器网络接口（CNI）插件。
为帮助你避免因内核版本不受支持而引发的意外错误，kubeadm 运行 SystemVerification 执行预检。如果内核版本不受支持，预检将失败。
如果你确认你的内核具备所需特性，尽管其版本不在 kubeadm 支持范围内， 你也可以选择跳过此检查。
一般来讲，硬件设备会拥有唯一的地址，但是有些虚拟机的地址可能会重复。 Kubernetes 使用这些值来唯一确定集群中的节点。 如果这些值在每个节点上不唯一，可能会导致安装失败。
如果你有一个以上的网络适配器，同时你的 Kubernetes 组件通过默认路由不可达，我们建议你预先添加 IP 路由规则， 这样 Kubernetes 集群就可以通过对应的适配器完成连接。
启用这些必要的端口后才能使 Kubernetes 的各组件相互通信。可以使用 netcat 之类的工具来检查端口是否开放，例如：
你使用的 Pod 网络插件 (详见后续章节) 也可能需要开启某些特定端口。 由于各个 Pod 网络插件的功能都有所不同，请参阅他们各自文档中对端口的要求。
kubelet 的默认行为是在节点上检测到交换内存时无法启动。 这意味着要么禁用交换（swap）功能，要么让 kubelet 容忍交换。
为了在 Pod 中运行容器，Kubernetes 使用容器运行时（Container Runtime）。
默认情况下，Kubernetes 使用容器运行时接口（Container Runtime Interface，CRI） 来与你所选择的容器运行时交互。
如果你不指定运行时，kubeadm 会自动尝试通过扫描已知的端点列表来检测已安装的容器运行时。
如果检测到有多个或者没有容器运行时，kubeadm 将抛出一个错误并要求你指定一个想要使用的运行时。
Docker Engine 没有实现 CRI， 而这是容器运行时在 Kubernetes 中工作所需要的。 为此，必须安装一个额外的服务 cri-dockerd。 cri-dockerd 是一个基于传统的内置 Docker 引擎支持的项目， 它在 1.24 版本从 kubelet 中移除。
下面的表格包括被支持的操作系统的已知端点。
kubelet：在集群中的每个节点上用来启动 Pod 和容器等。
kubectl：用来与集群通信的命令行工具。
kubeadm 不能帮你安装或者管理 kubelet 或 kubectl， 所以你需要确保它们与通过 kubeadm 安装的控制平面的版本相匹配。 如果不这样做，则存在发生版本偏差的风险，可能会导致一些预料之外的错误和问题。 然而，控制平面与 kubelet 之间可以存在一个次要版本的偏差，但 kubelet 的版本不可以超过 API 服务器的版本。 例如，1.7.0 版本的 kubelet 可以完全兼容 1.8.0 版本的 API 服务器，反之则不可以。
有关安装 kubectl 的信息，请参阅安装和设置 kubectl 文档。
这些指南不包括系统升级时使用的所有 Kubernetes 程序包。这是因为 kubeadm 和 Kubernetes 有特殊的升级注意事项。
关于版本偏差的更多信息，请参阅以下文档：
每个 Kubernetes 小版本都有一个专用的软件包仓库。 如果你想安装 1.37 以外的次要版本，请参阅所需次要版本的安装指南。
以下指令适用于 Kubernetes 1.37.
更新 apt 包索引并安装使用 Kubernetes apt 仓库所需要的包：
下载用于 Kubernetes 软件包仓库的公共签名密钥。所有仓库都使用相同的签名密钥， 因此你可以忽略 URL 中的版本：
在低于 Debian 12 和 Ubuntu 22.04 的发行版本中，/etc/apt/keyrings 默认不存在。 应在 curl 命令之前创建它。
添加 Kubernetes apt 仓库。 请注意，此仓库仅包含适用于 Kubernetes 1.37 的软件包； 对于其他 Kubernetes 次要版本，则需要更改 URL 中的 Kubernetes 次要版本以匹配你所需的次要版本 （你还应该检查正在阅读的安装文档是否为你计划安装的 Kubernetes 版本的文档）。
更新 apt 包索引，安装 kubelet、kubeadm 和 kubectl，并锁定其版本：
（可选）先启用 kubelet 服务，再运行 kubeadm：
将 SELinux 设置为 permissive 模式：
以下指令适用于 Kubernetes 1.37。
添加 Kubernetes 的 yum 仓库。在仓库定义中的 exclude 参数确保了与 Kubernetes 相关的软件包在运行 yum update 时不会升级，因为升级 Kubernetes 需要遵循特定的过程。请注意，此仓库仅包含适用于 Kubernetes 1.37 的软件包； 对于其他 Kubernetes 次要版本，则需要更改 URL 中的 Kubernetes 次要版本以匹配你所需的次要版本 （你还应该检查正在阅读的安装文档是否为你计划安装的 Kubernetes 版本的文档）。
安装 kubelet、kubeadm 和 kubectl，并启用 kubelet 以确保它在启动时自动启动:
安装 CNI 插件（大多数 Pod 网络都需要）：
DOWNLOAD_DIR 变量必须被设置为一个可写入的目录。 如果你在运行 Flatcar Container Linux，可设置 DOWNLOAD_DIR="/opt/bin"。