安装 kubeadm

本页面介绍如何安装 kubeadm 工具箱。有关在完成此安装过程后如何使用 kubeadm 创建集群的信息，请参阅使用 kubeadm 创建集群页面。

本安装指南适用于 Kubernetes v1.30。如果您想使用其他 Kubernetes 版本，请参阅以下页面

准备工作

  • 兼容的 Linux 主机。Kubernetes 项目为基于 Debian 和 Red Hat 的 Linux 发行版以及没有包管理器的发行版提供了通用说明。
  • 每台机器 2 GB 或更多 RAM（如果更少，则应用程序将没有多少空间）。
  • 2 个或更多 CPU。
  • 集群中所有机器之间的完全网络连接（公有或私有网络均可）。
  • 每个节点都有唯一的 hostname、MAC 地址和 product_uuid。有关更多详细信息，请参阅此处。
  • 您的机器上打开了某些端口。有关更多详细信息，请参阅此处。
  • 交换配置。kubelet 的默认行为是在节点上检测到交换内存时启动失败。有关更多详细信息，请参阅交换内存管理。
    • 如果未正确配置 kubelet 以使用交换，则必须禁用交换。例如，sudo swapoff -a 将临时禁用交换。要使此更改在重新启动后仍然有效，请确保在配置文件（如 /etc/fstab、systemd.swap）中禁用了交换，具体取决于它在系统上的配置方式。

验证每个节点的 MAC 地址和 product_uuid 是否唯一

  • 您可以使用命令 ip link 或 ifconfig -a 获取网络接口的 MAC 地址
  • 可以使用命令 sudo cat /sys/class/dmi/id/product_uuid 检查 product_uuid

硬件设备很可能具有唯一的地址，尽管某些虚拟机可能具有相同的值。Kubernetes 使用这些值来唯一标识集群中的节点。如果这些值对每个节点都不是唯一的，则安装过程可能会失败。

检查网络适配器

如果您有多个网络适配器，并且在默认路由上无法访问 Kubernetes 组件，我们建议您添加 IP 路由，以便 Kubernetes 集群地址通过相应的适配器。

检查所需端口

需要打开这些所需端口，以便 Kubernetes 组件能够相互通信。您可以使用netcat等工具来检查端口是否已打开。例如

nc 127.0.0.1 6443 -v

您使用的 Pod 网络插件也可能需要打开某些端口。由于这对于每个 Pod 网络插件都不同，因此请参阅插件的文档以了解需要哪些端口。

安装容器运行时

为了在 Pod 中运行容器，Kubernetes 使用容器运行时。

默认情况下，Kubernetes 使用容器运行时接口 (CRI) 与您选择的容器运行时交互。

如果您没有指定运行时，kubeadm 会通过扫描已知端点列表来自动尝试检测已安装的容器运行时。

如果检测到多个或没有容器运行时，kubeadm 将抛出一个错误，并要求您指定要使用的运行时。

有关更多信息，请参阅容器运行时。

下表列出了支持的操作系统的已知端点

Linux 容器运行时
运行时Unix 域套接字的路径
containerdunix:///var/run/containerd/containerd.sock
CRI-Ounix:///var/run/crio/crio.sock
Docker Engine（使用 cri-dockerd）unix:///var/run/cri-dockerd.sock

Windows 容器运行时
运行时Windows 命名管道的路径
containerdnpipe:////./pipe/containerd-containerd
Docker Engine（使用 cri-dockerd）npipe:////./pipe/cri-dockerd

安装 kubeadm、kubelet 和 kubectl

您将在所有机器上安装这些软件包

  • kubeadm：引导集群的命令。

  • kubelet：在集群中的所有机器上运行的组件，执行启动 Pod 和容器等操作。

  • kubectl：与集群通信的命令行工具。

kubeadm 不会为您安装或管理 kubelet 或 kubectl，因此您需要确保它们与您希望 kubeadm 为您安装的 Kubernetes 控制平面的版本相匹配。如果不这样做，则存在版本偏差的风险，这可能会导致意外的错误行为。但是，支持 kubelet 和控制平面之间一个次要版本的偏差，但 kubelet 版本可能永远不会超过 API 服务器版本。例如，运行 1.7.0 的 kubelet 应该与 1.8.0 API 服务器完全兼容，反之亦然。

有关安装 kubectl 的信息，请参阅安装和设置 kubectl。

有关版本偏差的更多信息，请参阅

这些说明适用于 Kubernetes v1.30。

  1. 更新 apt 软件包索引并安装使用 Kubernetes apt 存储库所需的软件包

    sudo apt-get update
# apt-transport-https may be a dummy package; if so, you can skip that package
sudo apt-get install -y apt-transport-https ca-certificates curl gpg

  2. 下载 Kubernetes 软件包存储库的公共签名密钥。所有存储库都使用相同的签名密钥，因此您可以忽略 URL 中的版本

    # If the directory `/etc/apt/keyrings` does not exist, it should be created before the curl command, read the note below.
# sudo mkdir -p -m 755 /etc/apt/keyrings
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.30/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg

  1. 添加适当的 Kubernetes apt 存储库。请注意，此存储库仅包含 Kubernetes 1.30 的软件包；对于其他 Kubernetes 次要版本，您需要更改 URL 中的 Kubernetes 次要版本以匹配您所需的次要版本（您还应该检查您是否正在阅读计划安装的 Kubernetes 版本的文档）。

    # This overwrites any existing configuration in /etc/apt/sources.list.d/kubernetes.list
echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.30/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list

  2. 更新 apt 软件包索引，安装 kubelet、kubeadm 和 kubectl，并固定它们的版本

    sudo apt-get update
sudo apt-get install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl

  3. （可选）在运行 kubeadm 之前启用 kubelet 服务

    sudo systemctl enable --now kubelet

  1. 将 SELinux 设置为 permissive 模式

    这些说明适用于 Kubernetes 1.30。

    # Set SELinux in permissive mode (effectively disabling it)
sudo setenforce 0
sudo sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config

  1. 添加 Kubernetes yum 存储库。存储库定义中的 exclude 参数可确保在运行 yum update 时不会升级与 Kubernetes 相关的软件包，因为升级 Kubernetes 必须遵循特殊的步骤。请注意，此存储库仅包含 Kubernetes 1.30 的软件包；对于其他 Kubernetes 次要版本，您需要更改 URL 中的 Kubernetes 次要版本以匹配您所需的次要版本（您还应该检查您是否正在阅读计划安装的 Kubernetes 版本的文档）。

    # This overwrites any existing configuration in /etc/yum.repos.d/kubernetes.repo
cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://pkgs.k8s.io/core:/stable:/v1.30/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v1.30/rpm/repodata/repomd.xml.key
exclude=kubelet kubeadm kubectl cri-tools kubernetes-cni
EOF

  2. 安装 kubelet、kubeadm 和 kubectl

    sudo yum install -y kubelet kubeadm kubectl --disableexcludes=kubernetes

  3. （可选）在运行 kubeadm 之前启用 kubelet 服务

    sudo systemctl enable --now kubelet

安装 CNI 插件（大多数 Pod 网络都需要）

CNI_PLUGINS_VERSION="v1.3.0"
ARCH="amd64"
DEST="/opt/cni/bin"
sudo mkdir -p "$DEST"
curl -L "https://github.com/containernetworking/plugins/releases/download/${CNI_PLUGINS_VERSION}/cni-plugins-linux-${ARCH}-${CNI_PLUGINS_VERSION}.tgz" | sudo tar -C "$DEST" -xz

定义下载命令文件的目录

DOWNLOAD_DIR="/usr/local/bin"
sudo mkdir -p "$DOWNLOAD_DIR"

安装 crictl（kubeadm / Kubelet 容器运行时接口 (CRI) 所需）

CRICTL_VERSION="v1.30.0"
ARCH="amd64"
curl -L "https://github.com/kubernetes-sigs/cri-tools/releases/download/${CRICTL_VERSION}/crictl-${CRICTL_VERSION}-linux-${ARCH}.tar.gz" | sudo tar -C $DOWNLOAD_DIR -xz

安装 kubeadm、kubelet 并添加 kubelet systemd 服务

RELEASE="$(curl -sSL https://dl.k8s.io/release/stable.txt)"
ARCH="amd64"
cd $DOWNLOAD_DIR
sudo curl -L --remote-name-all https://dl.k8s.io/release/${RELEASE}/bin/linux/${ARCH}/{kubeadm,kubelet}
sudo chmod +x {kubeadm,kubelet}

RELEASE_VERSION="v0.16.2"
curl -sSL "https://raw.githubusercontent.com/kubernetes/release/${RELEASE_VERSION}/cmd/krel/templates/latest/kubelet/kubelet.service" | sed "s:/usr/bin:${DOWNLOAD_DIR}:g" | sudo tee /usr/lib/systemd/system/kubelet.service
sudo mkdir -p /usr/lib/systemd/system/kubelet.service.d
curl -sSL "https://raw.githubusercontent.com/kubernetes/release/${RELEASE_VERSION}/cmd/krel/templates/latest/kubeadm/10-kubeadm.conf" | sed "s:/usr/bin:${DOWNLOAD_DIR}:g" | sudo tee /usr/lib/systemd/system/kubelet.service.d/10-kubeadm.conf

按照安装工具页面上的说明安装 kubectl。

（可选）在运行 kubeadm 之前启用 kubelet 服务

sudo systemctl enable --now kubelet

kubelet 现在每隔几秒就会重启一次，因为它在崩溃循环中等待 kubeadm 告诉它该做什么。

配置 cgroup 驱动程序

容器运行时和 kubelet 都有一个名为“cgroup 驱动程序”的属性，这对于管理 Linux 机器上的 cgroup 非常重要。

故障排除

如果您在使用 kubeadm 时遇到困难，请参阅我们的故障排除文档。

下一步是什么

上次修改时间：2024 年 5 月 29 日太平洋标准时间上午 10:41：将 cri-tools 版本提升至 v1.30.0 (102df83e40)