yelijah/ingress-nginx-controller

镜像概述

该镜像为k8s.gcr.io/ingress-nginx/controller的复刻版本，旨在解决中国网络环境下无法直接访问原镜像的问题。镜像内容与原镜像完全一致，未做任何功能或代码修改，仅调整了镜像标签以便于在中国网络环境中拉取和使用。

核心功能和特性

• 功能一致性：与原k8s.gcr.io/ingress-nginx/controller镜像功能完全一致，支持所有Ingress-NGINX控制器标准功能
• 无修改复刻：镜像内容、代码及配置逻辑未做任何调整，确保与上游版本行为一致
• 网络访问优化：解决中国网络环境下访问k8s.gcr.io仓库受限的问题，提供可直接拉取的镜像资源

使用场景和适用范围

• 中国网络环境的Kubernetes集群：适用于需要部署Ingress控制器，但无法访问k8s.gcr.io仓库的场景
• 生产/测试环境：可直接替代原Ingress-NGINX控制器镜像，用于Kubernetes集群的流量路由、负载均衡等场景
• 版本兼容：支持与原镜像相同的Kubernetes版本兼容性，可根据需求选择对应标签版本

使用方法和配置说明

镜像拉取

使用以下命令拉取镜像：

bash
docker pull [镜像仓库地址]/ingress-nginx/controller:[标签]

注：[镜像仓库地址]需替换为实际提供该复刻镜像的仓库地址，[标签]应对应原k8s.gcr.io/ingress-nginx/controller的版本标签

Kubernetes部署示例

1. 使用kubectl部署

修改官方Ingress-NGINX部署文件中的镜像配置：

yaml
# 示例：修改deployment中的镜像字段
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ingress-nginx-controller
  namespace: ingress-nginx
spec:
  template:
    spec:
      containers:
      - name: controller
        image: [镜像仓库地址]/ingress-nginx/controller:[标签]  # 替换为复刻镜像地址和标签
        # 其他配置保持不变

应用修改后的配置：

bash
kubectl apply -f modified-deployment.yaml

2. 使用Helm部署

安装Helm chart时指定复刻镜像：

bash
helm install ingress-nginx ingress-nginx/ingress-nginx \
  --namespace ingress-nginx --create-namespace \
  --set controller.image.repository=[镜像仓库地址]/ingress-nginx/controller \
  --set controller.image.tag=[标签]

注意事项

• 标签对应：复刻镜像的标签与原k8s.gcr.io/ingress-nginx/controller保持一致，选择标签时需匹配所需的原镜像版本
• 配置兼容性：所有原镜像的配置参数、环境变量及使用方式均完全适用，无需修改配置逻辑
• 更新策略：镜像会随原上游版本同步更新，确保功能与安全补丁的一致性