当前位置：首页 > news >正文

Helm 模板流程控制

news 2025/8/6 11:11:49

Helm 的模板语言提供了多种控制结构，以允许模板作者根据条件逻辑生成模板内容。以下是 Helm 模板控制结构的核心内容总结：

控制结构

Helm 模板支持以下控制结构：

if/else：用于创建条件语句，根据给定的条件包含或排除模板中的文本块。
with：用于指定作用域，改变当前作用域（.）的上下文。
range：提供“for each”类型的循环，用于迭代集合，如列表、元组、映射或字典。

命名模板

除了控制结构，Helm 还提供了声明和使用命名模板的关键字：

define：在模板中声明一个新的命名模板。
template：导入一个命名模板。
block：声明一种特殊的可填充的模板块。

条件语句 (`if`/`else`)

if/else 结构允许执行管道操作，而不仅仅是计算值。以下值被视为 false：

布尔值 false
数字 0
空字符串
nil（空或 null）
空集合（如 map, slice, tuple, dict, array）

示例

[root@master ~]# tail -5 python-flask/values.yamlaffinity: {}
favorite:drink: coffeefood: pizza[root@master ~]# cat python-flask/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:name: {{ .Release.Name }}-configmap
data:myvalue: "Hello World"drink: {{ .Values.favorite.drink | default "tea" | quote }}food: {{ .Values.favorite.food | upper | quote }}{{ if eq .Values.favorite.drink "coffee" }}mug: "true"{{ end }}

结果

# Source: python-flask/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:name: geared-marsupi-configmap
data:myvalue: "Hello World"drink: "coffee"food: "PIZZA"mug: "true"

YAML文件中空格是有意义的，因此管理空格变得很重要。这里把缩进去掉就执行成功了。

作用域 (`with`)

with 语句可以改变当前作用域，使得模板中的 . 指向特定的对象。这允许模板作者在不重复前缀的情况下引用对象的字段。

循环 (`range`)

range 操作符允许对集合进行迭代，每次迭代 . 都会指向当前迭代的元素。这使得模板能够为集合中的每个元素生成内容。

空格控制

Helm 模板中的空格控制非常重要，因为 YAML 格式中空格是有意义的。Helm 提供了特殊的语法来控制空格：

{{-：表示左侧的空格应该被删除。
-}}：表示右侧的空格应该被删除。

正确管理空格可以避免生成无效的 YAML 文件。

示例

[root@master ~]# cat python-flask/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:name: {{ .Release.Name }}-configmap
data:myvalue: "Hello World"drink: {{ .Values.favorite.drink | default "tea" | quote }}food: {{ .Values.favorite.food | upper | quote }}{{ if eq .Values.favorite.drink "coffee" }}mug: "true" # 此处多了空格{{ end }}

结果

[root@master ~]# helm install geared-marsupi ./python-flask  --dry-run --debug -n default
install.go:214: [debug] Original chart version: ""
install.go:231: [debug] CHART PATH: /root/python-flaskError: INSTALLATION FAILED: YAML parse error on python-flask/templates/configmap.yaml: error converting YAML to JSON: yaml: line 9: did not find expected key
helm.go:84: [debug] error converting YAML to JSON: yaml: line 9: did not find expected key