helm/docs/examples/nginx/README.md

nginx: An advanced example chart

This Helm chart provides examples of some of Helm's more powerful features.

This is not a production-grade chart. It is an example.

The chart installs a simple nginx server according to the following pattern:

• A ConfigMap is used to store the files the server will serve. (templates/configmap.yaml)
• A Deployment is used to create a Replica Set of nginx pods. (templates/deployment.yaml)
• A Service is used to create a gateway to the pods running in the replica set (templates/service.yaml)

The values.yaml exposes a few of the configuration options in the charts, though there are some that are not exposed there (like .image).

The templates/_helpers.tpl file contains helper templates. The leading underscore (_) on the filename is semantic. It tells the template renderer that this file does not contain a manifest. That file declares some templates that are used elsewhere in the chart.

Helpers (usually called "partials" in template languages) are an advanced way for developers to structure their templates for optimal reuse.

You can deploy this chart with helm install docs/examples/nginx. Or you can see how this chart would render with helm install --dry-run --debug docs/examples/nginx.