• 变量

    变量

    通过我们的function,pipeline,object和控制结构,我们可以在许多编程语言中找到更基本的想法之一:变量。 在模板中,它们使用的频率较低。 但我们将看到如何使用它们来简化代码,并更好地使用with和range。

    在前面的例子中,我们看到这段代码会失败:

    1. {{- with .Values.favorite }}
    2. drink: {{ .drink | default "tea" | quote }}
    3. food: {{ .food | upper | quote }}
    4. release: {{ .Release.Name }}
    5. {{- end }}

    Release.Name不在with块中限制的范围内。 解决范围问题的一种方法是将对象分配给可以在不考虑当前范围的情况下访问的变量。

    在Helm模板中,变量是对另一个对象的命名引用。 它遵循形式$name。 变量分配一个特殊的赋值运算符::=。 我们可以为Release.Name使用一个变量来重写上面的内容。

    1. apiVersion: v1
    2. kind: ConfigMap
    3. metadata:
    4. name: {{ .Release.Name }}-configmap
    5. data:
    6. myvalue: "Hello World"
    7. {{- $relname := .Release.Name -}}
    8. {{- with .Values.favorite }}
    9. drink: {{ .drink | default "tea" | quote }}
    10. food: {{ .food | upper | quote }}
    11. release: {{ $relname }}
    12. {{- end }}

    注意,我们在with块之前,分配\$ relname:= .Release.Name。 现在在with块中,$ relname变量仍指向发布名称。

    运行会产生这样的结果:

    1. # Source: mychart/templates/configmap.yaml
    2. apiVersion: v1
    3. kind: ConfigMap
    4. metadata:
    5. name: viable-badger-configmap
    6. data:
    7. myvalue: "Hello World"
    8. drink: "coffee"
    9. food: "PIZZA"
    10. release: viable-badger

    变量在rang循环中特别有用。 它们可以用于类似列表的对象以同时捕获索引和值:

    1. toppings: |-
    2. {{- range $index, $topping := .Values.pizzaToppings }}
    3. {{ $index }}: {{ $topping }}
    4. {{- end }}

    请注意,rang首先是变量,然后是赋值运算符,然后是list。 这会将整数索引(从零开始)分配给$ index,并将值分配给$ topping。 运行它将产生:

    1. toppings: |-
    2. 0: mushrooms
    3. 1: cheese
    4. 2: peppers
    5. 3: onions

    对于同时具有键和值的数据结构,我们可以使用rang来获取两者。 例如,我们可以像这样循环访问.Values.favorite:

    1. apiVersion: v1
    2. kind: ConfigMap
    3. metadata:
    4. name: {{ .Release.Name }}-configmap
    5. data:
    6. myvalue: "Hello World"
    7. {{- range $key, $val := .Values.favorite }}
    8. {{ $key }}: {{ $val | quote }}
    9. {{- end}}

    现在在第一次迭代中,\$ key将是drink,\$ val将是coffee,第二次,\$key将是food,$ val将是比pizza。 运行上面的代码会生成这个:

    1. # Source: mychart/templates/configmap.yaml
    2. apiVersion: v1
    3. kind: ConfigMap
    4. metadata:
    5. name: eager-rabbit-configmap
    6. data:
    7. myvalue: "Hello World"
    8. drink: "coffee"
    9. food: "pizza"

    变量通常不是“全局”的。 它们的范围是它们所在的块。 之前,我们在模板的顶层分配了\$ relname。 该变量将在整个模板的范围内。 但在我们的最后一个例子中,\$ key和\$ val只会在{{range …}} {{end}}块的范围内。

    然而,总有一个变量是全局的 - $ - 这个变量总是指向root上下文。 当你在需要知道chart release名称的范围内循环时,这可能非常有用。

    例如:

    1. {{- range .Values.tlsSecrets }}
    2. apiVersion: v1
    3. kind: Secret
    4. metadata:
    5. name: {{ .name }}
    6. labels:
    7. # Many helm templates would use `.` below, but that will not work,
    8. # however `$` will work here
    9. app: {{ template "fullname" $ }}
    10. # I cannot reference .Chart.Name, but I can do $.Chart.Name
    11. chart: "{{ $.Chart.Name }}-{{ $.Chart.Version }}"
    12. release: "{{ $.Release.Name }}"
    13. heritage: "{{ $.Release.Service }}"
    14. type: kubernetes.io/tls
    15. data:
    16. tls.crt: {{ .certificate }}
    17. tls.key: {{ .key }}
    18. ---
    19. {{- end }}

    到目前为止,我们只查看了一个文件中声明的一个模板。 但是Helm模板语言的强大功能之一是它能够声明多个模板并将它们一起使用。 我们将在下一节谈谈。