Azure AKS配置Kubernetes凭证后kubectl命令提示kubelogin未找到

问题根源 #

报错executable kubelogin not found的核心原因是：你的Azure AKS集群配置了Azure AD身份认证，kubectl需要通过kubelogin这个客户端凭证插件获取有效的Azure AD访问令牌，才能连接到AKS API Server。但你的系统未安装kubelogin，或者它不在系统PATH环境变量中，导致kubectl无法调用它完成认证。

切换上下文成功是因为该操作仅修改kubeconfig中的当前上下文标记，无需与AKS集群建立实际连接；而执行kubectl get pods等命令需要发起集群请求，必须完成身份认证，因此触发报错。

解决步骤 #

• 安装kubelogin
  推荐用Azure CLI直接安装，执行以下PowerShell命令：

  az aks install-cli --kubelogin
  

  也可通过Windows包管理器安装：

  • Winget：winget install Kubernetes.kubelogin
  • Chocolatey：choco install kubelogin

• 验证安装有效性
  执行以下命令确认kubelogin可正常调用：

  kubelogin version
  

  若能输出版本信息，说明安装成功且已在PATH中；若提示“找不到命令”，需手动将kubelogin的安装路径（通常为C:\Program Files\kubelogin或Azure CLI安装目录下的kubelogin文件夹）添加到系统PATH环境变量，重启PowerShell后生效。

• 确认kubeconfig配置（可选）
  打开.kube/config文件，找到对应AKS集群的user配置段，确认存在类似以下的exec配置（az aks get-credentials会自动生成）：

  user:
    exec:
      apiVersion: client.authentication.k8s.io/v1beta1
      args:
      - get-token
      - --environment
      - AzurePublicCloud
      - --server-id
      - <AKS服务器ID>
      - --client-id
      - <客户端ID>
      - --tenant-id
      - <租户ID>
      command: kubelogin
  

  只要kubelogin可正常调用，这段配置就能自动完成认证流程。

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