我们学习了命名模板的使用,命名模板是 Helm 模板中非常重要的一个功能,在我们实际开发 Helm Chart 包的时候非常有用,到这里我们基本上就把 Helm 模板中经常使用到的一些知识点和大家介绍完了。但是仍然还是有一些在开发中值得我们注意的一些知识点,比如 `NOTES.txt` 文件的使用、子 Chart 的使用、全局值的使用。
## 1. 子 chart 包
我们到目前为止都只用了一个 chart,但是 chart 也可以有 子 chart 的依赖关系,它们也有自己的值和模板,在学习字 chart 之前,我们需要了解几点关于子 chart 的说明:
- 子 chart 是独立的,所以子 chart 不能明确依赖于其父 chart
- 子 chart 无法访问其父 chart 的值
- 父 chart 可以覆盖子 chart 的值
- Helm 中有全局值的概念,可以被所有的 chart 访问
## 2. 创建子 chart
现在我们就来创建一个子 chart,还记得我们在创建 mychart 包的时候,在根目录下面有一个空文件夹 charts 目录吗?这就是我们的子 chart 所在的目录,在该目录下面添加一个新的 `chart`:
```bash
$ cd mychart/charts
$ helm create mysubchart
Creating mysubchart
$ rm -rf mysubchart/templates/*.*
$ tree ..
..
├── charts
│ └── mysubchart
│ ├── charts
│ ├── Chart.yaml
│ ├── templates
│ └── values.yaml
├── Chart.yaml
├── templates
│ ├── configmap.yaml
│ ├── _helpers.tpl
│ └── NOTES.txt
└── values.yaml
5 directories, 7 files
```
同样的,我们将子 chart 模板中的文件全部删除了,接下来,我们为子 chart 创建一个简单的模板和 values 文件了。
```bash
$ cat > mysubchart/values.yaml <<EOF
in: mysub
EOF
$ cat > mysubchart/templates/configmap.yaml <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap2
data:
in: {{ .Values.in }}
EOF
```
我们上面已经提到过每个子 chart 都是独立的 `chart`,所以我们可以单独给 `mysubchart` 进行测试:
```bash
$ helm install --dry-run --debug ./mysubchart
[debug] Created tunnel using local port: '33568'
......
---
# Source: mysubchart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: washed-indri-configmap2
data:
in: mysub
```
我们可以看到正常渲染出了结果。
## 3. 值覆盖
现在 `mysubchart` 这个子 chart 就属于 `mychart` 这个父 `chart` 了,由于 `mychart` 是父级,所以我们可以在 `mychart` 的 `values.yaml` 文件中直接配置子 chart 中的值,比如我们可以在 `mychart/values.yaml` 文件中添加上子 chart 的值:
```bash
course:
k8s: devops
python: django
courselist:
- k8s
- python
- search
- golang
mysubchart:
in: parent
```
注意最后两行,`mysubchart` 部分内的任何指令都会传递到 `mysubchart` 这个子 chart 中去的,现在我们在 `mychart` 根目录中执行调试命令,可以查看到子 `chart` 也被一起渲染了:
```bash
$ helm install --dry-run --debug .
[debug] Created tunnel using local port: '44798'
......
---
# Source: mychart/charts/mysubchart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: ideal-ostrich-configmap2
data:
in: parent
---
# Source: mychart/templates/configmap.yaml
......
```
我们可以看到子 `chart` 中的值已经被顶层的值给覆盖了。但是在某些场景下面我们还是希望某些值在所有模板中都可以使用,这就需要用到全局 `chart` 值了。
## 4. 全局值
全局值可以从任何 chart 或者子 `chart`中进行访问使用,`values` 对象中有一个保留的属性是`Values.global`,就可以被用来设置全局值,比如我们在父 chart 的 `values.yaml` 文件中添加一个全局值:
```bash
course:
k8s: devops
python: django
courselist:
- k8s
- python
- search
- golang
mysubchart:
in: parent
global:
allin: helm
```
我们在 `values.yaml` 文件中添加了一个 `global` 的属性,这样的话无论在父 `chart` 中还是在子 `chart` 中我们都可以通过`{{ .Values.global.allin }}`来访问这个全局值了。比如我们在 `mychart/templates/configmap.yaml` 和 `mychart/charts/mysubchart/templates/configmap.yaml` 文件的 data 区域下面都添加上如下内容:
```bash
...
data:
allin: {{ .Values.global.allin }}
...
```
现在我们在 mychart 根目录下面执行 `debug` 调试模式:
```bash
$ helm install --dry-run --debug .
[debug] Created tunnel using local port: '32775'
......
MANIFEST:
---
# Source: mychart/charts/mysubchart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: wistful-spaniel-configmap2
data:
allin: helm
in: parent
---
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: wistful-spaniel-configmap
......
data:
allin: helm
......
```
我们可以看到两个模板中都输出了`allin: helm`这样的值,全局变量对于传递这样的信息非常有用,不过也要注意我们不能滥用全局值。
另外值得注意的是我们在学习命名模板的时候就提到过父 chart 和子 chart 可以共享模板。任何 chart 中的任何定义块都可用于其他 chart,所以我们在给命名模板定义名称的时候添加了 chart 名称这样的前缀,避免冲突。