Helm Academy · 课时

标准 Fullname 与 Labels 辅助函数

Q: 「标准 Fullname 与 Labels 辅助函数」这节课中我会学到什么？

读取 helm create 自带的常规辅助函数 你通过在浏览器中直接运行的动手代码来练习 Helm Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

读取 helm create 自带的常规辅助函数

标准 Fullname 与 Labels 辅助函数 是 CoddyKit 上的免费 Helm Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Helm Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Helm Academy 课程共包含 4 节课。

现成可用的辅助模板

每个通过 helm create 创建的 chart 都会附带一个包含许多现成局部模板的 _helpers.tpl。了解它们可以避免您重新设计名称和标签。

name 辅助模板

chart.name 局部模板会返回 chart 的基本名称，并允许通过 values 进行覆盖。它是其他辅助模板的构建基础。

{{- define "mychart.name" -}}
{{- default .Chart.Name .Values.nameOverride -}}
{{- end -}}

fullname 辅助模板

chart.fullname 局部模板会构建唯一的资源名称，通常是将发布名称与 chart 名称连接起来，从而避免不同安装之间发生冲突。

name: {{ include "mychart.fullname" . }}

为什么 fullname 会截断

Kubernetes 名称最长为 63 个字符。fullname 辅助模板会通过 trunc 和 trimSuffix 处理结果，使其保持在这一限制以内。

{{ ... | trunc 63 | trimSuffix "-" }}

chart 标签辅助模板

chart.chart 局部模板会返回名称和版本字符串，用于 helm.sh/chart 标签。它记录了生成资源的 chart 版本。

helm.sh/chart: {{ include "mychart.chart" . }}

常用标签

chart.labels 局部模板会输出完整的推荐标签集合：管理者标签、chart 标签、版本以及合并后的选择器标签。

metadata:
  labels:
    {{- include "mychart.labels" . | nindent 4 }}

选择器标签彼此独立

chart.selectorLabels 局部模板只包含用于匹配 Pod 的不可变键值对。它会保持稳定，因此 Deployment 的选择器不会失效。

app.kubernetes.io/name: {{ include "mychart.name" . }}
app.kubernetes.io/instance: {{ .Release.Name }}

为什么有两个标签辅助模板

完整标签包含会在升级时变化的版本信息。选择器标签绝不能改变，因此 Helm 将它们放在一个独立且更小的局部模板中。

serviceAccountName 辅助模板

生成的 chart 还定义了 chart.serviceAccountName，它会根据是否需要创建服务账户来选择正确的账户名称。

serviceAccountName: {{ include "mychart.serviceAccountName" . }}

复用，不要重写

编写清单时，请调用这些标准辅助模板，而不是手动编写名称和标签。这样您会自动继承 Kubernetes 的最佳实践。

阅读您的 _helpers.tpl

打开 helm create 生成的文件，阅读其中的每个 define。理解这些少量的局部模板，就能掌握您今后遇到的大多数 chart。

快速检查

在 Deployment 的 selector.matchLabels 中，应该引用哪个辅助模板？

回顾：标准辅助模板

您已经了解了 helm create 提供的 fullname、标签和 selectorLabels 辅助模板。请在清单中调用它们，以获得一致且符合惯例的输出。🏷️

常见问题解答

「标准 Fullname 与 Labels 辅助函数」课时是免费的吗？

是的 — 「标准 Fullname 与 Labels 辅助函数」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Helm Academy 课程的其余内容，请升级到 CoddyKit PRO。 Helm Academy 课程共包含 4 节课。

「标准 Fullname 与 Labels 辅助函数」这节课中我会学到什么？

读取 helm create 自带的常规辅助函数你通过在浏览器中直接运行的动手代码来练习 Helm Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Helm Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Helm Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「标准 Fullname 与 Labels 辅助函数」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Helm Academy 课中编写并运行代码吗？

能。每节 Helm Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Helm Academy