GCP K8S 创建 Ingress

前提：已完成 GCP K8s 部署指南 中的 Deployment 和 Service 创建。

1. Ingress 是什么

一个 Ingress 由三部分组成：

An Ingress has 3 parts:

1. Backend configuration — 选择后端 Kubernetes Service
2. Host and path rules — 主机名和路径的转发规则
3. Forwarding rules — 前端协议和证书配置

2. 进入 Ingress 页面

左侧子菜单 → Services & Ingress → 顶部切换到 「Ingress」 标签页 → 点 「Create Ingress」。

3. 选择入站流量类型

点击「Create Ingress」后，首先弹出类型选择：

选「外部 HTTP/S 负载均衡器」，点 「Continue」。

4. 创建 Ingress 主表单

选择类型后进入主表单。页面左侧是配置区，由上到下排列所有配置项。

4.1 基本信息

• 入站流量类型：上一步选择，不可修改
• 名称：建议 {主 Deployment 名}-ingress，如 backend-ingress。好处是资源列表里 backend / backend-ingress / backend-service 排在一起

4.2 Backend configuration（后端配置）

选择要作为后端的 Kubernetes Service：

点「添加后端服务」，下拉选择你之前创建的 Service。选中后表格显示：名称、端口、当前健康的 Pod 数量、所在集群。如果 Pod 数量为 0，说明 Service 没有关联到健康的 Pod，需要回去检查 Deployment。

4.3 Host and path rules（主机和路径规则）

这是最核心的一步：定义域名和路径的转发规则。

• 主机（Host）：域名，每行填同一个域名
• 路径（Path）：类似 Nginx 的 location。/* 匹配所有路径，/api/* 匹配 API 请求。路径越长越优先，和顺序无关
• 后端 Kubernetes 服务：下拉选 Backend configuration 里已添加的 Service
• 第一行是默认服务：不匹配任何规则的流量走第一行。所以第一行放前端（/* → frontend-service）作为兜底

路由匹配示例：

/api/users → /* 和 /api/* 都匹配 → /api/* 更具体 → 走后端
/login    → 只有 /* 匹配         → 走前端

4.4 Frontend configuration（前端配置）

配置协议和 HTTPS 证书：

• 协议：下拉选 HTTPS。同时显示 HTTP 和 HTTPS 各自的 IP（自动分配）和端口（HTTP=80, HTTPS=443）
• 证书：选「Create a new Google-managed certificate」，Google 自动申请 Let's Encrypt 免费证书并到期自动续期
• 证书名称：填证书绑定的域名，和 Host and path rules 里的主机名一致
• 证书创建后显示「Provisioning」，等 DNS 指向生效后 Google 完成验证

4.5 Preview setup and YAML

点击前的按钮：

点击后展开预览面板，有两个标签页：

对ingress加入前端服务

spec:
  defaultBackend:
    service:
      name: web-service
      port:
        number: 80
  rules:
  - http:
      paths:
      - backend:
          service:
            name: backend-service
            port:
              number: 80
        path: /api/*
        pathType: ImplementationSpecific
  - host: tmp-domain.com
    http:
      paths:
      - backend:
          service:
            name: backend-service
            port:
              number: 80
        path: /api/*
        pathType: ImplementationSpecific
      - backend:
          service:
            name: web-service
            port:
              number: 80
        pathType: ImplementationSpecific
  tls:
  - secretName: 名

INGRESS 详情按三部分排列：前端（协议/端口/证书）→ 主机和路径规则 → 后端 Kubernetes 服务（含每个 Pod 的状态和重启次数）。确认无误后关闭预览，回到主表单点 CREATE。

4.6 创建

核对配置：

确认无误，点底部的 「CREATE」。

相关文档

• GCP K8s 部署服务 — 入口导航、项目选择、集群选择
• GCP-K8s-部署Deployment — 创建 Deployment 和暴露 Service
• GCP-K8s-部署Ingress.md — UI 操作版 Ingress 完整配置