容器与云原生 / 系统课时

加入工作节点

加入工作节点

工作节点加入 kubeadm 集群的核心不是复制配置文件,而是让新节点验证控制平面身份,再通过 TLS bootstrap 获得 kubelet 客户端证书并注册 Node。本课完成加入命令生成、工作节点接入,以及 Node、kubelet、kube-proxy 和 CNI 组件的联合验证。

学习目标

  • 在控制平面生成新的 kubeadm join 命令并理解令牌与 CA 哈希的作用
  • 在工作节点完成 preflight、发现、TLS bootstrap 和 kubelet 启动
  • 从控制平面确认 Node 已注册,并检查该节点上的系统组件是否正常运行

加入前检查工作节点

工作节点应已经安装与集群兼容的 kubeadm、kubelet 和容器运行时,并能访问 API Server 地址与端口。还要确认主机名和地址不会与现有节点冲突;如果机器曾加入过其他 kubeadm 集群,应先清理旧状态再重试。

在工作节点执行基础检查:

bash
# swap 正常应无输出,容器运行时应处于 active
sudo swapon --show
sudo systemctl is-active containerd

# 记录节点实际安装的 kubeadm 与 kubelet 版本
kubeadm version -o short
kubelet --version

预期结果

text
active
kubeadm version: v<VERSION>
Kubernetes v<VERSION>

第一条命令正常情况下不输出任何交换分区;containerd 应为 active。kubeadm 与 kubelet 的版本值以实际安装版本为准,并应满足 Kubernetes 的版本偏差策略。

生成并执行 join 命令

在控制平面节点生成一个当前可用的加入命令。这样可以避免继续使用已经过期的 bootstrap token。

bash
# 在控制平面生成新的 bootstrap token 并打印完整加入命令
sudo kubeadm token create --print-join-command

预期输出

text
kubeadm join <CONTROL_PLANE_ENDPOINT>:6443 --token <TOKEN> --discovery-token-ca-cert-hash sha256:<HASH>

把完整输出复制到工作节点,并把其中三个动态值填入变量后执行:

bash
CONTROL_PLANE_ENDPOINT="<CONTROL_PLANE_ENDPOINT>"
TOKEN="<TOKEN>"
HASH="<HASH>"

# 三个值都应逐字来自控制平面刚生成的 join 命令
sudo kubeadm join "${CONTROL_PLANE_ENDPOINT}:6443" \
  --token "${TOKEN}" \
  --discovery-token-ca-cert-hash "sha256:${HASH}"

预期输出

text
[preflight] Running pre-flight checks
[kubelet-start] Starting the kubelet
This node has joined the cluster:

kubeadm 工作节点加入集群的信任建立时序

--discovery-token-ca-cert-hash 用于固定控制平面根 CA 公钥摘要,避免新节点只凭网络地址和共享令牌就信任错误的 API Server。随后 kubelet 使用 bootstrap 身份申请证书,完成后才以正式节点身份持续连接控制平面。

验证节点注册与系统组件

回到控制平面,等待新节点进入 Ready,再检查系统 Pod 是否已经落到这个节点。将 <WORKER_NAME> 替换为工作节点真实名称。

bash
WORKER_NAME="<WORKER_NAME>"

# Ready 之后再检查该节点承载的节点级系统组件
kubectl wait --for=condition=Ready "node/${WORKER_NAME}" --timeout=180s
kubectl get node "${WORKER_NAME}" -o wide

kubectl get pods -A -o wide \
  --field-selector "spec.nodeName=${WORKER_NAME}"

预期结果

text
node/<WORKER_NAME> condition met

NAME            STATUS   ROLES    AGE    VERSION   INTERNAL-IP
<WORKER_NAME>   Ready    <none>   <TIME> <VALUE>   <IP>

NAMESPACE      NAME               READY   STATUS    RESTARTS   AGE    NODE
kube-system    kube-proxy-<ID>    1/1     Running   0          <TIME> <WORKER_NAME>
<NAMESPACE>    <CNI_POD>-<ID>     1/1     Running   0          <TIME> <WORKER_NAME>

实际列值、CNI 命名空间和 Pod 名称取决于集群配置。节点已经注册但长期 NotReady 时,先看 kubectl describe node <WORKER_NAME> 的 Conditions 和事件;如果提示网络未就绪,应优先修复 CNI,而不是反复执行 kubeadm join。

常见加入失败怎么处理

kubeadm join 在真正修改节点前会执行 preflight。最常见的失败可以按错误位置快速归类:无法连接 <CONTROL_PLANE_ENDPOINT>:6443 时检查路由、防火墙和 API Server 地址;提示 token 无效或过期时重新运行 kubeadm token create --print-join-command;容器运行时检测失败时确认 CRI 服务与 socket;若机器存在旧 kubeadm 状态,确认不再需要旧集群后再执行 kubeadm reset 并重新加入。

加入成功的最终判据不是命令退出码,而是控制平面能够持续看到该节点为 Ready,并且 kube-proxy 与所选 CNI 的节点级组件都在新工作节点上稳定运行。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

加入工作节点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通