NGINX (pronounced "engine-x") is an open source reverse proxy server for HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer, HTTP cache, and a web server (origin server).

TL;DR;

$ helm install nginx-x.x.x.tgz

Introduction

Bitnami charts for Helm are carefully engineered, actively maintained and are the quickest and easiest way to deploy containers on a Kubernetes cluster that are ready to handle production workloads.

This chart bootstraps a NGINX deployment on a Kubernetes cluster using the Helm package manager.

Get this chart

Download the latest release of the chart from the releases page.

Alternatively, clone the repo if you wish to use the development snapshot:

$ git clone https://github.com/bitnami/charts.git

Installing the Chart

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

$ helm install --name my-release nginx-x.x.x.tgz

Replace the x.x.x placeholder with the chart release version.

The command deploys NGINX on the Kubernetes cluster in the default configuration.

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 chart and their default values.

Parameter	Description	Default
`imageTag`	`bitnami/nginx` image tag	NGINX image version
`imagePullPolicy`	Image pull policy	`IfNotPresent`
`vhost`	Custom nginx virtual host	`nil`

Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,

$ helm install --name my-release \
  --set imagePullPolicy=Always \
    nginx-x.x.x.tgz

The above command sets the imagePullPolicy to Always.

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

$ helm install --name my-release -f values.yaml nginx-x.x.x.tgz

Tip

: You can use the default values.yaml

Providing a custom virtual host

You can use the vhost value to provide a custom virtual host for NGINX to use. To do this, create a values files with your virtual host:

custom-vhost.yaml

vhost: |-
  server {
    listen 0.0.0.0:80;
    location / {
      return 200 "hello!";
    }
  }

Install the chart with this value:

$ helm install --name my-release -f custom-vhost.yaml nginx-x.x.x.tgz