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

镜像概述

该镜像为Kubernetes集群提供Nginx Ingress Controller（版本0.10.2），基于quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.10.2构建。Ingress Controller作为集群的流量入口，负责接收外部请求并路由至集群内部服务，是Kubernetes服务暴露的关键组件。

核心功能与特性

• 流量路由：支持基于HTTP路径、主机名的请求路由，将外部流量分发至集群内不同服务
• 负载均衡：内置负载均衡能力，可在后端服务多副本间分配流量
• SSL/TLS终止：支持配置SSL证书，实现HTTPS加密通信
• 路径重写：可修改请求路径后转发至后端服务
• 会话亲和性：支持基于Cookie的会话保持
• 健康检查：对后端服务进行健康状态检测，自动剔除异常实例

使用场景

• Kubernetes集群对外暴露HTTP/HTTPS服务
• 需要集中管理外部流量入口策略
• 实现多服务共享同一IP和端口的场景
• 需对外部请求进行SSL终止或路径重写处理

使用方法与配置说明

部署方式（Kubernetes环境）

通常通过Kubernetes资源清单部署，示例YAML配置：

yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  name: nginx-ingress-serviceaccount
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRole
metadata:
  name: nginx-ingress-clusterrole
rules:
  - apiGroups: [""]
    resources: ["services", "endpoints", "secrets"]
    verbs: ["get", "list", "watch"]
  - apiGroups: ["extensions"]
    resources: ["ingresses"]
    verbs: ["get", "list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRoleBinding
metadata:
  name: nginx-ingress-clusterrole-nisa-binding
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: nginx-ingress-clusterrole
subjects:
  - kind: ServiceAccount
    name: nginx-ingress-serviceaccount
    namespace: kube-system
---
apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: nginx-ingress-controller
  namespace: kube-system
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: nginx-ingress-controller
    spec:
      serviceAccountName: nginx-ingress-serviceaccount
      containers:
        - name: nginx-ingress-controller
          image: quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.10.2
          args:
            - /nginx-ingress-controller
            - --default-backend-service=kube-system/default-http-backend
            - --configmap=kube-system/nginx-configuration
          ports:
            - containerPort: 80
            - containerPort: 443

关键配置参数

通过启动参数配置控制器行为，常用参数：

• --default-backend-service：指定默认后端服务，处理未匹配路由的请求
• --configmap：指定配置Ingress Controller的ConfigMap名称
• --tcp-services-configmap：配置TCP服务路由的ConfigMap
• --udp-services-configmap：配置UDP服务路由的ConfigMap
• --annotations-prefix：自定义Ingress注解前缀，默认为nginx.ingress.kubernetes.io

环境变量

镜像支持通过环境变量配置部分参数，主要包括：

• POD_NAME：当前Pod名称（通常由Kubernetes自动注入）
• POD_NAMESPACE：当前Pod所在命名空间（通常由Kubernetes自动注入）

验证部署

部署后，通过以下命令检查Pod状态：

bash
kubectl get pods -n kube-system | grep nginx-ingress-controller

创建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