kubernetes-handbook/manifests/nginx-ingress/README.md

8.3 KiB

nginx-ingress

nginx-ingress is an Ingress controller that uses ConfigMap to store the nginx configuration.

To use, add the kubernetes.io/ingress.class: nginx annotation to your Ingress resources.

TL;DR;

$ helm install stable/nginx-ingress

Introduction

This chart bootstraps an nginx-ingress deployment on a Kubernetes cluster using the Helm package manager.

Prerequisites

  • Kubernetes 1.4+ with Beta APIs enabled

Installing the Chart

To install the chart with the release name my-release:

$ helm install --name my-release stable/nginx-ingress

The command deploys nginx-ingress on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.

Tip: List all releases using helm list

Uninstalling the Chart

To uninstall/delete the my-release deployment:

$ helm delete my-release

The command removes all the Kubernetes components associated with the chart and deletes the release.

Configuration

The following tables lists the configurable parameters of the nginx-ingress chart and their default values.

Parameter Description Default
controller.name name of the controller component controller
controller.image.repository controller container image repository gcr.io/google_containers/nginx-ingress-controller
controller.image.tag controller container image tag 0.9.0-beta.15
controller.image.pullPolicy controller container image pull policy IfNotPresent
controller.config nginx ConfigMap entries none
controller.hostNetwork If the nginx deployment / daemonset should run on the host's network namespace false
controller.defaultBackendService default 404 backend service; required only if defaultBackend.enabled = false ""
controller.electionID election ID to use for the status update ingress-controller-leader
controller.ingressClass name of the ingress class to route through this controller nginx
controller.scope.enabled limit the scope of the ingress controller false (watch all namespaces)
controller.scope.namespace namespace to watch for ingress "" (use the release namespace)
controller.extraArgs Additional controller container arguments {}
controller.kind install as Deployment or DaemonSet Deployment
controller.tolerations node taints to tolerate (requires Kubernetes >=1.6) []
controller.nodeSelector node labels for pod assignment {}
controller.podAnnotations annotations to be added to pods {}
controller.replicaCount desired number of controller pods 1
controller.resources controller pod resource requests & limits {}
controller.service.annotations annotations for controller service {}
controller.publishService.enabled if true, the controller will set the endpoint records on the ingress objects to reflect those on the service false
controller.publishService.pathOverride override of the default publish-service name ""
controller.service.clusterIP internal controller cluster service IP ""
controller.service.externalIPs controller service external IP addresses []
controller.service.loadBalancerIP IP address to assign to load balancer (if supported) ""
controller.service.loadBalancerSourceRanges list of IP CIDRs allowed access to load balancer (if supported) []
controller.service.targetPorts.http Sets the targetPort that maps to the Ingress' port 80 80
controller.service.targetPorts.https Sets the targetPort that maps to the Ingress' port 443 443
controller.service.type type of controller service to create LoadBalancer
controller.service.nodePorts.http If controller.service.type is NodePort and this is non-empty, it sets the nodePort that maps to the Ingress' port 80 ""
controller.service.nodePorts.https If controller.service.type is NodePort and this is non-empty, it sets the nodePort that maps to the Ingress' port 443 ""
controller.stats.enabled if true, enable "vts-status" page & Prometheus metrics false
controller.stats.service.annotations annotations for controller stats service {}
controller.stats.service.clusterIP internal controller stats cluster service IP ""
controller.stats.service.externalIPs controller service stats external IP addresses []
controller.stats.service.loadBalancerIP IP address to assign to load balancer (if supported) ""
controller.stats.service.loadBalancerSourceRanges list of IP CIDRs allowed access to load balancer (if supported) []
controller.stats.service.type type of controller stats service to create ClusterIP
defaultBackend.name name of the default backend component default-backend
defaultBackend.image.repository default backend container image repository gcr.io/google_containers/defaultbackend
defaultBackend.image.tag default backend container image tag 1.3
defaultBackend.image.pullPolicy default backend container image pull policy IfNotPresent
defaultBackend.extraArgs Additional default backend container arguments {}
defaultBackend.tolerations node taints to tolerate (requires Kubernetes >=1.6) []
defaultBackend.nodeSelector node labels for pod assignment {}
defaultBackend.podAnnotations annotations to be added to pods {}
defaultBackend.replicaCount desired number of default backend pods 1
defaultBackend.resources default backend pod resource requests & limits {}
defaultBackend.service.annotations annotations for default backend service {}
defaultBackend.service.clusterIP internal default backend cluster service IP ""
defaultBackend.service.externalIPs default backend service external IP addresses []
defaultBackend.service.loadBalancerIP IP address to assign to load balancer (if supported) ""
defaultBackend.service.loadBalancerSourceRanges list of IP CIDRs allowed access to load balancer (if supported) []
defaultBackend.service.type type of default backend service to create ClusterIP
rbac.create If true, create & use RBAC resources false
rbac.serviceAccountName ServiceAccount to be used (ignored if rbac.create=true) default
statsExporter.name name of the Prometheus metrics exporter component stats-exporter
statsExporter.image.repository Prometheus metrics exporter container image repository sophos/nginx-vts-exporter
statsExporter.image.tag Prometheus metrics exporter image tag v0.6
statsExporter.image.pullPolicy Prometheus metrics exporter image pull policy IfNotPresent
statsExporter.endpoint path at which Prometheus metrics are exposed /metrics
statsExporter.extraArgs Additional Prometheus metrics exporter container arguments {}
statsExporter.metricsNamespace namespace used for metrics labeling nginx
statsExporter.statusPage URL of "vts-stats" page exposed by controller http://localhost:18080/nginx_status/format/json
statsExporter.resources Prometheus metrics exporter resource requests & limits {}
statsExporter.service.annotations annotations for Prometheus metrics exporter service {}
statsExporter.service.clusterIP cluster IP address to assign to service ""
statsExporter.service.externalIPs Prometheus metrics exporter service external IP addresses []
statsExporter.service.loadBalancerIP IP address to assign to load balancer (if supported) ""
statsExporter.service.loadBalancerSourceRanges list of IP CIDRs allowed access to load balancer (if supported) []
statsExporter.service.servicePort Prometheus metrics exporter service port 9913
statsExporter.service.type type of Prometheus metrics exporter service to create ClusterIP
tcp TCP service key:value pairs {}
udp UDP service key:value pairs {}
$ helm install stable/nginx-ingress --name my-release \
    --set controller.stats.enabled=true

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,

$ helm install stable/nginx-ingress --name my-release -f values.yaml

Tip: You can use the default values.yaml