内置对象

对象可以通过模板引擎传递到模板中。当然您的代码也可以传递对象。(我们在使用with和range语句时,会看到示例)。有几种方式可以在模板中创建新对象,比如说我们后面会看到的tuple功能。

对象可以是非常简单的:仅有一个值。或者可以包含其他对象或方法。比如,Release对象可以包含其他对象(比如:Release.Name)和Files对象有一组方法。

在上一部分中,我们用{{ .Release.Name }}在模板中插入版本名称。Release是您可以在模板中访问的顶层对象之一。

1、Release

Release对象描述了版本发布本身。包含了一下对象:

1)Release.Name

release名称

2)Release.Namespace

版本中包含的命名空间(如果manifest没有覆盖的话)

3)Release.IsUpgrade

如果当前操作是升级或回滚的话,该值将被设置为true

4)Release.IsInstall

如果当前操作是安装的话,该值将被设置为true

5)Release.Revision

此次修订的版本号。安装时是1,每次升级或回滚都会自增

6)Release.Service

该service用来渲染当前模板。Helm里始终Helm

2、Values

Values对象是从values.yaml文件和用户提供的文件传进模板的。默认为空

3、Chart

Chart.yaml文件内容。Chart.yaml里的所有数据在这里都可以可访问的。比如{{ .Chart.Name }}-{{ .Chart.Version }}会打印出mychart-0.1.0

1)在 Chart指南 中列出了可获得属性

Helm | Chart

4、Files

在chart中提供访问所有的非特殊文件的对象。您不能使用它访问Template对象,只能访问其他文件。请查看这个 文件访问 部分了解更多信息

Helm | 在模板内部访问文件

1)Files.Get

通过文件名获取文件的方法。(.Files.Getconfig.ini)

2)Files.GetBytes

用字节数组代替字符串获取文件内容的方法。对图片之类的文件很有用

3)Files.Glob

用给定的shell glob模式匹配文件名返回文件列表的方法

4)Files.Lines

逐行读取文件内容的方法。迭代文件中每一行时很有用

5)Files.AsSecrets

使用Base 64编码字符串返回文件体的方法

6)Flies.AsConfig

使用YAML格式返回文件体的方法

5、Capabilities

提供关于Kubernetes集群支持功能的信息

1)Capabilities.APIVersions.Has $version说明集群中的版本(比如,batch/v1)或是资源(比如,apps/v1/Deployment)是否可用

2)Capabilities.KubeVersion和Capabilities.KubeVersion.Version是Kubernetes的版本号

3)Capabilities.KubeVersion.Major Kubernetes的主版本

4)Capabilities.KubeVersion.Minor Kubernetes的次版本

5)Capabilities.HelmVersion.Version 是当前Helm语义格式的版本

6)Capabilities.HelmVersion.GitCommit Helm的git sha值

7)Capabilities.HelmVersion.GitTreeState 是Helm git树的状态

8)Capabilities.HelmVersion.GoVersion 是使用的Go编译器版本

6、Template

包含当前被执行的当前模板信息

1)Template.Name

当前模板的命名空间文件路径(e.g. mychart/templates/mytemplate.yaml)

2)Template.BasePath

当前chart模板目录的路径(e.g. mychart/templates)

内置的值都是以大写字母开始。这是符合Go的命名惯例。当您创建自己的名称时,可以按照团队约定自由设置。就像很多您在 Artifact Hub 中看到的chart,其图案对选择使用首字母小写将本地名称与内置对象区分开,本指南中我们也遵循该惯例。

Artifact Hub

————————————

仅用于本人学习

来源:Helm | Docs

01-29 20:47