Values 文件

在上一部分我们了解了Helm模板提供的内置对象。其中一个是Values。该对象提供了对传递到chart的值的访问方法， 其内容源包括了多个位置：

  • chart中的values.yaml文件
  • 如果是子chart，就是父chart中的values.yaml文件
  • 使用-f参数(helm install -f myvals.yaml ./mychart)传递到 helm install 或 helm upgrade的values文件
  • 使用--set (比如helm install --set foo=bar ./mychart)传递的单个参数

以上列表有明确顺序：默认使用values.yaml，可以被父chart的values.yaml覆盖，继而被用户提供values文件覆盖， 最后会被--set参数覆盖。

values文件是普通的YAML文件。现在编辑mychart/values.yaml然后编辑配置映射ConfigMap模板。

删除values.yaml中的默认内容，仅设置一个参数：

  1. favoriteDrink: coffee

现在可以在模板中使用它：

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

注意最后一行，favoriteDrink是Values的一个属性: {{ .Values.favoriteDrink }}。

看看是如何渲染的：

  1. $ helm install geared-marsupi ./mychart --dry-run --debug
  2. install.go:158: [debug] Original chart version: ""
  3. install.go:175: [debug] CHART PATH: /home/bagratte/src/playground/mychart
  5. NAME: geared-marsupi
  6. LAST DEPLOYED: Wed Feb 19 23:21:13 2020
  7. NAMESPACE: default
  8. STATUS: pending-install
  9. REVISION: 1
  10. TEST SUITE: None
  11. USER-SUPPLIED VALUES:
  12. {}
  14. COMPUTED VALUES:
  15. favoriteDrink: coffee
  17. HOOKS:
  18. MANIFEST:
  19. ---
  20. # Source: mychart/templates/configmap.yaml
  21. apiVersion: v1
  22. kind: ConfigMap
  23. metadata:
  24.   name: geared-marsupi-configmap
  25. data:
  26.   myvalue: "Hello World"
  27.   drink: coffee

由于默认的values.yaml文件中设置了favoriteDrink的值为coffee，则这个显示在了模板中。 可以在调用helm install时设置--set，很容易就能覆盖这个值。

  1. $ helm install solid-vulture ./mychart --dry-run --debug --set favoriteDrink=slurm
  2. install.go:158: [debug] Original chart version: ""
  3. install.go:175: [debug] CHART PATH: /home/bagratte/src/playground/mychart
  5. NAME: solid-vulture
  6. LAST DEPLOYED: Wed Feb 19 23:25:54 2020
  7. NAMESPACE: default
  8. STATUS: pending-install
  9. REVISION: 1
  10. TEST SUITE: None
  11. USER-SUPPLIED VALUES:
  12. favoriteDrink: slurm
  14. COMPUTED VALUES:
  15. favoriteDrink: slurm
  17. HOOKS:
  18. MANIFEST:
  19. ---
  20. # Source: mychart/templates/configmap.yaml
  21. apiVersion: v1
  22. kind: ConfigMap
  23. metadata:
  24.   name: solid-vulture-configmap
  25. data:
  26.   myvalue: "Hello World"
  27.   drink: slurm

由于--set比默认的values.yaml文件优先级更高，模板就生成了drink: slurm。

values文件也可以包含更多结构化的内容。比如我们可以在values.yaml文件中创建一个favorite项，然后添加一些key：

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

现在需要稍微修改一些模板：

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

虽然可以这样构造数据，但还是建议构建更加平坦的浅层树。当我们想要给子chart赋值时，会看到如何使用树结构给value命名。

删除默认的key

如果需要从默认的value中删除key，可以将key设置为null，Helm将在覆盖的value合并时删除这个key。

比如，稳定的Drupal chart 允许在配置自定义镜像时配置活动探针。以下是默认值：

  1. livenessProbe:
  2.   httpGet:
  3.     path: /user/login
  4.     port: http
  5.   initialDelaySeconds: 120

如果你想用exec重写活动探针句柄而不是httpGet，使用--set livenessProbe.exec.command=[cat,docroot/CHANGELOG.txt]， Helm会把默认的key和重写的key合并在一起，从而生成以下YAML：

  1. livenessProbe:
  2.   httpGet:
  3.     path: /user/login
  4.     port: http
  5.   exec:
  6.     command:
  7.     - cat
  8.     - docroot/CHANGELOG.txt
  9.   initialDelaySeconds: 120

然而Kubernetes会失败，因为不能声明多个活动探针句柄。为了解决这个问题，可以指定Helm通过设定null来删除livenessProbe.httpGet：

  1. helm install stable/drupal --set image=my-registry/drupal:0.1.0 --set livenessProbe.exec.command=[cat,docroot/CHANGELOG.txt] --set livenessProbe.httpGet=null

这里我们已经看到了几个内置对象，并用它们将信息植入到模板中。现在来模板引擎的另一部分：方法和管道。

Prev← 内置对象

Next模板函数和流水线 →