2. Helm 基础回顾：Chart 结构、模板引擎、Values 文件、Release 生命周期管理

在深入 Prometheus 监控优化之前，必须牢固掌握 Helm 的核心概念。Helm 是 Kubernetes 的包管理工具，它将应用及其依赖打包为 Chart，通过 模板引擎 和 Values 文件 实现参数化部署，并管理每个部署实例（Release）的完整生命周期。本节将逐一拆解这些基础组件，为后续资源模型性能分析奠定基础。

2.1 Chart 目录结构与核心文件

一个标准的 Helm Chart 是一个遵循特定布局的目录集合。理解其结构是编写和调试监控 Chart 的前提。

2.2 模板引擎与内置对象

Helm 使用 Go 的 text/template 引擎，并扩展了 sprig 函数库。模板文件通过访问 内置对象 获取动态数据，从而生成最终的 Kubernetes 资源清单。

• 核心内置对象：
  • .Values：从 values.yaml 和用户提供的 values 文件合并后的值。
  • .Release：当前 Release 的元数据，包括 .Name、.Namespace、.Service、.Revision。
  • .Chart：从 Chart.yaml 读取的 Chart 元数据。
  • .Files：访问 Chart 中非模板文件（如配置文件）的对象。
  • .Capabilities：Kubernetes 集群版本和能力信息。
• 常用模板函数：
  • quote、default、required：值处理与校验。
  • include、tpl：模板复用与动态渲染。
  • toYaml、fromYaml：YAML 格式转换。
  • lookup：在运行时查询集群现有资源。

# 示例：templates/deployment.yaml 片段
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-prometheus-server
  labels:
    app: prometheus
    release: {{ .Release.Name }}
spec:
  replicas: {{ .Values.server.replicaCount | default 1 }}
  template:
    spec:
      containers:
        - name: prometheus-server
          image: "{{ .Values.server.image.repository }}:{{ .Values.server.image.tag }}"
          resources:
            {{- toYaml .Values.server.resources | nindent 12 }}

2.3 Values 文件优先级与合并策略

Helm 允许通过多个来源提供配置值，并遵循严格的优先级顺序。理解这一机制对于覆盖 Prometheus 的默认资源设置至关重要。

1. Chart 内置：charts/<chart-name>/values.yaml（子 Chart 默认值）。
2. 父 Chart 默认：values.yaml（根 Chart 默认值）。
3. 用户提供的 values 文件：通过 -f 或 --values 指定，后指定的文件优先级更高。
4. 命令行设置：通过 --set 或 --set-string 直接传入，优先级最高。

2.4 Release 生命周期管理

Release 是 Helm 管理的核心实体，代表 Chart 的一次部署实例。其生命周期包含安装、升级、回滚、卸载等操作，每个操作都会生成一个新的 Revision（修订版本）。

• helm install：创建 Release，状态变为 deployed。如果安装过程中出错，状态变为 failed。
• helm upgrade：更新 Release。旧版本变为 superseded，新版本变为 deployed。
• helm rollback：回滚到指定 Revision。被回滚的版本变为 deployed，当前版本变为 superseded。
• helm uninstall：卸载 Release，状态变为 uninstalled。默认保留 Release 记录，可通过 --keep-history 保留 Revision 历史。

2.5 依赖管理与子 Chart

Prometheus 社区 Chart 通常依赖多个子 Chart（如 kube-state-metrics、prometheus-node-exporter）。依赖通过 Chart.yaml 中的 dependencies 字段声明。

# Chart.yaml 依赖声明示例
dependencies:
  - name: kube-state-metrics
    version: "5.x"
    repository: "https://prometheus-community.github.io/helm-charts"
    condition: kube-state-metrics.enabled
    alias: ksm
  - name: prometheus-node-exporter
    version: "4.x"
    repository: "https://prometheus-community.github.io/helm-charts"
    condition: nodeExporter.enabled

• 条件依赖：通过 condition 字段控制子 Chart 是否启用，对应 values 中的布尔值。
• 别名：通过 alias 避免子 Chart 名称冲突，并在模板中通过别名访问其 values。
• 依赖更新：执行 helm dependency update 下载依赖到 charts/ 目录，并生成 Chart.lock 文件锁定版本。