2. Helm 基础回顾：Chart 结构、Release 概念、模板引擎与 Values 注入

在深入镜像拉取加速策略之前，必须牢固掌握 Helm 的核心基础。Helm 是 Kubernetes 的包管理工具，它将应用的定义、配置和依赖打包为 Chart，并通过 Release 机制实现可重复的部署与管理。本节将系统回顾 Chart 目录结构、Release 生命周期、模板引擎语法以及 Values 注入机制，为后续策略命中率与误报分析奠定基础。

2.1 Chart 目录结构

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

2.2 Release 概念与生命周期

Release 是 Helm 管理的核心抽象。它代表 Chart 的一次独立部署实例。每次执行 helm install 都会创建一个新的 Release；每次 helm upgrade 则生成该 Release 的新版本。

• Release 名称：在命名空间内唯一，用于标识和管理部署。
• Release 版本：每次升级递增，支持回滚到任意历史版本。
• Release 状态：包括 deployed、failed、pending-install、uninstalled 等。

2.3 模板引擎与模板函数

Helm 使用 Go 语言的 text/template 引擎，并扩展了 60+ 个内置模板函数。模板文件位于 templates/ 目录，通过 {{ }} 语法注入动态值。

2.3.1 核心语法

• 值注入：{{ .Values.replicaCount }} —— 从 values.yaml 或命令行读取。
• 内置对象：.Values、.Release、.Chart、.Files、.Capabilities。
• 流程控制：if/else、with、range。
• 管道与函数：{{ .Values.image.tag | default "latest" | quote }}。

2.3.2 常用模板函数示例

2.4 Values 注入机制

Values 是 Helm 模板的数据源，其注入遵循明确的优先级规则（从低到高）：

1. Chart 内嵌的 values.yaml —— 最低优先级，作为默认值。
2. 父 Chart 的 values.yaml —— 当存在子 Chart 依赖时，父 Chart 的值可覆盖子 Chart 的默认值。
3. 用户提供的 -f values-custom.yaml —— 通过 --values 或 -f 指定。
4. 命令行 --set 参数 —— 最高优先级，用于临时覆盖。

2.5 典型模板示例：Deployment 中的镜像配置

以下是一个标准的 Deployment 模板片段，展示了 Values 注入与模板函数的实际应用：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "myapp.fullname" . }}
  labels:
    {{- include "myapp.labels" . | nindent 4 }}
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app.kubernetes.io/name: {{ include "myapp.name" . }}
  template:
    metadata:
      labels:
        app.kubernetes.io/name: {{ include "myapp.name" . }}
    spec:
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default "latest" }}"
          imagePullPolicy: {{ .Values.image.pullPolicy | default "IfNotPresent" }}
          ports:
            - containerPort: {{ .Values.service.port }}