0Pricing
DevOps Bootcamp · 课时

模板中的注释与引号

模板注释和 quote 辅助函数

模板中的注释与引号 是 CoddyKit 上的免费 DevOps Bootcamp 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 DevOps Bootcamp 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 DevOps Bootcamp 课程共包含 4 节课。

两种注释

Chart 有两种添加说明的方式:普通 YAML 注释和特殊的模板注释。它们在渲染时的行为截然不同。

YAML 注释会保留

以井号开头的行是普通 YAML 注释。它会直接传递,并保留在渲染后的输出中供任何人阅读。

# this note appears in the final manifest

模板注释会消失

Helm 有一种专用注释,会完全消失。将文本包裹在 {{/* */}} 中,Helm 引擎会在输出前将其移除。

{{/* this note is removed at render time */}}

为什么有两种写法

使用井号记录已部署的 YAML。使用模板注释记录用户绝不应看到的模板逻辑说明。📝

注释掉一个操作

模板注释很适合用于停用代码。将一个操作包裹在 {{/* */}} 中,Helm 就会跳过它,不进行渲染,也不会产生错误。

接下来学习引号

YAML 经常会自行推断类型。值 1.10 可能变成 1.1,yes 也可能变成 true。使用引号可以强制将其作为明确的字符串。

quote 函数

Helm 自带 quote 函数,可以为您将值包裹在双引号中,这样渲染后的字段就明确是字符串。

tag: {{ quote .Values.image.tag }}

将 quote 用作管道

您通常会看到 quote 以管道形式写在操作末尾。它读起来很自然:先取得这个值,然后为它加引号。

tag: {{ .Values.image.tag | quote }}

为什么引号很重要

不加引号时,像 1.20 这样的版本号可能会悄悄丢失末尾的零,变成 1.2,从而破坏镜像引用。加引号可以避免这种情况。⚠️

数字也需要 quote

Kubernetes 有时需要将数字保留为文本,例如注解中的端口号。通过管道传给 quote,可以安全地将其保留为字符串。

手动添加引号也可以

您也可以直接在 YAML 中写出字面引号。当值来自模板时,quote 函数只是以编程方式完成同样的工作。

port: "{{ .Values.port }}"

快速检查

您添加了一条不应出现在已部署 YAML 中的说明。

回顾

现在您可以使用 {{/* */}} 隐藏说明,使用井号保留可见说明,并使用 quote 函数强制生成规范的字符串。🎯

常见问题解答

「模板中的注释与引号」课时是免费的吗?

是的 — 「模板中的注释与引号」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 DevOps Bootcamp 课程的其余内容,请升级到 CoddyKit PRO。 DevOps Bootcamp 课程共包含 4 节课。

「模板中的注释与引号」这节课中我会学到什么?

模板注释和 quote 辅助函数 你通过在浏览器中直接运行的动手代码来练习 DevOps Bootcamp,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 DevOps Bootcamp 需要有经验吗?

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

「模板中的注释与引号」课时需要多长时间?

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

我能在这节 DevOps Bootcamp 课中编写并运行代码吗?

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

此课程中的所有课时

  1. 双大括号动作语法
  2. 使用短横线标记裁剪空白
  3. 模板中的注释与引号
  4. 常见 YAML 缩进陷阱
← 返回 DevOps Bootcamp