解决GKE中kubeconfig client-go认证插件容器挂载失效问题

当你在Mac上将本地kubeconfig挂载到容器后，因GKE切换到gke-gcloud-auth-plugin认证方式，容器内找不到对应二进制文件而出现no such file or directory错误，可通过以下几种方案解决：

方案一：在容器内安装gke-gcloud-auth-plugin #

这是最直接的方案，确保容器内具备所需的认证插件：

• 如果使用Debian/Ubuntu系镜像，启动容器时可直接安装插件：

  docker run -it \
    -v /Users/johndoe/.kube/config:/home/johndoe/.kube/config \
    your-image \
    bash -c "apt-get update && apt-get install -y google-cloud-sdk-gke-gcloud-auth-plugin && kubectl get nodes"
  

• 安装后，容器内插件默认路径通常为/usr/bin/gke-gcloud-auth-plugin，你可以修改kubeconfig中的command字段指向该路径；也可以创建软链接匹配本地kubeconfig中的路径，避免修改配置：

  ln -s /usr/bin/gke-gcloud-auth-plugin /opt/homebrew/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/bin/gke-gcloud-auth-plugin
  

方案二：替换为静态令牌认证 #

临时场景下，可直接使用本地生成的静态令牌替换kubeconfig中的exec认证逻辑：

1. 本地执行命令获取当前有效令牌：

   kubectl config view --minify -o jsonpath='{.users[0].user.token}'
   

2. 复制令牌，修改容器内的kubeconfig（或本地创建修改后的副本再挂载），将user部分替换为：

   user:
     token: <你获取到的令牌>
   

注意：令牌存在有效期，过期后需要重新生成。

方案三：使用服务账号密钥认证（生产环境推荐） #

生产环境建议使用GCP服务账号进行认证，避免依赖本地用户的认证状态：

1. 创建具备GKE访问权限的服务账号，下载其JSON密钥文件到本地
2. 启动容器时挂载密钥文件并设置环境变量：

   docker run -it \
     -v /Users/johndoe/.kube/config:/home/johndoe/.kube/config \
     -v /path/to/your-service-account-key.json:/home/johndoe/service-account-key.json \
     -e GOOGLE_APPLICATION_CREDENTIALS=/home/johndoe/service-account-key.json \
     your-image
   

3. 修改kubeconfig的user部分，让插件使用服务账号密钥：

   user:
     exec:
       apiVersion: client.authentication.k8s.io/v1beta1
       command: gke-gcloud-auth-plugin
       args: ["--cred-file", "/home/johndoe/service-account-key.json"]
       provideClusterInfo: true
   

方案四：同架构下挂载插件目录（局限性大） #

仅当你的Mac和容器为相同CPU架构（比如均为ARM64）时，可尝试直接挂载本地的google-cloud-sdk插件目录到容器：

docker run -it \
  -v /Users/johndoe/.kube/config:/home/johndoe/.kube/config \
  -v /opt/homebrew/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/bin:/opt/homebrew/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/bin \
  your-image

注意：跨架构（比如Mac ARM64 + 容器AMD64）会因二进制不兼容无法执行，不推荐此方案。

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