You need to enable JavaScript to run this app. Kubectl服务端版本未升级引发kubeadm join节点报错的问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

Kubectl服务端版本未升级引发kubeadm join节点报错的问题咨询

已知版本基线信息
  • 本地kubectl/kubeadm组件版本:v1.20.4,构建版本信息为Major:"1", Minor:"20", GitCommit:"e87da0bd6e03ec3fea7933c4b5263d151aafd07c",运行平台linux/amd64
  • 集群服务端版本:v1.18.8,构建版本信息为Major:"1", Minor:"18", GitCommit:"9f2892aab98fe339f3bd70e3c470144299398ace",运行平台linux/amd64
kubeadm join 执行命令与返回结果

执行的原始命令:

root@osswrkprbe007:~# kubeadm join 192.168.14.149:6443 --token 2w06dl.jz1clwuvknkbabqp --discovery-token-ca-cert-hash sha256:00370f52b8b14ae094ae83cb8333b9c7a141df9de7b039aeb33399ef5547f36f

命令返回的输出内容:

[preflight] Running pre-flight checks
[WARNING IsDockerSystemdCheck]: detected "cgroupfs" as the Docker cgroup driver. The recommended driver is "systemd".
[preflight] Reading configuration from the cluster...
[preflight] FYI: You can look at this config file with 'kubectl -n kube-system get cm kubeadm-config -o yaml'
error execution phase preflight: unable to fetch the kubeadm-config ConfigMap: this version of kubeadm only supports deploying clusters with the control plane version >= 1.19.0. Current version: v1.18.8
To see the stack trace of this error execute with --v=5 or higher

问题根因与解决操作

触发报错的核心原因是kubeadm存在严格的版本兼容规则:v1.20.4版本的kubeadm仅支持对接控制平面版本>=v1.19.0的集群,当前实际集群版本为v1.18.8,未达到版本校验阈值,在preflight阶段直接拦截流程。
可按以下方案处理:

  • 将待加入节点上的kubeadm组件降级至与集群服务端完全匹配的v1.18.8版本,小版本完全对齐可避免后续节点配置同步异常
  • 同步检查同节点上的kubelet、kubectl组件版本,保持三者与集群服务端版本一致,消除版本差过大导致的配置解析、权限鉴权类异常
  • 针对preflight阶段提示的Docker cgroup驱动告警,可后续调整Docker的cgroup驱动配置为systemd,消除非阻塞类兼容性告警
  • 若需要继续使用当前v1.20.4版本的kubeadm,需先将全集群的控制平面版本平滑升级至v1.19.0及以上版本,再重新执行节点加入操作

内容的提问来源于stack exchange,提问作者Emanuel Castelli

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 22:24:03