• 模板的函数和pipeline
    • PIPELINES
    • 使用DEFUALT功能
    • 运算符也是函数

    模板的函数和pipeline

    到目前为止,我们已经看到如何将信息放入模板中。 但是这些信息未经修改就被放入模板中。 有时我们想要以提供给我们更多可用的方式来转换提供的数据。

    让我们从一个最佳实践开始:当从.Values对象注入字符串到模板中时,我们应该引用这些字符串。 我们可以通过在模板指令中调用quote函数来实现:

    1. apiVersion: v1
    2. kind: ConfigMap
    3. metadata:
    4. name: {{ .Release.Name }}-configmap
    5. data:
    6. myvalue: "Hello World"
    7. drink: {{ quote .Values.favorite.drink }}
    8. food: {{ quote .Values.favorite.food }}

    模板函数遵循句式functionName arg1 arg2 ….在上面的代码片段中,quote .Values.favorite.drink调用quote函数并将其传递给一个参数。

    Helm拥有超过60种可用功能。 其中一些是由Go模板语言本身定义的。 其他大多数都是Sprig模板库的一部分。 在我们通过例子进行的过程中,我们会看到其中的很多。

    虽然我们将Helm模板语言视为Helm特有的,但它实际上是Go模板语言,一些额外函数和各种包装器的组合,以将某些对象暴露给模板。 Go模板上的许多资源在您了解模板时可能会有所帮助。

    PIPELINES

    模板语言的强大功能之一是其管道概念。 利用UNIX的一个概念,pipeline是一个链接在一起的一系列模板命令的工具,可以紧凑地表达一系列转换。 换句话说,pipeline是按顺序完成几件事情的有效方式。 我们用pipeline重写上面的例子。

    1. apiVersion: v1
    2. kind: ConfigMap
    3. metadata:
    4. name: {{ .Release.Name }}-configmap
    5. data:
    6. myvalue: "Hello World"
    7. drink: {{ .Values.favorite.drink | quote }}
    8. food: {{ .Values.favorite.food | quote }}

    在这个例子中,我们不是调用quote ARGUMENT,而是颠倒了顺序。 我们使用管道符(|)将“参数”发送给函数:.Values.favorite.drink | quote。 使用管道符,我们可以将几个功能链接在一起:

    1. apiVersion: v1
    2. kind: ConfigMap
    3. metadata:
    4. name: {{ .Release.Name }}-configmap
    5. data:
    6. myvalue: "Hello World"
    7. drink: {{ .Values.favorite.drink | quote }}
    8. food: {{ .Values.favorite.food | upper | quote }}

    反转订单是模板中的常见做法。 你会看到.val | quote比queto .val更频繁出现.

    评估时,该模板将产生以下结果:

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

    请注意,我们原来的“pizza”现在已经变成了“PIZZA”。

    当像这样使用pipeline参数时,第一次评估的结果(.Values.favorite.drink)作为函数的最后一个参数发送。 我们可以修改上面的drink示例来说明一个带有两个参数的函数:repeat COUNT STRING:

    1. apiVersion: v1
    2. kind: ConfigMap
    3. metadata:
    4. name: {{ .Release.Name }}-configmap
    5. data:
    6. myvalue: "Hello World"
    7. drink: {{ .Values.favorite.drink | repeat 5 | quote }}
    8. food: {{ .Values.favorite.food | upper | quote }}

    repeat函数将给定的字符串回显给定的次数,所以我们将得到这个输出:

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

    使用DEFUALT功能

    模板中经常使用的一个函数是defualt函数:默认DEFAULT_VALUE GIVEN_VALUE。 该功能允许您在模板内部指定默认值,以防该值被省略。 让我们用它来修改上面的drink示例:

    1. drink: {{ .Values.favorite.drink | default "tea" | quote }}

    如果我们照常运行,我们会得到我们的coffee:

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

    现在,我们将从values.yaml中移除最喜欢的drink设置:

    1. favorite:
    2. #drink: coffee
    3. food: pizza

    现在重新运行helm install —dry-run —debug ./mychart会产生这个YAML:

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

    在实际的chart中,所有静态默认值都应该存在于values.yaml中,并且不应该使用default命令重复(否则它们将是多余的)。 但是,default命令无法在values.yaml中声明的计算是非常有用的。 例如:

    1. drink: {{ .Values.favorite.drink | default (printf "%s-tea" (include "fullname" .)) }}

    在某些地方,有if条件的使用default比在values.yaml声明更适合. 我们将在下一节中看到这些。

    模板函数和管道是一种转换信息并将其插入到YAML中的强大方法。 但有时候需要添加一些比插入字符串更复杂一些的模板逻辑。 在下一节中,我们将看看模板语言提供的控制结构。

    运算符也是函数

    对于模板,运算符(eq,ne,lt,gt等等)都是作为函数实现的。 在管道中,操作可以用括号((和))分组。

    现在我们可以使用条件,循环和范围修饰符从函数和pipeline转向流控制(flow control)。