ppt下载模板免费网站,北京电力交易中心官网,wordpress 相册 免费,公司变更股东需要多久命名模板 此时需要越过模板#xff0c;开始创建其他内容了。该部分我们会看到如何在一个文件中定义 命名模板#xff0c;并在其他地方使用。命名模板#xff08;有时称作一个部分或一个子模板#xff09;仅仅是在文件内部定义的模板#xff0c;并使用了一个名字。有两种创…命名模板 此时需要越过模板开始创建其他内容了。该部分我们会看到如何在一个文件中定义 命名模板并在其他地方使用。命名模板有时称作一个部分或一个子模板仅仅是在文件内部定义的模板并使用了一个名字。有两种创建方式和几种不同的使用方法。
在 流控制 部分我们介绍了三种声明和管理模板的方法definetemplate和block。在这部分我们将使用这三种操作并介绍一种特殊用途的include方法类似于template操作。
Helm | 流控制
命名模板时要记住一个重要细节模板名称是全局的。如果您想声明两个相同名称的模板哪个最后加载就使用哪个。因为在子chart中的模板和顶层模板一起编译命名时要注意chart特定名称。
一个常见的名称惯例是用chart名称作为模板前缀{{ define mychart.labels }}。使用特定chart名称作为前缀可以避免可能因为两个不同chart使用了相同名称的模板而引起的冲突。
这个规则同样适用于chart的不同版本。如果有mychart的1.0.0版本以一种方式定义了模板mychart的2.0.0版本修改了已有的命名模板那就会使用最后加载的版本。也可以在chart名称中添加版本来解决这个问题{{ define mychart.v1.labels }}和{{ define mychart.v2.labels }}。 局部的和_文件
目前为止我们已经使用了单个文件且单个文件中包含了单个模板。但Helm的模板语言允许您创建命名的嵌入式模板这样就可以在其他位置按名称访问。
在编写模板细节之前文件的命名惯例需要注意
1、templates/中的大多数文件被视为包含Kubernetes清单
2、NOTES.txt是个例外
3、命名以下划线_开始的文件则假定没有包含清单内容。这些文件不会渲染为Kubernetes对象定义但在其他chart模板中都可用。
这些文件用来存储局部和辅助对象实际上当我们第一次创建mychart时会看到一个名为_helpers.tpl的文件这个文件是模板局部的默认位置。 用define和template声明和使用模板
define操作允许我们在模板中创建一个命名模板语法如下
{{- define MY.NAME }} # body of template here
{{- end }}
{{- define MY.NAME }}# body of template here
{{- end }}
比如我们可以定义一个模板封装Kubernetes的标签
{{- define mychart.labels }} labels: generator: helm data: {{ now | htmlData }}
{{- end }}
{{- define mychart.labels }}labels:generator: helmdate: {{ now | htmlDate }}
{{- end }}
现在我们将模板嵌入到了已有的配置映射中然后使用template包含进来
{{- define mychart.labels}} labels: generator: helm date: {{ now | hemlDate }}
{{- end }}
apiVersion: v1
kind: ConfigMap
metadata: name: {{ .Release.Name }}-configmap {{- template mychart.labels }}
data: myvalue: Hello World {{- range $key,$val : .Values.favorite }} {{ $key }}: {{ $val | quote }} {{-end }}
{{- define mychart.labels }}labels:generator: helmdate: {{ now | htmlDate }}
{{- end }}
apiVersion: v1
kind: ConfigMap
metadata:name: {{ .Release.Name }}-configmap{{- template mychart.labels }}
data:myvalue: Hello World{{- range $key, $val : .Values.favorite }}{{ $key }}: {{ $val | quote }}{{- end }}
当模板引擎读取该文件时它会存储mychart.labels的引用直到template mychart.labels被调用。然后会按行渲染模板因此结果类似这样
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfidMap
metadata: name: running-panda-configmap labels: generator: helm data: 2016-11-02
data: myvalues: Hello World drink: coffee food: pizza
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:name: running-panda-configmaplabels:generator: helmdate: 2016-11-02
data:myvalue: Hello Worlddrink: coffeefood: pizza
注意define不会有输出除非像本示例一样用模板调用它。
按照惯例Helm chart将这些模板放置在局部文件中一般是_helpers.tpl。把这个方法移到那里
{{/* Generate basic labels */}}
{{- define mychart.labels }} labels: generator: helm date: {{ now | htmlDate }}
{{- end }}
{{/* Generate basic labels */}}
{{- define mychart.labels }}labels:generator: helmdate: {{ now | htmlDate }}
{{- end }}
按照惯例define方法会有个简单的文档块{{/*...*/}}来描述要做的事。
尽管这个定义是在_helpers.tpl中但它仍能访问configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata: name: {{ .Release.Name }}-configmap {{- template mychart.labels }}
data: myvalues: Hello World {{- range $key, $val : .Values.favorite }} {{ $key }}: {{ $val | quote }} {{- end }}
apiVersion: v1
kind: ConfigMap
metadata:name: {{ .Release.Name }}-configmap{{- template mychart.labels }}
data:myvalue: Hello World{{- range $key, $val : .Values.favorite }}{{ $key }}: {{ $val | quote }}{{- end }}
如上所述模板名称是全局的。因此如果两个模板使用相同名字声明会使用最后出现的那个。由于子chart中的模板和顶层模板一起编译最好用chart特定名称命名您的模板。常用的命名规则是用chart的名字作为模板的前缀{{ define mychart.labels }} 设置模板范围
在上面定义的模板中我们没有使用任何对象仅仅使用了方法。修改定义好的模板让其包含chart名称和版本号
{{/* Generator basic labels */}}
{{-define mychart.labels }} labels: generator: helm data: {{ now| htmlDate }} chart: {{ .Chart.Name }} version: {{ .Chart.Version }}
{{- end }}
{{/* Generate basic labels */}}
{{- define mychart.labels }}labels:generator: helmdate: {{ now | htmlDate }}chart: {{ .Chart.Name }}version: {{ .Chart.Version }}
{{- end }}
如果渲染这个会得到以下错误
$ helm install ---dry-run moldy-jaguar ./mychart
Error: unable to build kubernetes objects from release manifest: error validating : error validating data: [unknown object type nil in ConfigMap.metadata.labels.chart,unknown object type nil in ConfigMap.metadata.labels.version]
$ helm install --dry-run moldy-jaguar ./mychart
Error: unable to build kubernetes objects from release manifest: error validating : error validating data: [unknown object type nil in ConfigMap.metadata.labels.chart, unknown object type nil in ConfigMap.metadata.labels.version]
要查看渲染了什么可以用--disable-openapi-validation参数重新执行helm install --dry-run --disable-openapi-validation moldy-jaguar ./mychart。如果并不是我们想要的
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata: name: modly-jaguar-configmap labels: generator: helm data: 2021-03-06 chart: version:
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:name: moldy-jaguar-configmaplabels:generator: helmdate: 2021-03-06chart:version:
名字和版本号怎么了没有出现在我们定义的模板中。当一个使用define创建的命名模板被渲染时会接收被template调用传入的内容。在我们的事例中包含模板如下
{{- template mychart.labels }}
{{- template mychart.labels }}
没有内容传入所以模板中无法用.访问任何内容。但这个很容易解决只需要传递一个范围给模板
apiVersion: v1
kind: ConfigMap
metadata: name: {{ .Release.Name }}-configmap {{- template mychart.labels . }}
注意这个在template调用末尾传入的.,我们可以简单传入.Values或.Values.favorite或其他需求的范围。但一定要是顶层范围。
现在我们可以用helm install --dry-run --debug plinking-anaco ./mychart执行模板然后得到
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata: name: plinking-anaco-configmap labels: generator: helm data: 2021-03-06 chart: mychart version: 0.1.0
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:name: plinking-anaco-configmaplabels:generator: helmdate: 2021-03-06chart: mychartversion: 0.1.0
现在{{ .Chart.Name }}解析为mychart {{ .Chart.Version }}解析为0.1.0。 include方法
假设定义了一个简单模板如下
{{- define mychart.app -}}
app_name: {{ .Chart.Name }}
app_version: {{ .Chart.Version }}
{{- end -}}
{{- define mychart.app -}}
app_name: {{ .Chart.Name }}
app_version: {{ .Chart.Version }}
{{- end -}}
现在假设我想把这个插入到模板的labels:部分和data:部分
apiVersion: v1
kind: ConfigMap
metadata: name: {{ template mychart.app . }}
data: myvalues: Hello World
data: myvalue: Hello World {{- range $key, $val : .Values.favorite }} {{ $key }}: {{ $val | quote }}
{{ template mychart.app . }}
apiVersion: v1
kind: ConfigMap
metadata:name: {{ .Release.Name }}-configmaplabels:{{ template mychart.app . }}
data:myvalue: Hello World{{- range $key, $val : .Values.favorite }}{{ $key }}: {{ $val | quote }}{{- end }}
{{ template mychart.app . }}
如果渲染这个会得到以下错误
$ helm install --dry-run measly-whippet ./mychart
Error: unable to build kubernetes objects from release manifest: error validating : error validating data: [ValidationError(ConfigMap): unknown field app_name in io.k8s.api.core.v1.ConfigMap, ValidationError(ConfigMap): unknown field app_version in io.k8s.api.core.v1.ConfigMap]
$ helm install --dry-run measly-whippet ./mychart
Error: unable to build kubernetes objects from release manifest: error validating : error validating data: [ValidationError(ConfigMap): unknown field app_name in io.k8s.api.core.v1.ConfigMap, ValidationError(ConfigMap): unknown field app_version in io.k8s.api.core.v1.ConfigMap]
要查看渲染了什么可以用--disable-openapi-validation参数重新执行helm install --dry-run --disable-openapi-validation measly-whippet ./mychart。输入不是我们想要的
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata: name: measly-whippet-configmap labels: app_name: mychart
app_version: 0.1.0
data: myvalue: Hello World drink: coffee food: pizza
app_name: mychart
app_version: 0.1.0
注意两处的app_version缩进都不对为啥因为被替换的模板中文本是左右对齐的。由于template是一个行为不是方法无法将template调用的输出传给其他方法数据只是简单地按行插入。
为了处理这个问题Helm提供了一个template的可选项可以将模板内容导入当前管道然后传递给管道中的其他方法。
下面这个示例使用indent正确地缩进了mychart.app模板
apiVersion: v1
kind: ConfigMap
metadata: name: {{ .Release.Name }}-configmap labels:
{{ include mchart.app . | indent 4 }}
data: myvalue: Hello World {{- range $key,$val : .Values.favorite }} {{ $key }}: {{ $ val | quote }} {{- end }}
{{ include mychart.app . | indent 2 }}
apiVersion: v1
kind: ConfigMap
metadata:name: {{ .Release.Name }}-configmaplabels:
{{ include mychart.app . | indent 4 }}
data:myvalue: Hello World{{- range $key, $val : .Values.favorite }}{{ $key }}: {{ $val | quote }}{{- end }}
{{ include mychart.app . | indent 2 }}
现在生成的YAML每一部分都可以正确缩进了
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata: name: edgy-mole-configmap labels: app_name: mychart app_version: 0.1.0
data: myvalue: Hello World drink: coffee food: pizza app_name: mychart app_version: 0.1.0
# Source: mychart/templates/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:name: edgy-mole-configmaplabels:app_name: mychartapp_version: 0.1.0
data:myvalue: Hello Worlddrink: coffeefood: pizzaapp_name: mychartapp_version: 0.1.0
小贴士相较于使用template在helm中使用include被认为是更好的方式 只是为了更好地处理YAML文档的输出格式
有时我们需要导入内容但不是作为模板也就是按字面意义导入文件内容可以通过使用.Files对象访问文件来实现这将在下一部分展开描述。 ————————————
仅用于本人学习
来源Helm | Docs
