无法通过kubectl访问AWS EKS集群问题求助

• 更新kubeconfig配置
  执行以下命令将EKS集群t的凭证信息同步到kubectl的配置文件中：

  aws eks update-kubeconfig --name t --region <你的集群所在AWS区域>
  

  替换<你的集群所在AWS区域>为实际值（如us-east-1），执行成功后会提示集群上下文已添加到本地kubeconfig。

• 验证kubeconfig有效性
  查看本地kubeconfig文件，确认集群t的配置已正确写入：

  cat ~/.kube/config
  

  检查输出中是否包含对应集群t的clusters、contexts和users条目，且users部分包含AWS凭证自动获取的相关配置。

• 检查IAM用户权限
  确保当前登录的AWS用户具备以下权限：

  • eks:DescribeCluster：用于获取集群元数据生成kubeconfig
  • 同时需要在EKS集群的RBAC配置中，将该IAM用户映射到具备访问权限的Kubernetes用户组（如system:masters）。可通过查看aws-auth ConfigMap验证映射关系：

    kubectl get configmap aws-auth -n kube-system -o yaml
    

    若未配置映射，需添加类似以下内容到data.mapUsers字段：

    - userarn: arn:aws:iam::<你的AWS账号ID>:user/<你的IAM用户名>
      username: <你的IAM用户名>
      groups:
        - system:masters
    

• 确认版本兼容性
  检查EKS集群t的版本，确保kubectl客户端版本（v1.23.6）与集群版本的差距在±1个版本范围内（Kubernetes官方兼容性规则）。执行以下命令查看集群版本：

  aws eks describe-cluster --name t --query "cluster.version" --output text
  

  若版本差距过大，需升级或降级kubectl版本以匹配集群。

• 清理冲突配置
  如果本地kubeconfig存在旧的集群t条目，可能导致冲突。先备份原配置：

  cp ~/.kube/config ~/.kube/config.bak
  

  删除旧的集群t相关条目后，重新执行aws eks update-kubeconfig命令。

完成以上步骤后，再次执行kubectl version --short验证访问是否正常。

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