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

在深入 OPA 治理之前，必须重新夯实 Helm 的核心基础。Helm 是 Kubernetes 的包管理工具，它将应用的所有资源描述打包为一个 Chart，并通过模板引擎实现参数化，最终在集群中生成一个可独立管理的 Release。本节将拆解这四个核心概念。

2.1 Chart 标准目录结构

一个标准的 Helm Chart 是一个遵循固定布局的目录集合。以下是最小可用结构及关键文件说明：

2.2 模板引擎与渲染管线

Helm 使用 Go 标准 text/template 引擎，并内置了 60+ 模板函数（Sprig 库）。其核心工作流是：Values 注入 → 模板解析 → 输出 YAML。

• 模板语法：{{ .Values.replicaCount }} 引用 values 中的值；{{- define "mychart.labels" -}} 定义命名模板。
• 内置对象：.Values、.Release、.Chart、.Files、.Capabilities。
• 管道与函数：{{ .Values.image.tag | default "latest" | quote }}。

# 示例：templates/deployment.yaml 片段
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "mychart.fullname" . }}
  labels:
    {{- include "mychart.labels" . | nindent 4 }}
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      {{- include "mychart.selectorLabels" . | nindent 6 }}
  template:
    metadata:
      labels:
        {{- include "mychart.selectorLabels" . | nindent 8 }}
    spec:
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
          ports:
            - containerPort: {{ .Values.service.port }}

2.3 Values 文件与值覆盖优先级

Values 是 Chart 的参数化入口。Helm 定义了严格的值合并优先级（从低到高）：

1. Chart 内置 values.yaml（最低优先级）
2. 父 Chart 的 values.yaml（当存在子 Chart 依赖时）
3. 用户提供的 -f myvalues.yaml 文件（可多次指定）
4. 命令行 --set key=value 参数（最高优先级）

# values.yaml 示例
replicaCount: 2
image:
  repository: nginx
  tag: "1.25.3"
  pullPolicy: IfNotPresent
service:
  type: ClusterIP
  port: 80
ingress:
  enabled: false
  host: chart-example.local

2.4 Release 生命周期

一个 Release 是 Chart 在集群中的一次运行实例。Helm v3 完全基于 Kubernetes Secret 存储 Release 记录，不再需要服务端组件。其完整生命周期包含以下阶段：

每个 Release 都有一个递增的 Revision 号（从 1 开始）。Helm 默认保留最近 10 个 Revision 的历史记录，可通过 --history-max 调整。

2.5 核心概念关系总结

以下表格从 治理视角 梳理四个概念在发布流程中的角色：