laemmline/ingress-nginx-controller

镜像概述

该镜像为registry.k8s.io/ingress-nginx/controller的官方镜像，是Kubernetes生态中广泛使用的Ingress控制器实现。主要用于在Kubernetes集群中管理外部访问流量，实现从集群外部到内部服务的HTTP/HTTPS路由、负载均衡及流量控制，是连接集群内外的关键组件。

核心功能和特性

• HTTP/HTTPS路由：基于Ingress资源定义的规则，将外部请求路由至集群内指定服务
• TLS终止：支持SSL/TLS证书配置，实现HTTPS加密通信的终止与解密
• 负载均衡：在后端服务多实例间分发流量，支持轮询、IP哈希等负载均衡策略
• 路径重写与重定向：支持URL路径的重写、HTTP到HTTPS的重定向等规则配置
• 基于名称的虚拟主机：通过主机名（Host）区分不同服务，实现多域名共享入口
• 健康检查：对后端服务进行主动/被动健康检查，自动剔除异常实例
• 自定义Headers：支持添加、修改或删除请求/响应Headers

使用场景和适用范围

• Kubernetes集群外部访问管理：作为集群统一入口，暴露内部服务给外部用户或系统
• 微服务架构入口控制：在微服务环境中，集中管理多服务的路由规则与访问策略
• 生产环境流量治理：需实现TLS加密、负载均衡、路径控制的企业级应用部署
• 多团队共享集群资源：通过命名空间和Ingress规则隔离不同团队的服务访问

使用方法和配置说明

部署方式（Kubernetes环境）

通常通过官方提供的YAML配置文件部署，示例命令：

bash
# 部署最新稳定版（具体版本请参考官方文档）
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.8.2/deploy/static/provider/cloud/deploy.yaml

注意：部署前需确保集群已安装RBAC、StorageClass等依赖组件，具体部署文档参见https://kubernetes.github.io/ingress-nginx/deploy/

基本Ingress资源配置示例

创建Ingress资源定义路由规则：

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
  ingressClassName: nginx
  rules:
  - host: example.com
    http:
      paths:
      - path: /app1(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: app1-service
            port:
              number: 80
  tls:
  - hosts:
    - example.com
    secretName: example-tls-secret  # 包含TLS证书的Secret名称

配置参数与环境变量

控制器支持通过以下方式进行配置：

• ConfigMap：通过创建ingress-nginx-controller ConfigMap自定义NGINX配置（如超时时间、缓冲区大小等）
• Ingress Annotations：在Ingress资源中通过注解（Annotations）配置特定路由规则（如nginx.ingress.kubernetes.io/rewrite-target）
• 环境变量：部分基础配置可通过环境变量设置，常用变量包括：
  • NGINX_CONFIG_PARAMS：自定义NGINX主配置参数
  • POD_NAME/POD_NAMESPACE：由Kubernetes自动注入，标识当前Pod信息

更多配置详情可参考https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/