首页/云/Kubernetes 速查/kubeadm join 添加节点
本包目录(307 条)
kubectl 基础56 条工作负载36 条网络与服务55 条配置与存储54 条调度与资源52 条
集群运维与排障54 条

kubeadm join 添加节点

新节点先装好容器运行时与 kubelet、kubeadm,再用 join 命令接入集群;token 过期可直接重新生成,不必重装节点。

Kubernetes 速查云更新于 2026-10-12

在控制面生成加入命令

在控制面生成加入命令
kubeadm token create --print-join-command
# 已有 token 时单独取 CA 证书哈希
openssl x509 -pubkey -in /etc/kubernetes/pki/ca.crt | openssl rsa -pubin -outform der 2>/dev/null | openssl dgst -sha256 -hex

在新节点执行

在新节点执行
kubeadm join 10.0.0.10:6443 --token abcdef.0123456789abcdef \
  --discovery-token-ca-cert-hash sha256:<hash>
加入完成后节点通常会先 NotReady,等 CNI 就绪转为 Ready;用 kubectl get nodes -w 观察变化。

易错点

  • token 默认 24 小时有效:报 token 不存在时重新生成,而不是重装节点
  • 漏检查 swap 与运行时状态:join 显示成功但 kubelet 起不来,原因在 journalctl 里

数据来源与参考

  • Kubernetes 官方文档 · 使用 kubeadm 创建集群
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌