容器与云原生 / 系统课时

选择 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 端口。

yaml
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

预期结果

text
Ingress 将 Host、Path 与后端 Service 的基本路由关系集中在一个资源中。

对应的 Gateway API 使用同一个业务需求,但拆成 Gateway 与 HTTPRoute:前者描述入口和监听器,后者描述 Host、Path 与后端目标。下面假设集群中已经存在名为 example-gateway-class 的可用 GatewayClass,对应 Controller 支持 Gateway 与 HTTPRoute。

yaml
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

预期结果

text
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 才更有工程价值。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

选择 Ingress 与 Gateway API

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通