容器与云原生 / 系统课时

认识 Gateway API 核心对象

认识 Gateway API 核心对象

本课解决一个实际问题:面对 Gateway API 的多个资源,怎样判断谁负责基础设施能力、谁承载入口实例、谁负责具体路由。掌握对象之间的关系后,就能读懂一套 Gateway API 配置。

学习目标

  • 理解 GatewayClass、Gateway、HTTPRoute 的职责边界
  • 看懂三者从实现类型到入口实例再到请求路由的关系
  • 能用最小 YAML 验证对象之间的引用关系

先建立对象分工

Gateway API 不把入口配置压在一个对象里,而是拆成不同层级。最常用的三个核心对象可以理解为:GatewayClass 选择“由哪类实现提供能力”,Gateway 表示“集群里实际创建哪个入口”,HTTPRoute 表示“请求进入后怎样路由”。

GatewayClass、Gateway 与 HTTPRoute 的对象关系

其中,GatewayClass 通常由平台或基础设施团队负责。它描述一种可用的 Gateway 实现,例如某个 Gateway Controller 能识别的 class。应用团队通常不需要修改其中的底层实现细节。

Gateway 是实际使用的流量入口资源。它可以定义监听哪个地址、端口、协议,以及允许哪些 Route 与它建立关联。因此,Gateway 更接近“入口实例”,而不是具体业务路由表。

HTTPRoute 面向应用流量治理。它负责匹配 Host、Path、Header 等 HTTP 条件,并将请求转发到后端 Service。它通过 parentRefs 指定自己要挂到哪个 Gateway 上。

用最小配置看懂引用关系

下面这组 YAML 只是一个可运行的对象定义示例,具体 GatewayClass 名称取决于集群已经安装的 Gateway Controller。示例的关键不是某个厂商实现,而是三类对象之间的引用关系。

yaml
apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: web-gateway
spec:
  gatewayClassName: example-gateway-class
  listeners:
    - name: http
      protocol: HTTP
      port: 80
      allowedRoutes:
        namespaces:
          from: Same
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: web-route
spec:
  parentRefs:
    - name: web-gateway
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /
      backendRefs:
        - name: web
          port: 8080

预期结果

text
Gateway 通过 gatewayClassName 指向一个 GatewayClass 实现类型。
HTTPRoute 通过 parentRefs 关联 web-gateway。
HTTPRoute 的 backendRefs 指向 web Service 的 8080 端口。

这里没有直接在 HTTPRoute 中声明“使用哪个 Controller”。它先绑定 Gateway,而 Gateway 再通过 gatewayClassName 选择实现。这种间接关系正是 Gateway API 进行职责分离的关键。

用 kubectl 验证对象状态

创建资源后,先检查三类资源是否存在,再看 Gateway 和 HTTPRoute 的状态。实际集群必须已经安装 Gateway API CRD,并存在与示例匹配的 GatewayClass。

bash
kubectl get gatewayclass
kubectl get gateway web-gateway
kubectl get httproute web-route
kubectl describe gateway web-gateway
kubectl describe httproute web-route

预期输出

text
NAME                    CONTROLLER
example-gateway-class   <controller-name>

NAME          CLASS                   ADDRESS   PROGRAMMED
web-gateway   example-gateway-class   <IP>      True

NAME        HOSTNAMES   AGE
web-route               <TIME>

PROGRAMMED=True 表示 Gateway 已经由对应实现成功编程;HTTPRoute 是否真正可用,则还要结合它的 Accepted、ResolvedRefs 等状态条件判断。不同 Controller 的附加状态信息可能不同,不能只看资源是否创建成功。

最容易混淆的边界

GatewayClass 不是每个应用都要创建的“路由类”;它更像平台层提供的实现入口。Gateway 也不是 HTTPRoute 的别名:Gateway 解决入口监听与接入边界,HTTPRoute 解决请求匹配和后端转发。

实际协作时,一个 Gateway 可以承载多个 Route,而一个 Route 也可以根据规则与策略绑定到合适的 Gateway。这样就能把共享入口能力与业务路由配置拆开,让平台团队和应用团队分别维护自己负责的部分。

判断一套 Gateway API 配置是否清晰,可以只问三个问题:谁提供入口实现?哪个 Gateway 实际监听流量?请求进入后由哪个 Route 决定转发? 对应的答案分别落在 GatewayClass、Gateway 和具体 Route 上。

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

目录与阅读设置

记录一个想法

认识 Gateway API 核心对象

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

登录哪都通