registrycn/ingress-nginx

ingress-nginx Docker镜像文档

镜像概述

ingress-nginx是Kubernetes官方提供的Ingress控制器镜像，用于管理外部流量进入Kubernetes集群。该镜像包含两个核心组件：controller（入口控制器主组件）和kube-webhook-certgen（Webhook证书生成工具），共同实现集群入口流量的路由、负载均衡、SSL/TLS终止等功能。

核心功能与特性

主要组件

• controller：Ingress控制器主组件，负责解析Ingress资源配置，实现HTTP/HTTPS流量路由、负载均衡、SSL终止、路径重写等功能。
• kube-webhook-certgen：用于生成和管理Webhook所需的TLS证书，确保Ingress控制器与Kubernetes API之间的安全通信。

核心特性

• 支持HTTP、HTTPS协议流量路由
• 提供基于路径、主机名的请求路由规则
• 支持SSL/TLS证书终止与管理
• 实现负载均衡（轮询、IP哈希等策略）
• 支持自定义请求头、响应头配置
• 与Kubernetes API无缝集成，动态更新配置

使用场景与适用范围

• Kubernetes集群入口流量管理：作为集群统一入口，处理外部客户端请求并路由至内部服务。
• 微服务架构流量控制：为微服务提供统一的入口点，实现服务暴露、路由和负载均衡。
• SSL/TLS证书管理：通过Webhook证书生成工具自动管理TLS证书，简化HTTPS配置。
• 多环境部署：适用于开发、测试、生产等不同环境的Kubernetes集群。

使用方法与配置说明

镜像路径

• 控制器组件：registry.k8s.io/ingress-nginx/controller
• Webhook证书生成组件：registry.k8s.io/ingress-nginx/kube-webhook-certgen

部署方式

通过Kubernetes YAML部署

官方推荐通过Kubernetes YAML清单部署，示例如下：

yaml
# 部署ingress-nginx控制器（简化示例）
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ingress-nginx-controller
  namespace: ingress-nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/name: ingress-nginx
  template:
    metadata:
      labels:
        app.kubernetes.io/name: ingress-nginx
    spec:
      containers:
      - name: controller
        image: ***-k8s.xuanyuan.run/ingress-nginx/controller:v1.8.2  # 替换为最新版本
        args:
        - /nginx-ingress-controller
        - --publish-service=$(POD_NAMESPACE)/ingress-nginx-controller
        - --election-id=ingress-controller-leader
        - --controller-class=k8s.io/ingress-nginx
        ports:
        - containerPort: 80
          name: http
        - containerPort: 443
          name: https

通过Helm部署

使用Helm charts部署更为便捷：

shell
# 添加ingress-nginx仓库
helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update

# 安装ingress-nginx
helm install ingress-nginx ingress-nginx/ingress-nginx --namespace ingress-nginx --create-namespace

核心配置参数

controller组件环境变量

kube-webhook-certgen使用示例

生成Webhook证书：

shell
# 生成证书并存储到Secret
kubectl run kube-webhook-certgen --image=registry.k8s.io/ingress-nginx/kube-webhook-certgen:v20231011-8b53cabe0 --rm -i --tty --restart=Never -- \
  generate --cert /etc/webhook/certs/cert.pem --key /etc/webhook/certs/key.pem --namespace ingress-nginx

注意事项

• 确保Kubernetes集群版本与ingress-nginx版本兼容（参考官方兼容性矩阵）
• 生产环境建议配置资源限制（CPU/内存）和健康检查
• 定期更新镜像版本以获取安全补丁和功能更新