容器与云原生 / 系统课时

配置 HTTPRoute

配置 HTTPRoute

HTTPRoute 把 HTTP 请求的 Host、Path 等匹配条件与后端 Service 关联起来。本课用一个最小配置完成 Gateway → HTTPRoute → Service 路由,并通过 Route 状态与实际请求确认它已被 Listener 接受、后端引用有效且数据面能够转发。

学习目标

  • 配置 HTTPRoute 的 parentRefs、hostnames、matches 与 backendRefs
  • 理解请求从 Gateway Listener 到 Service 后端的匹配过程
  • 使用资源状态与实际请求验证 HTTPRoute 是否真正生效

HTTPRoute 如何接入 Gateway

HTTPRoute 本身不监听网络端口,而是通过 spec.parentRefs 请求挂载到 Gateway。目标 Listener 允许该类型、Namespace 与 Hostname 的 Route 后,请求会先按 Hostname 选择可用 HTTPRoute,再按规则中的 Path 等条件匹配,最后转发到 backendRefs 指向的后端。

Gateway、HTTPRoute 与 Service 的请求路由关系

hostnames 限定 HTTP Host,matches 描述规则内的匹配条件,backendRefs 声明匹配成功后的后端。一个 HTTPRoute 可以包含多条 rules;条件重叠时会进入规范定义的匹配优先级,因此生产配置应尽量保持规则边界清晰。

配置 Host、Path 与后端

下面假设 default Namespace 中已经存在 web-gateway Gateway 和 api Service。Gateway 至少有一个允许 default Namespace 中 HTTPRoute 挂载、且 Hostname 与 app.example.com 有交集的 HTTP Listener;api Service 暴露端口 8080。

yaml
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: api-route
  namespace: default
spec:
  parentRefs:
    - name: web-gateway
  hostnames:
    - app.example.com
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /api
      backendRefs:
        - name: api
          port: 8080

这里的 backendRefs.name 必须明确写为 api,否则就没有可解析的 Service 引用;backendRefs.port 填写 Service 暴露的端口,Service 再通过自身的 targetPort 把流量转发到 Pod。PathPrefix 按完整路径段匹配,所以 /api、/api/ 和 /api/v1 会命中,而 /apix 不会命中。

保存为 route.yaml 后应用并确认资源存在:

bash
kubectl apply -f route.yaml
kubectl get httproute api-route -o name

预期输出:

text
httproute.gateway.networking.k8s.io/api-route created
httproute.gateway.networking.k8s.io/api-route

资源已存在时,第一行也可能是 configured 或 unchanged;第二行仍应返回该 HTTPRoute 的资源名。

验证控制器是否接受路由

API Server 接受对象不代表数据面已经可用。Gateway API 控制器会在 status.parents[].conditions 中记录该 Route 相对父级的状态,应重点确认 Accepted=True 与 ResolvedRefs=True。

bash
kubectl get httproute api-route -o yaml

预期结果的对应父级状态中应能看到这两个条件;控制器名称、时间戳和其他条件会因实现不同而变化:

text
status:
  parents:
  - conditions:
    - type: Accepted
      status: "True"
    - type: ResolvedRefs
      status: "True"

Accepted=False 时先检查 Listener 协议、Hostname 交集和 allowedRoutes;ResolvedRefs=False 时先检查 Service 名称、端口,以及跨 Namespace 后端引用是否具备 ReferenceGrant 授权。

验证实际请求

取得 Gateway 对外地址后,显式设置 Host 发起请求。将 <GATEWAY_ADDRESS> 替换为当前 Gateway 实际可访问的 IP 或域名;实际地址会因环境不同而变化。

bash
curl -i -H 'Host: app.example.com' http://<GATEWAY_ADDRESS>/api

如果示例中的 api 后端约定 /api 返回 200,预期结果开头应类似:

text
HTTP/1.1 200 OK
...

若相同地址访问 /other 且没有其他 Route 接管,请求不会命中这里的 /api 规则。排查 HTTPRoute 时应把“资源已创建”“Route 已接受”“后端引用已解析”和“实际请求成功”分开验证,避免只看到 kubectl apply 成功就判断路由已经可用。

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

目录与阅读设置

记录一个想法

配置 HTTPRoute

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

登录哪都通