容器与云原生 / 系统课时

配置 Host 路由

配置 Host 路由

本课解决“同一个入口地址如何按域名把请求送到不同 Service”的问题。你将创建两条 Host 规则,用请求中的 Host 头触发不同后端,并通过实际请求验证命中、未命中和默认行为。

学习目标

  • 能用 Ingress 的 host 字段配置按域名路由
  • 能验证不同 Host 对应不同 Service 的匹配结果
  • 能判断 Host 不匹配时应检查的入口配置

Host 路由的匹配逻辑

Ingress 的 Host 路由先比较 HTTP 请求的 Host 与规则中的 spec.rules[].host。Host 匹配后,再在该规则下处理路径;因此,同一个 Ingress 可以把 app.example.test 和 api.example.test 分别交给不同 Service。

这里的“不同域名”不要求真实公网 DNS。实验中直接给请求设置 Host 头即可验证控制器是否按 Host 规则选择后端。

Ingress 按 Host 将请求分流到不同 Service

配置两条 Host 规则

下面的示例假设集群已安装可处理 Ingress 的控制器,并使用名为 nginx 的 IngressClass。两个 Service 都在 default Namespace 中,名称分别为 frontend 和 api,端口均为 80。

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

预期结果

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

配置中的两个 host 是独立匹配条件。app.example.test 只会进入第一条规则,api.example.test 只会进入第二条规则;两条规则都使用 /,因此本例主要演示 Host 的分流作用。

验证 Host 匹配

先查看 Ingress 是否已被控制器接管,再使用同一个入口地址发送不同 Host 的请求。<IP> 代表实际分配给 Ingress Controller 的入口地址。

bash
kubectl get ingress demo-host-routing
curl -H 'Host: app.example.test' http://<IP>/
curl -H 'Host: api.example.test' http://<IP>/
curl -H 'Host: unknown.example.test' http://<IP>/

预期结果

text
NAME                 CLASS   HOSTS                            ADDRESS   PORTS
 demo-host-routing   nginx   app.example.test,api.example.test   <IP>      80

<frontend-service response>
<api-service response>
<controller default-backend response or 404>

两次已知 Host 的响应应该分别来自 frontend 与 api。未知 Host 不应被错误路由到其中一个显式 Host 规则;具体响应可能是控制器返回的 404 或其默认后端响应,取决于控制器配置。

常见失败定位

如果 Ingress 对象已创建,但两种 Host 得到相同结果,先检查 ingressClassName 是否与实际控制器一致,再确认控制器已经读取该 Ingress。还要核对 Service 名称、端口以及后端 Endpoint 是否存在。

如果只有 Host 不匹配时失败,这是预期现象,不要先去修改 Service。此时优先检查请求实际发送的 Host 头,以及入口是否被其他 Ingress、默认规则或网关策略接管。

Host 路由的关键不是“访问了哪个 IP”,而是入口收到请求后使用哪个 Host 值进行规则匹配。验证时保持入口地址不变,只改变 Host,就能最直接地证明路由是否生效。

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

目录与阅读设置

记录一个想法

配置 Host 路由

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

登录哪都通