Helm Academy · 课时

标准标签与命名约定

Q: 「标准标签与命名约定」这节课中我会学到什么？

遵循推荐的标签和完整名称规则 你通过在浏览器中直接运行的动手代码来练习 Helm Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

遵循推荐的标签和完整名称规则

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

标签为何重要

您的 chart 创建的每个资源都需要标签，这样人员和工具才能找到、分组，并在之后清理这些资源。优质标签是整洁集群的基础。

name 与 instance

app.kubernetes.io/name 标签表示应用类型，而 app.kubernetes.io/instance 表示这次具体的发布。同一个 chart 的两次安装共享 name，但 instance 不同。

managed-by 告诉工具所有者

将 app.kubernetes.io/managed-by 设置为 Helm，这样任何查看集群的人都能立即知道这些资源由 Helm 管理和更新。

app.kubernetes.io/managed-by: Helm

版本标签

使用 chart 的 appVersion 添加 app.kubernetes.io/version，并根据 chart 名称和版本添加 helm.sh/chart。两者结合后，就能准确标明发布的内容。🏷️

选择器标签保持稳定

Deployment 的选择器标签在安装后绝不能更改，因此 chart 使用一小组不可变的标签：仅包含 name 和 instance，不包含 version。

selector:
  matchLabels:
    app.kubernetes.io/name: myapp
    app.kubernetes.io/instance: myapp-prod

fullname 约定

Helm 使用由发布名称和 chart 名称拼接而成的 fullname 为资源命名，例如 myapp-prod-web，这样两个发布就不会产生资源名称冲突。

为何限制为 63 个字符

Kubernetes 将名称限制为63 个字符，因此标准 fullname 辅助模板会截断过长的名称，并去除末尾的连字符以保持名称有效。

{{ include "myapp.fullname" . }}

通过 _helpers.tpl 复用

在 _helpers.tpl 中将标签定义一次，作为命名模板，然后在每个资源中引入它。只需在一个地方修改，就能让所有清单保持一致。

{{ include "myapp.labels" . | nindent 4 }}

不要滥用标签

标签用于选择和分组，而不是存储大量数据。请将描述性且不用于标识的信息放入注释中，以便选择器保持高效。

检查已发布的内容

安装后运行 kubectl get pods --show-labels，确认您的资源带有所需的标签。既要信任，也要验证。

kubectl get all -l app.kubernetes.io/instance=myapp-prod

快速检查

哪个标签可以区分同一个 chart 的一个发布与另一次安装？

回顾

您了解了推荐标签、fullname 约定、63 个字符的限制，以及选择器标签为何要保持稳定。一致的命名让集群保持整洁。✅

常见问题解答