easyyun/ingress-nginx-controller

registry.k8s.io/ingress-nginx/controller:v1.5.1 镜像文档

镜像概述

registry.k8s.io/ingress-nginx/controller:v1.5.1 是 Kubernetes 官方提供的 Ingress 控制器镜像，基于 Nginx 构建，用于在 Kubernetes 集群中实现入口流量管理。该镜像遵循 Kubernetes Ingress API 规范，能够将外部请求路由到集群内部服务，并提供负载均衡、SSL 终止、路径重写等核心功能。

核心功能与特性

• HTTP/HTTPS 路由：支持基于主机名、路径的请求路由，可配置复杂的路由规则
• 负载均衡：内置负载均衡能力，支持轮询、IP 哈希等负载均衡策略
• SSL/TLS 终止：支持配置 SSL 证书，实现 HTTPS 加密通信
• 路径重写与重定向：支持 URL 路径重写、HTTP 到 HTTPS 重定向等功能
• 健康检查：集成服务健康检查机制，自动隔离异常后端服务
• 指标监控：暴露 Prometheus 格式的监控指标，支持集群流量监控
• 可扩展性：支持自定义 Nginx 配置，满足复杂场景需求

使用场景与适用范围

• Kubernetes 集群入口管理：作为集群统一入口，处理外部流量
• 多服务路由：在单一集群中托管多个服务时，通过域名或路径区分不同服务
• HTTPS 加密：为集群内服务提供 HTTPS 访问能力
• 生产环境部署：v1.5.1 为稳定版本，适合生产环境使用

使用方法与配置说明

部署方式

通过 kubectl 部署

推荐使用官方提供的 YAML 配置文件部署：

bash
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.5.1/deploy/static/provider/cloud/deploy.yaml

核心配置参数

通过 ConfigMap 或命令行参数配置控制器行为，关键参数包括：

示例 Ingress 资源配置

创建基本的 HTTP 路由规则：

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: minimal-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
  - host: example.com
    http:
      paths:
      - path: /app1
        pathType: Prefix
        backend:
          service:
            name: app1-service
            port:
              number: 80

启用 HTTPS

通过 Secret 配置 SSL 证书：

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: tls-ingress
spec:
  ingressClassName: nginx
  tls:
  - hosts:
    - example.com
    secretName: example-tls-secret
  rules:
  - host: example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: web-service
            port:
              number: 80

监控配置

控制器默认暴露监控指标端口 ***，可通过 Prometheus 采集：

yaml
apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: ingress-nginx-controller
spec:
  selector:
    matchLabels:
      app.kubernetes.io/component: controller
      app.kubernetes.io/instance: ingress-nginx
  endpoints:
  - port: metrics
    interval: 15s

版本信息

• 镜像版本：v1.5.1
• 基础镜像：Nginx
• 支持的 Kubernetes 版本：1.24+