Chart 基础结构与数据流向
Helm Chart 是 Kubernetes 应用的打包标准，其核心由三个部分组成：Chart.yaml 定义元数据（名称、版本、依赖），values.yaml 提供默认配置参数，以及 templates/ 目录存放 Kubernetes 资源的 Go 模板文件。Helm 的渲染机制基于 Go 模板引擎，在部署或升级时，会将 values.yaml 中的键值对注入到 templates/ 下的模板文件中，最终生成标准的 Kubernetes YAML 清单。理解这一数据流向是构建可复用、可配置应用包的基础。
在模板编写中，开发者需熟练掌握内置对象：.Values 用于访问用户传入的配置参数，.Release.Name 和 .Release.Namespace 提供当前发布实例的上下文信息，.Chart.Name 与 .Chart.Version 则用于标识当前 Chart 版本。
模板编写与默认配置管理
在实际开发中，模板文件通过 {{ .Values.xxx }} 语法动态引用配置。以 Deployment 为例，可将副本数、镜像地址与端口等可变参数抽离至 values.yaml。例如在 values.yaml 中定义 replicaCount: 2、image: { repository: nginx, tag: "1.25" }，随后在模板中通过 replicas: {{ .Values.replicaCount }} 与 image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}" 进行替换。需特别注意 YAML 缩进与模板函数的配合：使用 {{ .Values.resources | toYaml | indent 8 }} 可安全嵌套复杂结构，而字符串类型的值建议保留引号或使用 quote 函数，避免渲染后 YAML 解析失败。合理组织默认值能大幅降低后续维护成本。
配置覆盖机制与优先级规则
Helm 提供灵活的配置覆盖机制，其优先级遵循严格顺序：Chart 内置的 values.yaml 优先级最低，随后是父 Chart 传递的 values（若为子 Chart），接着是通过 -f 或 --values 指定的外部文件，最高优先级为命令行 --set 参数。例如执行 helm install myapp ./chart -f values-staging.yaml -f values-staging-db.yaml --set service.type=LoadBalancer 时，Helm 会先合并两个 -f 文件（后者优先），最后用 --set 覆盖对应字段。-f 适合管理多环境完整配置（如 dev/prod 差异），而 --set 适用于临时调试或覆盖少量参数。需注意多次使用 -f 时，后加载的文件会深度合并并覆盖先加载的同名键。
渲染验证与常见覆盖陷阱
在正式部署前，务必使用 helm template
