docs: add precision on what value files will be rendered (#337)

This commit is contained in:
David Genest 2018-09-14 08:44:38 -04:00 committed by KUOKA Yusuke
parent b3da9a9a07
commit 43a54486a1
1 changed files with 7 additions and 4 deletions

View File

@ -281,7 +281,10 @@ The `selector` parameter can be specified multiple times. Each parameter is reso
## Templates ## Templates
You can use go's text/template expressions in `helmfile.yaml` and `values.yaml`(helm values files). You can use go's text/template expressions in `helmfile.yaml` and `values.yaml.gotmpl` (templated helm values files). `values.yaml` references will be used verbatim. In other words:
- for value files ending with `.gotmpl`, template expressions will be rendered
- for plain value files (ending in `.yaml`), content will be used as-is
In addition to built-in ones, the following custom template functions are available: In addition to built-in ones, the following custom template functions are available:
@ -453,8 +456,8 @@ environments:
- default.yaml - default.yaml
production: production:
values: values:
- production.yaml # template directives with potential side-effects like `exec` and `readFile` will NOT be executed - production.yaml # bare .yaml file, content will be used verbatim
- other.yaml.gotmpl # `exec` and `readFile` will be honoured - other.yaml.gotmpl # template directives with potential side-effects like `exec` and `readFile` will be honoured
releases: releases:
- name: myapp-{{ .Environment.Values.releaseName }} # release name will be one of `dev` or `prod` depending on selected environment - name: myapp-{{ .Environment.Values.releaseName }} # release name will be one of `dev` or `prod` depending on selected environment
@ -571,7 +574,7 @@ All the files are sorted alphabetically per group = array item inside `helmfiles
The `exec` template function that is available in `values.yaml.gotmpl` is useful for importing values from any source The `exec` template function that is available in `values.yaml.gotmpl` is useful for importing values from any source
that is accessible by running a command: that is accessible by running a command:
An usual usage of `exec` would look like this: A usual usage of `exec` would look like this:
``` ```
mysetting: | mysetting: |