容器与云原生 / 系统课时

Ingress 工作原理

Ingress 工作原理

Ingress 本身只是一份“如何把 HTTP/HTTPS 流量路由到集群内 Service”的声明,不会主动接收网络流量。真正处理请求的是 Ingress Controller,而 IngressClass 用来说明这份 Ingress 应由哪类控制器接管。理解三者关系后,才能正确判断规则存在却不生效的原因。

学习目标

  • 区分 Ingress、IngressClass 和 Ingress Controller 的职责
  • 看懂从外部请求到 Service、Pod 的完整流量处理链路
  • 能验证一条 Ingress 规则是否被目标 Controller 接管并获得可访问入口

三个对象各自负责什么

Ingress 保存主机名、路径和后端 Service 等路由规则;IngressClass 描述一类 Ingress 由哪个控制器实现;Ingress Controller 则是实际运行的控制面与数据面组件,它持续监听资源变化,并把规则转成代理、负载均衡器或其他转发设施的配置。

最关键的一点是:创建 Ingress 资源不等于已经有入口能力。如果集群没有与 ingressClassName 匹配的 Controller,YAML 可以成功保存,但通常不会产生可用的外部流量入口。

Ingress 资源到后端 Pod 的流量链路

请求是怎样被转发的

客户端首先访问 Controller 对外暴露的地址,请求中的 Host 和 URL Path 被 Controller 用来匹配 Ingress 规则。匹配成功后,请求被转发到规则指定的 Service,再由集群服务转发机制把流量送到对应的后端 Pod。

因此,Ingress 规则里引用的是 Service,而不是直接写 Pod IP。Pod 扩缩容后 EndpointSlice 会变化,但只要 Service 选择器仍然正确,Ingress 规则通常不需要跟着每个 Pod 地址变化。

用一个最小规则看清关联

下面是一个 Ingress 配置片段。它依赖 demo 命名空间中已存在的 web Service,以及集群中已存在且名为 web 的 IngressClass,因此不是独立部署清单。

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: web
  namespace: demo
spec:
  ingressClassName: web
  rules:
    - host: app.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web
                port:
                  number: 80

这段配置表示:由 web 这类 Controller 处理 app.example.com,所有以 / 为前缀的请求都转发到 demo/web Service 的 80 端口。pathType: Prefix 让路径匹配语义明确,避免把实现细节留给 Controller 自行猜测。

验证是否真的被接管

先同时查看 IngressClass 和 Ingress。重点关注类名是否存在、Ingress 的 CLASS 是否符合预期,以及 ADDRESS 是否已经由 Controller 写入。不同实现展示的地址格式可能不同。

bash
kubectl get ingressclass
kubectl get ingress -n demo web

预期结果

text
NAME   CONTROLLER                       PARAMETERS   AGE
web    <CONTROLLER_NAME>                <none>       <TIME>

NAME   CLASS   HOSTS             ADDRESS   PORTS   AGE
web    web     app.example.com   <IP>      80      <TIME>

<CONTROLLER_NAME>、<IP> 和 <TIME> 都是动态值;某些实现的 ADDRESS 可能显示主机名而不是 IP。如果 IngressClass 不存在,先修正 ingressClassName 或安装对应 Controller;如果类存在但 ADDRESS 长时间为空,则查看 Controller 的 Pod 状态、事件和日志。

规则正确仍可能访问失败

Ingress 能被接管只说明入口控制器识别了规则,不代表后端一定健康。若返回 404,先确认 Host 和 Path 是否命中预期规则;若返回 502/503,优先检查 Service 是否有可用 EndpointSlice、端口是否映射正确以及后端 Pod 是否 Ready;若入口地址本身无法连接,则检查 Controller 的 Service、负载均衡器或节点暴露方式。

把控制关系和数据流分开看,排障会清楚很多:Ingress 与 IngressClass 负责“声明由谁按什么规则转发”,Ingress Controller 负责“把声明变成真实转发行为”,Service 与 EndpointSlice 再负责把请求送到最终 Pod。

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

目录与阅读设置

阅读设置

17

记录一个想法

Ingress 工作原理

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

登录哪都通