longjianghu/ingress-nginx-controller Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

k8s.gcr.io/ingress-nginx/controller:v1.1.2 镜像文档

镜像概述

k8s.gcr.io/ingress-nginx/controller:v1.1.2 是原版的 Ingress-NGINX 控制器镜像，专为 Kubernetes 集群设计，用于管理外部流量入口。该镜像实现了 Kubernetes Ingress 资源的功能，负责将集群外部的 HTTP/HTTPS 请求路由到集群内部的服务，并提供负载均衡、SSL 终止等能力。

镜像标识变更：本镜像的 SHA256 值已从 28b11ce69e57843de44e3db6413e98d09de0f6688e33d4bd384002a44f78405c 变更为 6a18680809f9bdf7bba4092cede2b5f3ee3566fb65c1bf4cfce328c5ee94bac7。

核心功能与特性

• 流量路由：基于 Ingress 资源定义的规则（如主机名、路径、HTTP 方法等），将外部请求路由到集群内指定服务。
• SSL/TLS 终止：支持配置 SSL 证书，实现 HTTPS 加密通信，解密后将请求转发至后端服务。
• 负载均衡：对后端服务的多个 Pod 实例进行流量分发，支持加权轮询等负载均衡策略。
• 路径重写与重定向：支持 URL 路径重写、HTTP 到 HTTPS 重定向等功能。
• 请求限流：可配置基于 IP、连接数等的请求限流规则，保护后端服务。
• 健康检查：对后端服务 Pod 进行健康状态检查，自动剔除异常实例。
• 监控集成：暴露 Prometheus 指标，支持监控控制器及后端服务的运行状态。

使用场景

• Kubernetes 集群对外暴露服务：作为集群统一入口，管理所有外部访问流量。
• 多服务统一入口管理：通过单个 IP/域名暴露多个服务，简化外部访问配置。
• 生产环境 HTTPS 部署：实现 SSL 终止，保障外部通信安全。
• 流量控制与负载均衡：需要对后端服务进行流量分配、限流或健康检查的场景。

使用方法与配置说明

部署方式

Ingress-NGINX 控制器通常通过 Kubernetes 资源（如 Deployment、DaemonSet）部署，而非直接使用 docker run 命令。以下是基于 Kubernetes 的典型部署示例：

1. 使用官方 YAML 部署

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

2. 自定义配置（示例）

可通过 ConfigMap 调整控制器配置，例如修改日志级别：

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: ingress-nginx-controller
  namespace: ingress-nginx
data:
  log-level: "info"

核心配置参数

验证部署

部署完成后，可通过以下命令检查控制器 Pod 状态：

bash
kubectl get pods -n ingress-nginx

若状态为 Running，则表示部署成功。此时可创建 Ingress 资源定义路由规则，例如：

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

应用后，外部请求 http://example.com/app 将被路由到 app-service:80。