Values 文件
其内容来自于多个位置:
- 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
最低,--set
参数最高。
values文件是普通的YAML文件。现在编辑mychart/values.yaml
然后编辑配置映射ConfigMap模板。
删除values.yaml
中的默认内容,仅设置一个参数:
现在可以在模板中使用它:
apiVersion: v1
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
myvalue: "Hello World"
drink: {{ .Values.favoriteDrink }}
看看是如何渲染的:
$ helm install geared-marsupi ./mychart --dry-run --debug
install.go:158: [debug] Original chart version: ""
install.go:175: [debug] CHART PATH: /home/bagratte/src/playground/mychart
LAST DEPLOYED: Wed Feb 19 23:21:13 2020
NAMESPACE: default
REVISION: 1
TEST SUITE: None
USER-SUPPLIED VALUES:
{}
COMPUTED VALUES:
favoriteDrink: coffee
HOOKS:
MANIFEST:
---
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: geared-marsupi-configmap
data:
myvalue: "Hello World"
drink: coffee
由于默认的values.yaml
文件中设置了favoriteDrink
的值为coffee
,则这个显示在了模板中。 可以在调用helm install
时设置--set
,很容易就能覆盖这个值。
由于--set
比默认的values.yaml
文件优先级更高,模板就生成了。
values文件也可以包含更多结构化的内容。比如我们可以在values.yaml
文件中创建一个favorite
项,然后添加一些key:
drink: coffee
food: pizza
现在需要稍微修改一些模板:
apiVersion: v1
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
myvalue: "Hello World"
drink: {{ .Values.favorite.drink }}
food: {{ .Values.favorite.food }}
如果需要从默认的value中删除key,可以将key设置为null
,Helm将在覆盖的value合并时删除这个key。
比如,稳定的Drupal允许在配置自定义镜像时配置活动探针。默认值为httpget
:
如果你想替换掉httpGet
用exec
重写活动探针,使用--set livenessProbe.exec.command=[cat,docroot/CHANGELOG.txt]
, Helm会把默认的key和重写的key合并在一起,从而生成以下YAML:
livenessProbe:
httpGet:
path: /user/login
port: http
exec:
command:
- cat
- docroot/CHANGELOG.txt
initialDelaySeconds: 120
因为Kubernetes中不能声明多个活动探针句柄,从而会应用发布会失败。为了解决这个问题,Helm可以指定通过设定null来删除livenessProbe.httpGet
:
在这之前我们已经看到了几个内置对象,并用它们将信息传递到模板中。现在来模板引擎的另一部分:方法和管道。