容器与云原生 / 系统课时

配置 Path 路由

配置 Path 路由

本课解决“同一个 Host 下,不同 URL 路径如何进入不同 Service”的问题。你将用 Prefix 与 Exact 配置路径规则,并通过重叠路径验证具体请求会命中哪个后端,从而避免路径设计互相覆盖。

学习目标

  • 能区分 Prefix 与 Exact 的匹配语义
  • 能配置同一 Host 下的多条 Path 规则
  • 能根据请求 URL 判断实际会命中哪条规则

Prefix 与 Exact 的差异

Exact 要求请求路径与配置值完全一致。例如规则 /login 匹配 /login,但不匹配 /login/extra。Prefix 按以 / 分隔的路径元素进行前缀匹配,例如 /api 可以匹配 /api、/api/ 和 /api/users,但不会把 /apix 当作 /api 的子路径。

当同一 Host 下存在多条可匹配规则时,不应按 YAML 的书写顺序猜测结果。Ingress 规则优先选择更长的匹配路径;如果匹配路径长度相同,则 Exact 优先于 Prefix。因此应把业务上更具体的路径显式写出来,而不是依赖规则排列顺序。

Ingress Prefix 与 Exact 路径匹配对比

配置多条路径

下面把 /api 交给 api Service,把 /login 精确交给 login Service,其余路径交给 frontend Service。假设三个 Service 都位于 default Namespace,并暴露 80 端口。

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo-path-routing
spec:
  ingressClassName: nginx
  rules:
    - host: app.example.test
      http:
        paths:
          - path: /api
            pathType: Prefix
            backend:
              service:
                name: api
                port:
                  number: 80
          - path: /login
            pathType: Exact
            backend:
              service:
                name: login
                port:
                  number: 80
          - path: /
            pathType: Prefix
            backend:
              service:
                name: frontend
                port:
                  number: 80

将配置保存为 path-routing.yaml 后应用:

bash
kubectl apply -f path-routing.yaml

预期输出

text
ingress.networking.k8s.io/demo-path-routing created

如果该 Ingress 已存在,输出可能显示为 configured 或 unchanged。这里的 / 是兜底 Prefix,而 /api 与 /login 是更具体的业务路径;兜底规则写在前后都不会改变规范定义的匹配优先级。

验证匹配结果

使用相同 Host,只改变 URL 路径。<IP> 替换为 Ingress Controller 的实际入口 IP 或可访问地址。

bash
curl -H 'Host: app.example.test' http://<IP>/
curl -H 'Host: app.example.test' http://<IP>/api
curl -H 'Host: app.example.test' http://<IP>/api/users
curl -H 'Host: app.example.test' http://<IP>/login
curl -H 'Host: app.example.test' http://<IP>/login/extra

预期结果

text
<frontend-service response>
<api-service response>
<api-service response>
<login-service response>
<frontend-service response>

实际响应正文取决于各 Service 后端应用。/api/users 命中 /api 的 Prefix;/login/extra 不满足 /login 的 Exact,因此由 / 的 Prefix 接管。这也说明 Path 匹配不是简单的字符串开头比较,而是由 pathType 定义具体语义。

处理重叠路径与未命中问题

不要用 /app 的 Prefix 模拟“只允许一个固定 URL”。只匹配单一路径时使用 Exact;需要覆盖该路径及其子路径时使用 Prefix。如果同一 Host 下还有 /api/admin 这样的规则,它会因为匹配路径更长而优先于 /api。

还要注意,路径改写不是 Ingress 核心 Path 匹配语义本身。某些 Ingress Controller 可以通过注解或其他扩展能力修改转发给上游的路径,但这是具体控制器的行为,不应与 pathType 的匹配规则混为一谈。

当配置看似正确却没有进入预期后端时,按“Host 是否匹配 → Path 是否匹配 → Service 是否存在 → Endpoint 是否可用”的顺序检查。这样可以先确认请求是否选中了正确规则,再判断问题是否已经进入 Service 和后端可用性层面。

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

目录与阅读设置

记录一个想法

配置 Path 路由

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

登录哪都通