合理且有文档说明的默认值
设计开箱即用且安全的值
合理且有文档说明的默认值 是 CoddyKit 上的免费 Helm Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Helm Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Helm Academy 课程共包含 4 节课。
默认值决定第一印象
大多数人安装您的 chart 时不会提供任何覆盖值，因此 values.yaml 中的默认值决定了它能否首次顺利运行，还是会令人困惑地失败。
开箱即用且安全
目标是让默认值能够在全新的集群上顺利安装，不产生意外。新用户在不带任何选项的情况下运行 helm install，也应该得到一个可用的发布。
记录每个键
在每个值上方添加注释，说明它的作用和可接受范围。values.yaml 同时也是 chart 的配置手册。
# Number of pod replicas to run
replicaCount: 1优先使用扁平且可预测的键
将相关设置归入清晰的父级键下，例如 image 或 resources。可预测的结构让覆盖值更容易编写和审查。
image:
repository: nginx
tag: "1.27"
pullPolicy: IfNotPresent保守的资源默认值
提供适中的资源请求，让 chart 能适应小型集群；但将限制值保留为注释或空值，以便用户根据自己的工作负载进行调整。
使用布尔值控制可选功能
使用启用标志控制 Ingress 等可选资源。默认将其关闭，让基本安装保持精简且可预测。
ingress:
enabled: false尽可能避免必填输入
仅对确实无法提供合理默认值的内容使用 required 函数，例如域名。必填输入越少，首次安装就越顺畅。
{{ required "ingress.host is required" .Values.ingress.host }}类型保持一致
保持每个值的类型稳定。如果 tag 是字符串，就始终将它加引号，以免 1.27 被解析为数字并导致镜像引用失效。
tag: "1.27"公开配置，不要硬编码
如果用户可能合理地修改某项设置，就应当将其放入 values.yaml，而不是隐藏在模板中。灵活性来自 values。
向用户展示可调选项
任何人都可以使用 helm show values 列出所有选项。注释完善的默认值会让该命令立即成为准确的文档。
helm show values ./mychart添加架构以确保安全
values.schema.json 文件会在渲染前验证用户输入，用清晰的错误信息捕获拼写错误和类型错误，而不是生成损坏的清单。🛡️
快速检查
您希望有一个只有在请求时才出现的可选 Ingress。最佳默认值是什么？
回顾
您了解了合理的默认值、清晰的注释、一致的类型以及选择启用的功能如何让 chart 更安全、更友好。values.yaml 同时承担文档和配置的作用。✅
常见问题解答
「合理且有文档说明的默认值」课时是免费的吗？
是的 — 「合理且有文档说明的默认值」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Helm Academy 课程的其余内容，请升级到 CoddyKit PRO。 Helm Academy 课程共包含 4 节课。
「合理且有文档说明的默认值」这节课中我会学到什么？
设计开箱即用且安全的值 你通过在浏览器中直接运行的动手代码来练习 Helm Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Helm Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Helm Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「合理且有文档说明的默认值」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Helm Academy 课中编写并运行代码吗？
能。每节 Helm Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。