使用kubectl连接Azure Kubernetes集群失败的技术求助

这个报错很典型——kubectl默认尝试连接本地的Kubernetes API服务器（端口8080），但你的AKS集群是部署在Azure云端的，显然是本地的kubeconfig配置没正确关联到远程集群。我给你梳理几个靠谱的排查和解决步骤：

• 重新确认凭证获取命令的正确性
  你执行az aks get-credentials的时候，有没有指定正确的资源组和集群名称？正确的命令格式应该是：

  az aks get-credentials --resource-group <你的资源组名称> --name <你的AKS集群名称>
  

  如果需要用管理员权限访问，还要加上--admin参数。执行成功的话，会看到类似Merged "<集群名>" as current context in /xxx/.kube/config的提示。如果之前执行时没看到这个提示，或者参数填错了，重新执行一遍，建议加上--overwrite-existing参数强制覆盖旧配置：

  az aks get-credentials --resource-group <资源组名> --name <集群名> --overwrite-existing
  

• 检查并切换kubectl上下文
  有时候kubeconfig里会有多个集群上下文，kubectl可能没自动切换到你的AKS集群。先查看当前上下文：

  kubectl config current-context
  

  如果显示的不是你的AKS集群名称，就列出所有可用上下文：

  kubectl config get-contexts
  

  然后切换到正确的上下文：

  kubectl config use-context <你的AKS集群上下文名>
  

• 验证kubeconfig中的集群地址
  直接查看kubeconfig文件，确认里面的集群地址是AKS的远程API地址，而不是localhost:8080。在Linux/macOS下执行：

  cat ~/.kube/config
  

  Windows下执行：

  type %USERPROFILE%\.kube\config
  

  找到对应你的AKS集群的cluster部分，server字段应该是类似https://xxxx.hcp.xxx.azmk8s.io:443的HTTPS地址。如果显示的是http://localhost:8080，说明凭证没有正确合并，回到第一步重新执行获取凭证的命令。

• 排查网络和CLI版本问题

  • 确保你的网络没有防火墙、代理阻止到AKS API服务器的连接，可以尝试用curl <AKS的API地址>测试连通性（AKS API服务器可能不会返回内容，但只要不提示连接失败就没问题）。
  • 旧版本的Azure CLI可能存在兼容性问题，执行az upgrade把CLI更新到最新版本，之后再重新获取凭证尝试。

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