容器与云原生 / 系统课时
安装 Kubernetes 组件
安装 Kubernetes 组件
本课在每台集群节点上配置 Kubernetes 官方软件源,安装版本一致的 kubeadm、kubelet 和 kubectl,并锁定软件包版本,避免系统自动升级造成组件版本偏差。
学习目标
- 理解 kubeadm、kubelet 与 kubectl 的职责区别
- 从指定次版本的软件源安装三个组件
- 验证版本一致性并启用版本锁定
安装前检查
以下操作适用于 Ubuntu 或 Debian 系统,并应在控制平面节点和所有工作节点执行。开始前确认容器运行时已经可用、节点能够访问 pkgs.k8s.io,并且当前账号具有 sudo 权限。
三个组件分工不同:kubeadm 负责初始化或加入集群,kubelet 负责在节点上运行 Pod,kubectl 负责访问 Kubernetes API。kubeadm 不会替你安装另外两个组件,因此必须主动控制版本。
先检查系统架构、容器运行时与交换分区状态:
uname -m
sudo crictl info >/dev/null && echo "CRI ready"
swapon --show预期输出:
x86_64
CRI readyswapon --show 没有输出表示交换分区已经关闭。若仍显示设备或文件,应先执行 sudo swapoff -a,并同步修改 /etc/fstab,避免重启后再次启用。
配置 Kubernetes 软件源
Kubernetes 的软件仓库按次版本划分。下面示例选择 v1.36;如果项目规定了其他次版本,只修改 K8S_MINOR,不要混用不同次版本的仓库。
set -euo pipefail
K8S_MINOR="v1.36"
sudo apt-get update
sudo apt-get install -y ca-certificates curl gpg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL "https://pkgs.k8s.io/core:/stable:/${K8S_MINOR}/deb/Release.key" \
| sudo gpg --dearmor --batch --yes \
-o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/${K8S_MINOR}/deb/ /" \
| sudo tee /etc/apt/sources.list.d/kubernetes.list >/dev/null
sudo apt-get update
apt-cache madison kubeadm | head预期结果:
kubeadm | 1.36.<PATCH>-<REVISION> | https://pkgs.k8s.io/core:/stable:/v1.36/deb Packages<PATCH> 和 <REVISION> 会随仓库更新而变化。只要候选版本属于目标次版本,即可继续安装。
安装并锁定版本
先从 kubeadm 的候选列表取得完整软件包版本,再用同一个版本安装三个组件。这样可以避免只限定主次版本时意外选中不同修订版本。
set -euo pipefail
K8S_PACKAGE_VERSION="$(apt-cache madison kubeadm | awk 'NR==1 {print $3}')"
if [ -z "$K8S_PACKAGE_VERSION" ]; then
echo "未找到 kubeadm 候选版本" >&2
exit 1
fi
sudo apt-get install -y \
kubeadm="$K8S_PACKAGE_VERSION" \
kubelet="$K8S_PACKAGE_VERSION" \
kubectl="$K8S_PACKAGE_VERSION"
sudo apt-mark hold kubeadm kubelet kubectl
sudo systemctl enable --now kubelet预期结果:
kubeadm set on hold.
kubelet set on hold.
kubectl set on hold.初始化集群前,kubelet 尚未获得集群配置,可能周期性重启。这通常不是安装失败;真正的判断依据是软件包、服务单元和版本是否正确。
验证安装结果
分别读取三个组件的版本,并检查锁定清单:
printf 'kubeadm: '
kubeadm version -o short
printf 'kubectl: '
kubectl version --client --output=yaml | awk '/gitVersion:/ {print $2; exit}'
printf 'kubelet: '
kubelet --version
apt-mark showhold | grep -E '^(kubeadm|kubectl|kubelet)$' | sort
systemctl is-enabled kubelet预期输出:
kubeadm: v1.36.<PATCH>
kubectl: v1.36.<PATCH>
kubelet: Kubernetes v1.36.<PATCH>
kubeadm
kubectl
kubelet
enabled三个版本应具有相同的主版本和次版本。若某个组件不一致,先执行 sudo apt-mark unhold kubeadm kubelet kubectl,安装指定的完整版本,再重新锁定。
常见失败处理
出现 NO_PUBKEY 或签名校验失败时,重新下载密钥并确认软件源中的 signed-by 路径与密钥文件一致。出现候选版本为空时,优先检查 K8S_MINOR 是否存在、节点 DNS 是否正常,以及软件源文件是否写入成功。
如果 kubelet 日志提示找不到配置文件,可先保留现状,下一课执行 kubeadm init 或 kubeadm join 后会生成所需配置。可用以下命令确认没有更早的运行时错误:
sudo journalctl -u kubelet -n 30 --no-pager预期结果:
日志可能包含等待 /var/lib/kubelet/config.yaml 或连接控制平面的提示;不应持续出现容器运行时不可达、权限拒绝或二进制不存在。本课总结
- kubeadm、kubelet 和 kubectl 需要单独安装,并应保持目标次版本一致
pkgs.k8s.io按次版本提供软件源,安装时应固定完整软件包版本- 使用
apt-mark hold可以防止常规系统升级意外改变 Kubernetes 组件版本
下一课预告
下一课将使用 kubeadm 初始化控制平面,配置管理员 kubeconfig,并检查 API Server、etcd 和其他系统组件的运行状态。