Skip to content

Ingress-nginx

Getting Started

  • install helm repository
helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update
  • create ingress-nginx namespace
kubectl create namespace ingress-nginx
  • install helm Chart
helm install -n ingress-nginx ingress-nginx ingress-nginx/ingress-nginx
  • detect installed version
POD_NAME=$(kubectl get pods -n ingress-nginx -l app.kubernetes.io/name=ingress-nginx -o jsonpath='{.items[0].metadata.name}')
kubectl exec -n ingress-nginx -it $POD_NAME -- /nginx-ingress-controller --version
  • test the ingress-nginx installation
export BASE_HOST=<your_ingress_base_host>
kubectl apply -f $(sed "s/BASE_HOST/$BASE_HOST/g" deployment.yaml)

Issue with ingress-nginx webhook

Github issue #5401

If there are errors in the ingress-nginx deployment, use the patch patch/ingress-nginx-admission.yaml for error related to validatingwebhookconfigurations.

kubectl patch -n ingress-nginx validatingwebhookconfigurations ingress-nginx-admission --patch "$(cat patch/ingress-nginx-admission.yaml)"

The other solution is to disable controller.admissionWebhooks.enabled on the helm installation.

helm upgrade -n ingress-nginx ingress-nginx ingress-nginx/ingress-nginx --set controller.admissionWebhooks.enabled=false