hanqiangfei/ingress-nginx

ingress-nginx 镜像文档

镜像概述

ingress-nginx是基于Nginx的Kubernetes入口控制器，用于管理外部流量进入Kubernetes集群内部服务。该镜像源自quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.23.0，提供了对HTTP/HTTPS请求的路由、负载均衡、SSL终止、路径重写等核心能力，是Kubernetes集群中实现外部访问管理的关键组件。

核心功能与特性

• 流量路由：支持基于主机名、路径的HTTP/HTTPS请求路由至集群内服务
• 负载均衡：自动对后端服务实例进行负载均衡
• SSL终止：支持配置SSL证书，实现HTTPS加密通信
• 路径重写：可自定义URL路径重写规则
• 会话亲和性：支持基于Cookie的会话保持
• 请求限流：提供基本的请求限流能力
• 健康检查：对后端服务进行健康状态检查

使用场景与适用范围

• 需从集群外部访问Kubernetes内部服务的场景
• 需要对多服务实例进行负载均衡的场景
• 需配置HTTPS加密通信的生产环境
• 需要实现复杂路由规则（如基于路径、主机名的路由）的场景
• Kubernetes集群的入口流量管理与控制

使用方法与配置说明

部署方式

1. Kubernetes环境部署（推荐）

通过kubectl应用官方部署清单：

bash
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/nginx-0.23.0/deploy/mandatory.yaml
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/nginx-0.23.0/deploy/provider/cloud-generic.yaml

2. Docker直接运行（测试环境）

bash
docker run -d \
  --name ingress-nginx \
  --net=host \
  -e POD_NAME=ingress-nginx \
  -e POD_NAMESPACE=default \
  -v /var/run/docker.sock:/var/run/docker.sock \
  quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.23.0

核心配置参数

路由规则配置示例

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

yaml
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: example-ingress
spec:
  rules:
  - host: example.com
    http:
      paths:
      - path: /app1
        backend:
          serviceName: app1-service
          servicePort: 80
      - path: /app2
        backend:
          serviceName: app2-service
          servicePort: 80
  tls:
  - hosts:
    - example.com
    secretName: example-tls-secret

应用上述配置：

bash
kubectl apply -f example-ingress.yaml

注意事项

• 镜像版本为0.23.0，适用于Kubernetes 1.10+环境
• 生产环境建议通过Kubernetes Deployment或DaemonSet部署，而非直接Docker运行
• SSL证书需通过Kubernetes Secret资源管理，并在Ingress配置中引用
• 高可用部署需确保控制器在多个节点上运行，并配置适当的服务暴露方式（如NodePort、Load***）