在GCP中通过Kubernetes Ingress暴露Nginx到静态IP遇配置错误

我之前在GCP上配置Kubernetes Ingress时也踩过不少类似的坑，结合你的操作步骤，给你梳理一下关键问题点和修复方案：

1. 先确认基础资源是否正常运行 #

在排查Ingress之前，得先确保你的Deployment和Service是正常工作的：

• 检查Deployment和Pod状态，确认所有Pod都处于Running状态：

  kubectl get deployments
  kubectl get pods
  

• 验证Service的端口配置，确保targetPort和Nginx容器暴露的端口（默认是80）完全一致：

  kubectl get svc <你的服务名称>
  

2. 修复Ingress的API版本问题 #

你提到使用了extensions/v1beta1的API版本，这个版本早在Kubernetes 1.22版本就被弃用了，必须改用当前标准的networking.k8s.io/v1，这是很多配置错误的根源。

正确的GCP Ingress YAML示例 #

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx-ingress
  annotations:
    # 指定提前创建好的GCP全局静态IP名称
    kubernetes.io/ingress.global-static-ip-name: "你的全局静态IP名称"
    # 指定使用GCP原生Ingress控制器
    kubernetes.io/ingress.class: "gce"
    # 可选：绑定自定义健康检查配置（如果默认健康检查失败的话）
    cloud.google.com/backend-config: '{"default": "nginx-backend-config"}'
spec:
  rules:
  - http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: <你的服务名称>
            port:
              number: <服务端口> # 对应Service的port字段，不是targetPort

3. GCP静态IP的正确配置逻辑 #

要把静态IP绑定到Ingress，必须满足两个核心条件：

• 静态IP必须是全局类型的，不能用区域IP。创建全局IP的命令：

  gcloud compute addresses create 你的全局静态IP名称 --global
  

• 在Ingress的metadata.annotations里指定IP的名称，而不是直接写IP地址。

4. 排查健康检查失败的常见问题 #

GCP Ingress依赖GCP负载均衡的健康检查，如果健康检查失败，Ingress会完全无法转发流量，这是最容易被忽略的点：

• 如果你的Nginx根路径/没有返回200状态码，需要自定义健康检查路径。先创建一个BackendConfig资源：

  apiVersion: cloud.google.com/v1
  kind: BackendConfig
  metadata:
    name: nginx-backend-config
  spec:
    healthCheck:
      checkIntervalSec: 10
      timeoutSec: 5
      healthyThreshold: 2
      unhealthyThreshold: 3
      type: HTTP
      requestPath: /healthz # 确保Nginx配置了这个路径并返回200
  

• 然后在Ingress的注解中引用这个BackendConfig（如上面的YAML示例所示）。

5. 查看Ingress的状态和事件排查问题 #

如果还是遇到配置错误，通过以下命令获取详细信息：

• 查看Ingress的IP分配情况：

  kubectl get ingress
  

• 查看Ingress的事件日志和错误详情：

  kubectl describe ingress nginx-ingress
  

• 也可以登录GCP控制台，查看负载均衡器的状态，那里会显示更具体的错误（比如IP绑定失败、后端服务不健康等）。

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