48. Helm模板之其他注意事项

上节课我们学习了命名模板的使用,命名模板是 Helm 模板中非常重要的一个功能,在我们实际开发 Helm Chart 包的时候非常有用,到这里我们基本上就把 Helm 模板中经常使用到的一些知识点和大家介绍完了。但是仍然还是有一些在开发中值得我们注意的一些知识点,比如 NOTES.txt 文件的使用、子 Chart 的使用、全局值的使用,这节课我们就来和大家一起了解下这些知识点。

NOTES.txt 文件

我们前面在使用 helm install 命令的时候,Helm 都会为我们打印出一大堆介绍信息,这样当别的用户在使用我们的 chart 包的时候就可以根据这些注释信息快速了解我们的 chart 包的使用方法,这些信息就是编写在 NOTES.txt 文件之中的,这个文件是纯文本的,但是它和其他模板一样,具有所有可用的普通模板函数和对象。

现在我们在前面的示例中 templates 目录下面创建一个 NOTES.txt 文件:

  1. Thank you for installing {{ .Chart.Name }}.
  2. Your release is named {{ .Release.Name }}.
  3. To learn more about the release, try:
  4. $ helm status {{ .Release.Name }}
  5. $ helm get {{ .Release.Name }}

我们可以看到我们在 NOTES.txt 文件中也使用 Chart 和 Release 对象,现在我们在 mychart 包根目录下面执行安装命令查看是否能够得到上面的注释信息:

  1. $ helm install .
  2. Error: release nomadic-deer failed: ConfigMap in version "v1" cannot be handled as a ConfigMap: v1.ConfigMap: Data: ReadString: expects " or n, but found [, error found in #10 byte of ...|rselist":[{"0":"K8s"|..., bigger context ...|:{"app":"mychart","chart":"mychart","courselist":[{"0":"K8s"},{"1":"Python"},{"2":"Search"},{"3":"Go|...

我们可以看到出现了上面的错误信息,但是如果我们去执行 debug 命令来调试的话是没有任何问题的,是可以正常渲染的,但是为什么在正式安装的时候确出现了问题呢?这是因为我们在 debug 调试阶段只是检验模板是否可以正常渲染,并没有去检查对应的 kubernetes 资源对象对 yaml 文件的格式要求,所以我们说 debug 测试通过,并不代表 chart 就真正的是可用状态,比如我们这里是一个 ConfigMap 的资源对象,ConfigMap 对 data 区域的内容是有严格要求的,比如我们这里出现了下面这样的内容:

  1. web: true
  2. courselist:
  3. - 0: "K8s"
  4. - 1: "Python"
  5. - 2: "Search"
  6. - 3: "Golang"

这的确是一个合法的 yaml 文件的格式,但是对 ConfigMap 就不合法了,需要把 true 变成字符串,下面的字典数组变成一个多行的字符串,这样就是一个合法的 ConfigMap了:(templates/config.yaml)

  1. apiVersion: v1
  2. kind: ConfigMap
  3. metadata:
  4. name: {{ .Release.Name }}-configmap
  5. labels:
  6. {{- include "mychart.labels" . | indent 4}}
  7. data:
  8. app: mychart
  9. myvalue: {{ .Values.hello | default "Hello World" | quote }}
  10. {{- $releaseName := .Release.Name }}
  11. {{- with .Values.course }}
  12. k8s: {{ .k8s | upper | quote }}
  13. python: {{ .python | repeat 5 | quote }}
  14. release: {{ $releaseName }}
  15. {{- if eq .python "django" }}
  16. web: "true"
  17. {{- end }}
  18. {{- end }}
  19. courselist: |
  20. {{- range $index, $course := .Values.courselist }}
  21. {{ $course | title | quote }}
  22. {{- end }}
  23. {{- range $key, $val := .Values.course }}
  24. {{ $key }}: {{ $val | upper | quote }}
  25. {{- end }}
  26. {{- include "mychart.labels" . | indent 2 }}

现在我们再来执行安装命令:

  1. $ helm install .
  2. NAME: nosy-pig
  3. LAST DEPLOYED: Sat Sep 29 19:26:16 2018
  4. NAMESPACE: default
  5. STATUS: DEPLOYED
  6. RESOURCES:
  7. ==> v1/ConfigMap
  8. NAME DATA AGE
  9. nosy-pig-configmap 11 0s
  10. NOTES:
  11. Thank you for installing mychart.
  12. Your release is named nosy-pig.
  13. To learn more about the release, try:
  14. $ helm status nosy-pig
  15. $ helm get nosy-pig

现在已经安装成功了,而且下面的注释部分也被渲染出来了,我们可以看到 NOTES.txt 里面使用到的模板对象都被正确渲染了。

为我们创建的 chart 包提供一个清晰的 NOTES.txt 文件是非常有必要的,可以为用户提供有关如何使用新安装 chart 的详细信息,这是一种非常友好的方式方法。

子 chart 包

我们到目前为止都只用了一个 chart,但是 chart 也可以有 子 chart 的依赖关系,它们也有自己的值和模板,在学习字 chart 之前,我们需要了解几点关于子 chart 的说明:

  • 子 chart 是独立的,所以子 chart 不能明确依赖于其父 chart
  • 子 chart 无法访问其父 chart 的值
  • 父 chart 可以覆盖子 chart 的值
  • Helm 中有全局值的概念,可以被所有的 chart 访问

创建子 chart

现在我们就来创建一个子 chart,还记得我们在创建 mychart 包的时候,在根目录下面有一个空文件夹 charts 目录吗?这就是我们的子 chart 所在的目录,在该目录下面添加一个新的 chart:

  1. $ cd mychart/charts
  2. $ helm create mysubchart
  3. Creating mysubchart
  4. $ rm -rf mysubchart/templates/*.*
  5. $ tree ..
  6. ..
  7. ├── charts
  8. │ └── mysubchart
  9. │ ├── charts
  10. │ ├── Chart.yaml
  11. │ ├── templates
  12. │ └── values.yaml
  13. ├── Chart.yaml
  14. ├── templates
  15. │ ├── configmap.yaml
  16. │ ├── _helpers.tpl
  17. │ └── NOTES.txt
  18. └── values.yaml
  19. 5 directories, 7 files

同样的,我们将子 chart 模板中的文件全部删除了,接下来,我们为子 chart 创建一个简单的模板和 values 文件了。

  1. $ cat > mysubchart/values.yaml <<EOF
  2. in: mysub
  3. EOF
  4. $ cat > mysubchart/templates/configmap.yaml <<EOF
  5. apiVersion: v1
  6. kind: ConfigMap
  7. metadata:
  8. name: {{ .Release.Name }}-configmap2
  9. data:
  10. in: {{ .Values.in }}
  11. EOF

我们上面已经提到过每个子 chart 都是独立的 chart,所以我们可以单独给 mysubchart 进行测试:

  1. $ helm install --dry-run --debug ./mysubchart
  2. [debug] Created tunnel using local port: '33568'
  3. ......
  4. ---
  5. # Source: mysubchart/templates/configmap.yaml
  6. apiVersion: v1
  7. kind: ConfigMap
  8. metadata:
  9. name: washed-indri-configmap2
  10. data:
  11. in: mysub

我们可以看到正常渲染出了结果。

值覆盖

现在 mysubchart 这个子 chart 就属于 mychart 这个父 chart 了,由于 mychart 是父级,所以我们可以在 mychart 的 values.yaml 文件中直接配置子 chart 中的值,比如我们可以在 mychart/values.yaml 文件中添加上子 chart 的值:

  1. course:
  2. k8s: devops
  3. python: django
  4. courselist:
  5. - k8s
  6. - python
  7. - search
  8. - golang
  9. mysubchart:
  10. in: parent

注意最后两行,mysubchart 部分内的任何指令都会传递到 mysubchart 这个子 chart 中去的,现在我们在 mychart 根目录中执行调试命令,可以查看到子 chart 也被一起渲染了:

  1. $ helm install --dry-run --debug .
  2. [debug] Created tunnel using local port: '44798'
  3. ......
  4. ---
  5. # Source: mychart/charts/mysubchart/templates/configmap.yaml
  6. apiVersion: v1
  7. kind: ConfigMap
  8. metadata:
  9. name: ideal-ostrich-configmap2
  10. data:
  11. in: parent
  12. ---
  13. # Source: mychart/templates/configmap.yaml
  14. ......

我们可以看到子 chart 中的值已经被顶层的值给覆盖了。但是在某些场景下面我们还是希望某些值在所有模板中都可以使用,这就需要用到全局 chart 值了。

全局值

全局值可以从任何 chart 或者子 chart中进行访问使用,values 对象中有一个保留的属性是Values.global,就可以被用来设置全局值,比如我们在父 chart 的 values.yaml 文件中添加一个全局值:

  1. course:
  2. k8s: devops
  3. python: django
  4. courselist:
  5. - k8s
  6. - python
  7. - search
  8. - golang
  9. mysubchart:
  10. in: parent
  11. global:
  12. allin: helm

我们在 values.yaml 文件中添加了一个 global 的属性,这样的话无论在父 chart 中还是在子 chart 中我们都可以通过{{ .Values.global.allin }}来访问这个全局值了。比如我们在 mychart/templates/configmap.yaml 和 mychart/charts/mysubchart/templates/configmap.yaml 文件的 data 区域下面都添加上如下内容:

  1. ...
  2. data:
  3. allin: {{ .Values.global.allin }}
  4. ...

现在我们在 mychart 根目录下面执行 debug 调试模式:

  1. $ helm install --dry-run --debug .
  2. [debug] Created tunnel using local port: '32775'
  3. ......
  4. MANIFEST:
  5. ---
  6. # Source: mychart/charts/mysubchart/templates/configmap.yaml
  7. apiVersion: v1
  8. kind: ConfigMap
  9. metadata:
  10. name: wistful-spaniel-configmap2
  11. data:
  12. allin: helm
  13. in: parent
  14. ---
  15. # Source: mychart/templates/configmap.yaml
  16. apiVersion: v1
  17. kind: ConfigMap
  18. metadata:
  19. name: wistful-spaniel-configmap
  20. ......
  21. data:
  22. allin: helm
  23. ......

我们可以看到两个模板中都输出了allin: helm这样的值,全局变量对于传递这样的信息非常有用,不过也要注意我们不能滥用全局值。

另外值得注意的是我们在学习命名模板的时候就提到过父 chart 和子 chart 可以共享模板。任何 chart 中的任何定义块都可用于其他 chart,所以我们在给命名模板定义名称的时候添加了 chart 名称这样的前缀,避免冲突。


点击查看本文视频

扫描下面的二维码(或微信搜索k8s技术圈)关注我们的微信公众帐号,在微信公众帐号中回复 加群 即可加入到我们的 kubernetes 讨论群里面共同学习。

k8s技术圈二维码