使用GitHub Actions部署至GKE时遇gke-deployment未找到及部署异常

先抓核心错误信息再说 #

别先纠结可用区，先搞清楚到底哪里错了：

• 用kubectl describe pod <你的Pod名>查看Pod的详细事件，比如是不是镜像拉取失败、节点资源不足
• 用kubectl describe deployment <你的部署名>查看部署的调度日志，大概率能定位具体报错原因（比如镜像权限问题、可用区资源耗尽）

可用区修改的正确操作 #

如果确认是单个可用区资源不足导致的调度失败，按以下步骤调整：

1. 调整GKE节点池的可用区 #

• 进入GCP控制台的GKE集群页面，找到你使用的节点池，点击「编辑」
• 将「节点位置」从单个可用区（比如europe-west1-a）改成同区域的多个可用区（比如europe-west1-b、europe-west1-c），让调度系统能选择资源充足的节点
• 保存设置后等待节点池更新完成

2. 给Deployment添加节点亲和性（可选） #

如果需要强制Pod调度到指定可用区，在deployment.yaml的spec.template.spec下添加这段配置：

affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
      - matchExpressions:
        - key: topology.kubernetes.io/zone
          operator: In
          values:
          - europe-west1-b
          - europe-west1-c

检查你的YAML配置关键点 #

deployment.yaml检查项： #

• 镜像地址必须为europe-west1-docker.pkg.dev/<你的项目ID>/<仓库名>/<镜像名>:<标签>，不要写错区域、项目ID或仓库名
• 容器端口要和service.yaml里的targetPort完全匹配，否则服务无法正常转发流量
• 不要给Pod设置过高的CPU/内存请求值，避免因节点资源不足导致调度失败

service.yaml检查项： #

• spec.selector必须和deployment.yaml中spec.template.metadata.labels完全一致，否则服务无法关联到Pod
• 如果使用LoadBalancer类型，确认你的GKE集群拥有创建外部负载均衡器的权限（默认集群已具备，受限集群需额外检查）

GitHub Actions部署流程优化 #

在部署步骤前添加一段检查命令，确保集群连接正常，避免因集群不可用导致部署失败：

- name: 检查集群状态
  run: |
    gcloud container clusters get-credentials <你的集群名> --zone <集群所在区域> --project <你的项目ID>
    kubectl get nodes

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