容器与云原生 / 系统课时
选择 Ingress 与 Gateway API
选择 Ingress 与 Gateway API
本课解决入口技术选型问题:同样要把 HTTP 请求转发到 Kubernetes Service,什么时候继续使用 Ingress,什么时候值得采用 Gateway API。最终应能从功能表达、团队协作、生命周期和迁移成本四个维度做出可解释的选择。
学习目标
- 判断 Ingress 与 Gateway API 在表达能力上的主要差异
- 根据平台团队与应用团队的职责边界选择技术
- 识别迁移收益是否足以覆盖兼容性与运维成本
先看同一个需求的表达方式
假设需求只有一条:访问 example.com/api 的请求转发到 api-service:8080。Ingress 可以用一个资源集中表达,而 Gateway API 会把入口监听与 HTTP 路由拆开。这个差异本身并不代表谁更好,关键在于系统是否需要这种职责拆分。
下面假设集群已经存在可工作的 Ingress Controller,并配置了名为 example-ingress-class 的 IngressClass;同一命名空间中已经存在 api-service Service,并暴露 8080 端口。
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: web-ingress
spec:
ingressClassName: example-ingress-class
rules:
- host: example.com
http:
paths:
- path: /api
pathType: Prefix
backend:
service:
name: api-service
port:
number: 8080预期结果
Ingress 将 Host、Path 与后端 Service 的基本路由关系集中在一个资源中。对应的 Gateway API 使用同一个业务需求,但拆成 Gateway 与 HTTPRoute:前者描述入口和监听器,后者描述 Host、Path 与后端目标。下面假设集群中已经存在名为 example-gateway-class 的可用 GatewayClass,对应 Controller 支持 Gateway 与 HTTPRoute。
apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
name: shared-gateway
spec:
gatewayClassName: example-gateway-class
listeners:
- name: http
protocol: HTTP
port: 80
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: api-route
spec:
parentRefs:
- name: shared-gateway
hostnames:
- example.com
rules:
- matches:
- path:
type: PathPrefix
value: /api
backendRefs:
- name: api-service
port: 8080预期结果
Gateway 声明 HTTP 监听入口,HTTPRoute 关联 shared-gateway,并将 example.com/api 的请求路由到 api-service:8080。这里最重要的区别不是 YAML 行数,而是资源所有权。Ingress 通常把入口规则集中在同一种资源中;Gateway API 则允许平台团队维护 Gateway,应用团队分别维护自己的 HTTPRoute。
四个维度判断选型
功能表达是第一道门槛。Ingress 已经能够覆盖大量常见的 HTTP/HTTPS 暴露需求,适合 Host、Path 和 TLS 等规则相对直接的场景。Gateway API 通过 Gateway、HTTPRoute 等资源提供更明确、可组合的模型,当入口能力持续复杂化时,更容易承载标准化治理。
团队协作是第二道门槛。如果平台团队负责共享入口,而应用团队只维护自己的业务路由,Gateway API 的资源拆分通常更贴合这种职责模型。单一团队维护规模较小的入口配置时,Ingress 的集中表达反而可能更简单。
生命周期是第三道门槛。Ingress 仍然是稳定可用的 Kubernetes API,但其资源模型已经相对固定;Gateway API 则承载了更丰富的入口与路由能力演进。对于长期维护多团队、多应用入口的集群,后者的职责分离和扩展模型可能带来更明显的收益。
迁移成本是最后一道门槛。不要因为 Gateway API 表达能力更丰富就直接全量切换。需要确认现有 Ingress Controller、目标 Gateway Controller、证书体系、DNS、负载均衡、监控和自动化发布链路都能覆盖目标能力。
| 判断维度 | Ingress 更合适 | Gateway API 更合适 |
|---|---|---|
| 配置规模 | 简单入口、规则较少 | 多团队共享、规则持续增长 |
| 职责边界 | 同一团队维护入口和路由 | 平台与应用职责需要拆分 |
| 表达需求 | 基础 HTTP/HTTPS 路由 | 需要更清晰的路由与策略组合 |
| 迁移目标 | 稳定运行、低改造成本 | 标准化、长期治理与演进 |
不要把功能更强当成唯一答案
选型首先看当前问题。如果现有 Ingress 已经稳定,规则简单,团队也没有明显的协作边界,那么为了迁移而迁移通常没有足够收益。
相反,当平台开始维护共享入口、多个团队同时提交路由、入口能力不断扩展,或者希望把基础设施配置与应用路由解耦时,Gateway API 的资源模型会更有价值。
形成可落地的选择结论
可以按一个简单顺序做决定:先判断现有需求能否被 Ingress 清晰表达,再判断是否存在明显的平台与应用职责分离,最后评估 Gateway API 带来的长期治理收益能否覆盖迁移和运维成本。
如果三个问题的答案分别是“能”“没有”“收益有限”,继续使用 Ingress 往往更务实;如果需求越来越复杂、团队职责需要分离,并且集群已经具备成熟且满足目标能力的 Gateway API 实现,那么采用 Gateway API 才更有工程价值。