• 模板的函数和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)。