3. Nginx Ingress 控制器安装：使用 Helm 部署与配置验证

Nginx Ingress Controller 是 Kubernetes 生态中最广泛使用的 Ingress 实现之一。本章将使用 Helm 包管理器完成部署，并深入解析核心配置参数，最后通过多种手段验证安装状态。Helm 方式相比手动 YAML 部署，具备版本管理、参数化配置、一键升级/回滚等优势，是生产环境推荐方案。

3.1 前置条件与 Helm 仓库准备

在开始部署前，请确保集群满足以下条件：

• Kubernetes 集群：版本 ≥ 1.19，且集群 DNS（CoreDNS）正常运行。
• Helm 客户端：版本 ≥ 3.8.0，已初始化并具备集群管理员权限。
• 网络环境：集群节点可访问 registry.k8s.io 和 github.com 以下载镜像和 Chart。
• StorageClass（可选）：如需为 Controller 挂载持久卷，需提前配置默认 StorageClass。

添加官方 Helm 仓库并更新索引：

helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update

3.2 使用 Helm 部署 Nginx Ingress Controller

执行以下命令完成基础部署。命名空间建议使用 ingress-nginx，便于资源隔离和管理。

helm install ingress-nginx ingress-nginx/ingress-nginx \
  --namespace ingress-nginx \
  --create-namespace \
  --set controller.service.type=LoadBalancer \
  --set controller.service.externalTrafficPolicy=Local \
  --set controller.replicaCount=2

部署参数说明：

3.3 核心配置参数详解

Nginx Ingress Controller 的 Helm Chart 提供了超过 200 个可配置参数。以下按功能分类列出生产环境最常用的参数组：

3.3.1 控制器副本与资源

3.3.2 网络与服务暴露

3.3.3 安全与 TLS

3.3.4 日志与监控

3.4 验证安装状态

部署完成后，通过以下步骤逐层验证控制器是否正常工作。

3.4.1 检查 Pod 运行状态

kubectl get pods -n ingress-nginx -l app.kubernetes.io/name=ingress-nginx

预期输出：所有 Pod 处于 Running 状态，且 READY 列为 1/1。

3.4.2 检查 Service 与端点

kubectl get svc -n ingress-nginx
kubectl get endpoints -n ingress-nginx

Service 的 EXTERNAL-IP 列应显示负载均衡器 IP（云环境）或 <none>（NodePort 模式）。Endpoints 列表应与 Pod IP 一致。

3.4.3 验证准入 Webhook

kubectl get validatingwebhookconfiguration -l app.kubernetes.io/name=ingress-nginx

确认 Webhook 配置已创建，且 service 引用正确。如果 Webhook 未就绪，创建 Ingress 时会报 Internal error occurred: failed calling webhook。

3.4.4 功能验证：部署测试应用

创建一个简单的 echo 服务与 Ingress 规则，验证流量能否正确路由：

kubectl create deployment echo-server --image=registry.k8s.io/echoserver:1.10
kubectl expose deployment echo-server --port=8080 --target-port=8080

kubectl create ingress echo-ingress \
  --rule="echo.example.com/=echo-server:8080" \
  --annotation nginx.ingress.kubernetes.io/rewrite-target=/

获取 Ingress 控制器对外 IP：

export INGRESS_IP=$(kubectl get svc -n ingress-nginx ingress-nginx-controller -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
curl -H "Host: echo.example.com" http://$INGRESS_IP

如果返回包含 Hostname: echo-server 的响应，说明 Ingress 控制器安装成功且路由正常。

3.5 Nginx Ingress 控制器架构图

下图展示了 Nginx Ingress Controller 在 Kubernetes 集群中的核心组件与流量路径：

3.6 常见安装问题与排查