如何从本地机器访问EKS集群 拷贝kube config后kubectl认证报错解决方法

直接复制EC2上的kubeconfig到本地会认证失败的核心原因是：EKS默认的kubeconfig依赖AWS IAM身份凭证完成API server鉴权，EC2实例默认绑定了有权限访问EKS的IAM角色/凭证，而本地环境没有对应有效AWS凭证、也可能缺少aws cli的身份验证插件。

前置准备 #

本地需要先安装以下工具：

• 安装AWS CLI v2版本
• 安装kubectl，版本和EKS集群版本差不超过±1个小版本
• 安装AWS IAM authenticator插件（部分新版本AWS CLI会自动绑定，无需单独安装）

步骤1：配置本地AWS身份凭证 #

给本地配置拥有EKS访问权限的IAM用户/角色凭证，两种常用配置方式：

• 执行aws configure命令，依次输入有权限访问EKS的IAM用户的Access Key ID、Secret Access Key、默认区域（和EKS集群所在区域一致）、默认输出格式
• 也可以直接编辑本地~/.aws/credentials文件，手动写入凭证信息

步骤2：生成本地专用的kubeconfig配置 #

不要直接复制EC2上的配置，用AWS CLI直接生成本地可用的配置：
执行命令：aws eks update-kubeconfig --region <你的EKS集群所在区域> --name <你的EKS集群名称>
执行完成后该命令会自动将正确的集群、认证、上下文信息写入本地~/.kube/config文件，无需手动修改

步骤3：验证连通性 #

执行kubectl get nodes命令，正常返回集群节点信息即配置成功

常见问题排查 #

• 确认本地AWS凭证关联的IAM身份已经被加入EKS的aws-auth ConfigMap，拥有集群访问权限
• 确认本地AWS CLI身份有效：执行aws sts get-caller-identity命令可以验证当前凭证是否有效
• 确认集群名称和区域填写正确，和你创建的EKS集群信息一致

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