使用GitHub Actions部署至AKS时kubectl命令无法识别求助

开发者阿泽

2026-7-1

问题

尝试通过GitHub Actions将两个微服务部署到AKS集群（此前在minikube上部署完全正常），部署流程如下：

构建Docker镜像并推送至DockerHub
使用azure/login@1.4.6登录Azure
通过azure/setup-kubectl@v2.0配置kubectl工具
执行kubectl apply -f ./service-1/k8s部署微服务

注：./service-1/k8s/目录下的service.yaml、ingress.yaml和deployment.yaml在minikube环境中部署完全正常，但在GitHub Actions中执行任何kubectl命令都会报错，控制台输出错误信息如下：

E0118 [time]    1792 memcache.go:265] couldn't get current server API group list: Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connect: connection refused
E0118 [time]    1792 memcache.go:265] couldn't get current server API group list: Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connect: connection refused
E0118 [time]    1792 memcache.go:265] couldn't get current server API group list: Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connect: connection refused
unable to recognize "service-1/k8s/deployment.yaml": Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connect: connection refused
unable to recognize "service-1/k8s/ingress.yaml": Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connect: connection refused
unable to recognize "service-1/k8s/service.yaml": Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connect: connection refused

解决方案

该错误核心原因是kubectl未正确关联到AKS集群的API服务器，默认尝试连接本地localhost:8080（minikube默认的本地API地址），解决步骤如下：

添加AKS上下文配置步骤：在azure/login动作之后，新增azure/aks-set-context@v3动作，用来获取目标AKS集群的kubeconfig并设置kubectl上下文。示例配置：
```
- name: Set AKS cluster context
  uses: azure/aks-set-context@v3
  with:
    resource-group: <你的Azure资源组名称>
    cluster-name: <你的AKS集群名称>
```
验证账号权限：确保登录的Azure账号拥有目标AKS集群的访问权限，至少需要Contributor或Kubernetes Cluster Admin角色，否则无法获取集群kubeconfig。
调整步骤顺序（可选）：将azure/setup-kubectl步骤放在aks-set-context之后执行，确保kubectl工具在获取集群上下文后完成配置。
添加调试验证：在执行kubectl apply前新增调试步骤，确认kubectl上下文是否正确指向目标AKS集群：
```
- name: Check kubectl context
  run: kubectl config get-contexts
```
执行该命令后，控制台会输出当前kubectl的上下文列表，确认目标AKS集群是否处于活跃状态。

内容的提问来源于stack exchange，提问作者Z-100