winjay/ingress-nginx-controller

ingress-nginx/controller 镜像文档

镜像概述

该镜像源自 k8s.gcr.io/ingress-nginx/controller 仓库，是Kubernetes官方提供的Ingress控制器实现。作为Kubernetes集群的流量入口管理组件，它负责解析Ingress资源配置，将外部HTTP/HTTPS请求路由到集群内部服务，并提供负载均衡、SSL终止、路径重写等关键功能。

核心功能与特性

• 流量路由：基于HTTP路径、主机名等规则将外部请求转发至集群内对应服务
• SSL/TLS终止：支持配置SSL证书，实现HTTPS加密通信
• 负载均衡：内置负载均衡机制，分发流量至后端服务的多个Pod实例
• 路径重写：支持URL路径重写，灵活调整请求路由规则
• 会话亲和性：可配置会话粘性，确保特定客户端请求定向到同一后端Pod
• 健康检查：对后端服务进行健康状态检测，自动剔除异常实例

使用场景与适用范围

• Kubernetes集群入口管理：作为集群统一流量入口，管理所有外部访问
• 微服务路由：在微服务架构中，实现不同服务的请求路由与隔离
• HTTPS部署：为集群服务提供SSL/TLS加密，满足安全通信需求
• 多环境隔离：通过主机名或路径区分开发、测试、生产环境服务

使用方法与配置说明

部署方式（Kubernetes环境）

通常通过Kubernetes资源清单部署，以下是基本部署示例：

1. 命名空间创建

yaml
apiVersion: v1
kind: Namespace
metadata:
  name: ingress-nginx

2. 控制器部署（Deployment示例）

yaml
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.gcr.io/ingress-nginx/controller:v1.5.1  # 指定具体版本