容器与云原生 / 系统课时

部署 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。

Ingress Controller 控制面与流量入口关系

安装前先确认 kubectl 能访问目标集群,且 Helm 已安装。下面只检查连通性和客户端版本,不修改任何资源。

bash
kubectl get nodes
helm version --short

预期输出

text
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,避免多控制器集群出现归属歧义。

bash
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

预期输出

text
NAME: traefik
NAMESPACE: ingress-system
STATUS: deployed

首次安装和后续升级的提示文字可能不同,但最终 Helm release 应为 deployed。生产环境还应固定经过验证的 Chart 版本,而不是长期跟随仓库最新版本。

检查控制器和入口地址

先确认 Deployment 已达到期望副本数,再读取入口 Service。Traefik Chart 默认会为 Web 入口创建 Service;在支持云负载均衡的集群中通常能获得外部 IP 或主机名。

bash
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"}'

预期输出

text
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 这个类由哪一种控制器实现处理。

bash
kubectl get ingressclass traefik -o jsonpath='name={.metadata.name}{"\n"}controller={.spec.controller}{"\n"}'

预期输出

text
name=traefik
controller=traefik.io/ingress-controller

如果 Deployment 已就绪、入口 Service 存在且 IngressClass 能正确读取,控制器侧的基础条件就已经满足。后续路由故障应优先检查 Ingress 的 ingressClassName、Host、Path 和后端 Service,而不是重新安装控制器。

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

目录与阅读设置

阅读设置

17

记录一个想法

部署 Ingress Controller

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

登录哪都通