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
执行的原始命令:
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

