Helm Variables: Difference between revisions
| (4 intermediate revisions by the same user not shown) | |||
| Line 4: | Line 4: | ||
* [[Helm_Templates#Variables|Helm Templates]] | * [[Helm_Templates#Variables|Helm Templates]] | ||
=Overview= | =Overview= | ||
A variable is a named reference to another object. It is assigned and referred using the $<name> syntax. := is used as assignment operator. | A variable is a named reference to another built-in object or a constant. It is assigned and referred using the $<name> syntax. := is used as assignment operator. | ||
<syntaxhighlight lang='yaml'> | <syntaxhighlight lang='yaml'> | ||
{{- $relname := .Release.Name -}} | {{- $relname := .Release.Name -}} | ||
{{- $color := "green" -}} | |||
... | ... | ||
data: | data: | ||
release: {{ $relname }} | release: {{ $relname }} | ||
color: {{ $color }} | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Variables are less frequently used, as an alternative preferred construct is the [[Helm_Named_Templates|named template]]. | Variables are less frequently used, as an alternative preferred construct is the [[Helm_Named_Templates|named template]]. | ||
Variables are particularly useful in range loops. They can be used on list-like objects to capture both the index and the value: | =Variable Scope= | ||
Variables are normally not "global". They are scoped to the block in which they are declared. However, there is one variable that is aways global: $. This variable will always point to the root context: | |||
<syntaxhighlight lang='yaml'> | |||
{{ $.Chart.AppVersion }} | |||
</syntaxhighlight> | |||
=Variables and Range Loops= | |||
Variables are particularly useful in [[Helm Template range|range loops]]. They can be used on list-like objects to capture both the index and the value: | |||
<syntaxhighlight lang='yaml'> | <syntaxhighlight lang='yaml'> | ||
toppings: |- | toppings: |- | ||
| Line 27: | Line 35: | ||
{{ $key }}: {{ $val | quote }} | {{ $key }}: {{ $val | quote }} | ||
{{- end }} | {{- end }} | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Latest revision as of 01:06, 8 October 2020
External
Internal
Overview
A variable is a named reference to another built-in object or a constant. It is assigned and referred using the $<name> syntax. := is used as assignment operator.
{{- $relname := .Release.Name -}}
{{- $color := "green" -}}
...
data:
release: {{ $relname }}
color: {{ $color }}
Variables are less frequently used, as an alternative preferred construct is the named template.
Variable Scope
Variables are normally not "global". They are scoped to the block in which they are declared. However, there is one variable that is aways global: $. This variable will always point to the root context:
{{ $.Chart.AppVersion }}
Variables and Range Loops
Variables are particularly useful in range loops. They can be used on list-like objects to capture both the index and the value:
toppings: |-
{{- range $index, $topping := .Values.pizzaToppings }}
{{ $index }}: {{ $topping }}
{{- end }}
This will assign the integer index (0-based) to $index and the value to $topping. For data structures that have both key and value, range can be used to get both and assign them to variables:
{{- range $key, $val := .Values.favorite }}
{{ $key }}: {{ $val | quote }}
{{- end }}