容器与云原生 / 系统课时
部署 Ingress Controller
部署 Ingress Controller
本节完成一个可用的 Ingress Controller 安装,并把验证重点放在三件事上:控制器 Pod 是否就绪、入口 Service 是否可达、IngressClass 是否能被后续 Ingress 正确引用。
学习目标
- 使用 Helm 安装 Traefik Ingress Controller
- 检查控制器 Deployment、入口 Service 与外部地址
- 验证
IngressClass名称和控制器标识
看清控制面与数据面
Ingress 资源本身不会监听 80 或 443 端口。Traefik 持续监听 Kubernetes API 中属于自己的 Ingress,生成路由配置;真正的业务流量则从入口 Service 到 Traefik Pod,再转发到后端 Service 和 Pod。

安装前先确认 kubectl 能访问目标集群,且 Helm 已安装。下面只检查连通性和客户端版本,不修改任何资源。
kubectl get nodes
helm version --short预期输出
NAME STATUS ROLES AGE VERSION
<NODE> Ready <ROLE> <TIME> <VERSION>
v<VERSION>+g<ID>节点名、版本和时间会因环境不同而变化;关键是节点处于 Ready,且 Helm 命令正常返回版本。
使用 Helm 安装 Traefik
本课把控制器安装到独立的 ingress-system 命名空间,并显式创建名为 traefik 的 IngressClass。它不会被设置为默认类,因此后续 Ingress 应明确填写 spec.ingressClassName: traefik,避免多控制器集群出现归属歧义。
helm repo add traefik https://traefik.github.io/charts --force-update
helm repo update
helm upgrade --install traefik traefik/traefik \
--namespace ingress-system \
--create-namespace \
--wait \
--set ingressClass.enabled=true \
--set ingressClass.name=traefik \
--set ingressClass.isDefaultClass=false \
--set providers.kubernetesIngress.enabled=true \
--set providers.kubernetesIngress.ingressClass=traefik预期输出
NAME: traefik
NAMESPACE: ingress-system
STATUS: deployed首次安装和后续升级的提示文字可能不同,但最终 Helm release 应为 deployed。生产环境还应固定经过验证的 Chart 版本,而不是长期跟随仓库最新版本。
检查控制器和入口地址
先确认 Deployment 已达到期望副本数,再读取入口 Service。Traefik Chart 默认会为 Web 入口创建 Service;在支持云负载均衡的集群中通常能获得外部 IP 或主机名。
kubectl get deployment traefik -n ingress-system
kubectl get service traefik -n ingress-system -o jsonpath='type={.spec.type}{"\n"}clusterIP={.spec.clusterIP}{"\n"}external={.status.loadBalancer.ingress[0].ip}{.status.loadBalancer.ingress[0].hostname}{"\n"}'预期输出
NAME READY UP-TO-DATE AVAILABLE AGE
traefik 1/1 1 1 <TIME>
type=LoadBalancer
clusterIP=<IP>
external=<VALUE>external 为空并不一定表示控制器故障。kind、minikube 或没有 LoadBalancer 实现的裸机集群常常不会自动分配外部地址,此时应通过本地负载均衡方案、NodePort 或临时端口转发提供可达入口。
验证 IngressClass
最后检查 IngressClass 是否存在,并确认它声明的控制器是 Traefik。名称决定 Ingress 如何选类,spec.controller 则告诉 Kubernetes 这个类由哪一种控制器实现处理。
kubectl get ingressclass traefik -o jsonpath='name={.metadata.name}{"\n"}controller={.spec.controller}{"\n"}'预期输出
name=traefik
controller=traefik.io/ingress-controller如果 Deployment 已就绪、入口 Service 存在且 IngressClass 能正确读取,控制器侧的基础条件就已经满足。后续路由故障应优先检查 Ingress 的 ingressClassName、Host、Path 和后端 Service,而不是重新安装控制器。