容器与云原生 / 系统课时
配置入口控制器基础能力
配置入口控制器基础能力
本课以 ingress-nginx 为实验入口控制器,完成控制器部署、IngressClass 绑定和基本可用性检查。完成后,集群中的 Ingress 才有实际的控制器接管者,并能进入后续请求验证。
学习目标
- 能安装并确认 ingress-nginx Controller 正常运行。
- 能理解 IngressClass 与控制器之间的绑定关系。
- 能用 Kubernetes 对象状态和控制器日志完成基础健康检查。
选择控制器与安装方式
Ingress 本身只是规则对象,真正负责监听 Ingress、生成代理配置并处理请求的是 Ingress Controller。实验环境使用 ingress-nginx,安装方式采用 Helm,便于重复部署和调整参数。
单实例实验环境可以把 nginx IngressClass 设为默认类。这样显式使用 spec.ingressClassName: nginx 的 Ingress 会明确交给该控制器处理;默认类主要解决遗漏类名时的接管问题。
helm upgrade --install ingress-nginx ingress-nginx \
--repo https://kubernetes.github.io/ingress-nginx \
--namespace ingress-nginx \
--create-namespace \
--set controller.ingressClassResource.default=true预期结果
Release "ingress-nginx" has been installed or upgraded.
The release is deployed in namespace ingress-nginx.实际 Helm 输出会随版本变化,重点不是逐字匹配提示,而是命令成功返回且 Release 状态正常。
验证 Controller 与 IngressClass
先检查 Controller Pod。只有 Pod 已进入 Running 且 Ready,才适合继续验证入口规则。再检查 IngressClass,确认类名和控制器标识能够对应起来。
kubectl get pods -n ingress-nginx
kubectl get ingressclass nginx -o jsonpath='{.metadata.name}{" controller="}{.spec.controller}{" default="}{.metadata.annotations.ingressclass\.kubernetes\.io/is-default-class}{"\n"}'预期结果
NAME READY STATUS RESTARTS AGE
ingress-nginx-controller-<ID> 1/1 Running 0 <TIME>
nginx controller=k8s.io/ingress-nginx default=true其中 Pod 名称、年龄和实例标识会因环境不同而变化。关键检查点是 Controller 已 Ready,且 IngressClass 的 spec.controller 与 ingress-nginx 使用的控制器类一致。
建立最小接管配置
控制器安装完成后,实际的 Ingress 应显式声明 ingressClassName: nginx,不要依赖历史的 kubernetes.io/ingress.class 注解。IngressClass 是 Kubernetes 用来把 Ingress 与具体控制器关联起来的正式资源。
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: demo
namespace: default
spec:
ingressClassName: nginx
rules:
- host: demo.localdev.me
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: demo
port:
number: 80这是片段示例,前提是 default 命名空间中已经存在名为 demo、端口为 80 的 Service。它的作用是验证控制器能够识别目标 IngressClass,并获得一条可处理的入口规则。
基础故障检查
如果 Controller 一直没有 Ready,先不要排查业务 Service。优先检查 Pod 状态、事件和控制器日志;如果 Controller 正常而 Ingress 没有被处理,再检查 ingressClassName、IngressClass 和 Ingress 本身的事件。
kubectl describe pod -n ingress-nginx -l app.kubernetes.io/component=controller
kubectl logs -n ingress-nginx deployment/ingress-nginx-controller --tail=50
kubectl describe ingress demo预期结果
Pod: Ready=True
Controller log: no fatal startup error
Ingress: ingressClassName=nginx
Events: no persistent configuration error这些结果不要求日志内容逐字一致。基础能力成立的判断标准是:控制器进程正常、Ready 探针通过、目标 Ingress 使用正确的类,并且控制器没有持续报告无法解析或应用入口配置的错误。
配置入口控制器时,真正的验收点不是“Helm 命令成功”,而是形成完整的接管关系:Controller 运行 → IngressClass 指向 Controller → Ingress 指定 IngressClass。这条关系成立后,后续才能从客户端请求一路验证到入口规则和后端服务。