Windows下kubectl客户端与服务端版本偏差超支持范围问题咨询

1. 版本偏差警告的影响 #

该警告不是可以直接忽略的提示，需要重点关注。
Kubernetes官方明确的版本兼容规则为：kubectl与对接集群的版本差最多不能超过1个小版本（即±1 skew policy）。你当前使用的kubectl是1.24版本，对接的集群是1.20版本，差了4个小版本，已经超出兼容范围：

• 简单查询类命令（比如kubectl get nodes、kubectl describe pod）大概率可以正常运行，但涉及资源创建、更新、新特性调用的操作很容易出现异常：比如1.24版本kubectl发送的请求里携带了1.20版本apiserver不识别的新字段，会直接报错；部分1.20版本支持但后续版本被废弃的字段，可能在apply过程中被静默丢弃，引发配置不符合预期的问题，生产环境下风险很高。
• 输出里第一条关于版本信息格式弃用的警告不影响任何功能，只是提示后续版本会调整kubectl version的默认输出格式，无需处理。

2. 异常修复方案 #

核心修复逻辑是将kubectl版本调整到与集群版本差不超过1个小版本的兼容区间，你当前对接的集群是1.20.7版本，选择1.19.x、1.20.x、1.21.x系列的kubectl都可以，优先推荐安装和集群版本完全一致的v1.20.7：

• 如果是通过Chocolatey安装的kubectl，直接执行命令choco install kubernetes-cli --version=1.20.7即可完成版本切换；
• 如果是手动下载二进制安装的，直接下载v1.20.7版本对应的windows/amd64架构kubectl.exe文件，替换当前系统PATH目录下的旧kubectl文件即可。

替换完成后重新执行kubectl version，版本偏差警告就会消失。
如果你需要同时对接多个不同版本的Kubernetes集群，可以搭配版本切换工具使用，切换集群上下文时自动匹配对应版本的kubectl，避免手动替换二进制的麻烦。

3. Server版本指代的组件 #

输出中的Server Version特指当前kubectl对接的Kubernetes集群的kube-apiserver组件版本。
kubectl的所有操作都是直接与kube-apiserver交互，不会直接和集群内的kubelet、controller-manager、etcd等其他组件通信，因此版本兼容性校验只会比对kubectl和kube-apiserver的版本。正常部署的集群中，其他组件版本不会高于kube-apiserver版本，版本差也会控制在官方允许的范围内。

4. 与~/.kube/config配置文件的关联 #

版本偏差问题本身和~/.kube/config（Windows下对应用户目录下的.kube/config文件）没有直接因果关系：该配置文件仅存储集群访问地址、认证凭据、默认上下文等连接信息，本身不会修改kubectl或者集群的版本。
二者存在间接关联：你当前看到的服务端版本，是配置文件中设置的默认上下文所指向的集群的apiserver版本。如果你的配置文件中存储了多个集群的访问信息，切换上下文到其他版本的集群时，kubectl version输出的Server Version会对应变化，版本偏差警告也可能随之出现或者消失。 #

内容的提问来源于stack exchange，提问作者gstackoverflow