AWS EKS 1.29集群kubectl报apiVersion无效，如何更新API版本？

问题根源 #

kubectl 1.29及以上版本已移除对client.authentication.k8s.io/v1alpha1 API版本的支持，旧版AWS CLI生成的kubeconfig会默认使用这个废弃版本。即便手动修改kubeconfig中的apiVersion，若AWS CLI版本过低或存在缓存的认证配置，问题仍可能持续。

解决方案 #

1. 升级AWS CLI至最新版本 #

旧版AWS CLI生成的exec配置依赖废弃的v1alpha1版本，升级后会自动生成兼容的client.authentication.k8s.io/v1beta1或v1版本：

• Linux/macOS：

  curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
  unzip awscliv2.zip
  sudo ./aws/install --update
  

• Windows：
  下载AWS CLI v2安装包覆盖安装，或用Chocolatey：

  choco upgrade awscli
  

验证版本（需≥2.13.0）：

aws --version

2. 重新生成kubeconfig配置 #

手动修改易出错，直接用AWS CLI生成适配的配置：

aws eks update-kubeconfig --region ap-south-1 --name HR-dev-eksdemo1

该命令会自动合并/覆盖现有kubeconfig，生成的exec部分将使用兼容kubectl 1.29的认证API版本。

3. 验证配置正确性 #

检查kubeconfig中用户exec段的apiVersion：

grep -A5 "apiVersion" ~/.kube/config

确认输出为client.authentication.k8s.io/v1beta1或v1即可。

4. 测试kubectl命令 #

执行以下命令验证修复效果：

kubectl get nodes

额外排查点 #

• 若仍报错，检查环境变量KUBECONFIG是否指定了多个配置文件，确保使用的是最新生成的kubeconfig。
• 清理kubectl认证缓存：

  kubectl config unset users.arn:aws:eks:ap-south-1:433614228219:cluster/HR-dev-eksdemo1.exec.cache
  

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