容器与云原生 / 系统课时
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 可以成功保存,但通常不会产生可用的外部流量入口。

请求是怎样被转发的
客户端首先访问 Controller 对外暴露的地址,请求中的 Host 和 URL Path 被 Controller 用来匹配 Ingress 规则。匹配成功后,请求被转发到规则指定的 Service,再由集群服务转发机制把流量送到对应的后端 Pod。
因此,Ingress 规则里引用的是 Service,而不是直接写 Pod IP。Pod 扩缩容后 EndpointSlice 会变化,但只要 Service 选择器仍然正确,Ingress 规则通常不需要跟着每个 Pod 地址变化。
用一个最小规则看清关联
下面是一个 Ingress 配置片段。它依赖 demo 命名空间中已存在的 web Service,以及集群中已存在且名为 web 的 IngressClass,因此不是独立部署清单。
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 写入。不同实现展示的地址格式可能不同。
kubectl get ingressclass
kubectl get ingress -n demo web预期结果
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。