「INGRESS-NGINX-CONTROLLER」- 通过 Helm 部署

Kubernetes 1.30 / Ingress-NGINX v1.12.1 / Helm Chart 4.12.1 / without Load Balancer

# 04/10/2025

helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx/
helm repo update

helm search repo --versions ingress-nginx/ | grep 1.12.1
helm pull ingress-nginx/ingress-nginx --version 4.12.1

helm show values ./ingress-nginx-x.x.x.tgz > ingress-nginx-x.x.x.helm-values.yaml
vim ingress-nginx-x.x.x.helm-values.yaml
... Image Repository and Image Tag
... controller.service.enable: false
... controller.service.externalTrafficPolicy: "Local"
... controller.hostPort.enabled: true

helm upgrade --install --create-namespace --namespace ingress-nginx                              \
    ingress-nginx ./ingress-nginx-x.x.x.tgz -f ingress-nginx.helm-values.yaml

注 1，环境复杂多变，如上配置仅适用于我们的环境。如若应用到其他环境中，可能需要按需调整其他配置。

通过 bitnami 仓库

Ingress object is binding to wrong IP address · Issue #5562 · kubernetes/ingress-nginx · GitHub

# helm search repo bitnami/nginx-ingress-controller
NAME                                    CHART VERSION   APP VERSION     DESCRIPTION                                       
bitnami/nginx-ingress-controller        9.3.2           1.3.0           NGINX Ingress Controller is an Ingress controll...

# helm pull bitnami/nginx-ingress-controller                                    # nginx-ingress-controller-9.3.2.tgz

helm show values ./nginx-ingress-controller-9.3.2.tgz > nginx-ingress-controller-9.3.2.helm-values.yaml
...（1）publishService.enabled: true，以使 Ingress 显示正确地址；

helm --namespace ingress-nginx                                                 \
    install ingress-nginx ./nginx-ingress-controller-9.3.2.tgz                 \
    -f nginx-ingress-controller-9.3.2.helm-values.yaml                         \
    --create-namespace

helm --namespace ingress-nginx                                                 \
    upgrade ingress-nginx ./nginx-ingress-controller-9.3.2.tgz                 \
    -f nginx-ingress-controller-9.3.2.helm-values.yaml

Kubernetes 1.28 / Ingress-NGINX v1.11.1 / Helm Chart 4.11.1 / with Load Balancer

1）拉取镜像并上传自建镜像仓库；
2）通过 helm template 命令，生成 YAML 文件，并修改其中的镜像地址；
3）通过 kubectl 命令，完成 NGINX Ingress Controller 的部署；

Kubernetes 1.28 → Ingress-NGINX v1.11.1 / Helm Chart 4.11.1 # 08/09/2024

按照官方文档（Installation Guide）说明，通过如下命令来部署即可：

# --------------------------------------------------------- // 官方提供的安装过程

helm upgrade --install ingress-nginx ingress-nginx \
  --repo https://kubernetes.github.io/ingress-nginx \
  --namespace ingress-nginx --create-namespace

# --------------------------------------------------------- // 我们使用的安装过程

helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update

helm search repo --versions ingress-nginx/
helm pull ingress-nginx/ingress-nginx --version 4.3.0
helm show values ./ingress-nginx-4.3.0.tgz > ingress-nginx.helm-values.yaml

helm upgrade --install --create-namespace                  \
    --namespace ingress-nginx                              \
    ingress-nginx ./ingress-nginx-4.3.0.tgz -f ingress-nginx.helm-values.yaml

若要部署多个 Nginx Ingress Controller 实例，需要修改：

controller.ingressClassResource.name: nginx-backend

controller.ingressClassResource.controllerValue: k8s.io/ingress-nginx-backend

仓库无法访问

https://kubernetes.github.io/ingress-nginx

所以我们需要手动下载 Chart 并在本地进行安装，而无法在线安装；

镜像无法拉取

镜像默认为 registry.k8s.io 仓库，而我们的环境是无法访问的。

所以，我们预先将镜像提交到自建的镜像仓库，以使 Kubernetes 环境能够拉取镜像。

镜像摘要变化

Where can I find the sha256 code of a docker image? – Stack Overflow
go-containerregistry/crane.md at main · google/go-containerregistry · GitHub

当我们使用自建镜像仓库时，我们又遇到另外的问题：
1）当 docker tag 后，不同仓库地址的 Digest 不同。通过 docker inspect --format='{{index .RepoDigests 0}}' $IMAGE 会发现多个摘要；
2）当推送镜像后，将仅保留当前仓库的 Digest 信息；
3）而在 NGINX Ingress Controller 的 Chart 中，默认使用原始仓库的 Digest 来拉取镜像，进而导致镜像拉取失败；

通过 crane cp 命令，能够解决该问题：

./crane cp \
    registry.k8s.io/ingress-nginx/controller:v1.2.1  \
    registry.example.com/ingress-nginx/controller:v1.2.1

Filed under: K4NZDROID - @ 8:19 PM