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

在深入面板化呈现与SLO护栏之前，必须重新夯实Helm的核心概念。Helm是Kubernetes的包管理器，它将一组K8s资源描述文件打包为Chart，通过模板引擎实现参数化，利用Values文件注入配置，最终在集群中创建可追溯的Release。本节从这四个维度建立统一认知基线。

2.1 Chart标准目录结构

一个标准的Helm Chart遵循固定目录布局，每个文件和文件夹都有明确职责：

2.2 模板引擎与渲染管线

Helm使用Go text/template 扩展语法，配合50+内置函数（Sprig库）实现动态资源生成。渲染管线分为三个阶段：

1. 值合并：将 values.yaml、用户传入的 --set 参数、父Chart值按优先级合并为最终Values对象。
2. 模板解析：遍历 templates/ 目录，对每个文件执行Go模板引擎，注入合并后的Values。
3. 输出校验：渲染结果必须是合法YAML/JSON，Helm会做基本结构校验，但不校验K8s资源语义。

# 模板示例：templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-{{ .Chart.Name }}
  labels:
    app.kubernetes.io/instance: {{ .Release.Name }}
spec:
  replicas: {{ .Values.replicaCount | default 1 }}
  selector:
    matchLabels:
      app: {{ .Chart.Name }}
  template:
    metadata:
      labels:
        app: {{ .Chart.Name }}
    spec:
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
          ports:
            - containerPort: {{ .Values.service.port }}

2.3 Values文件层级与作用域

Values文件是Helm配置注入的核心载体，支持嵌套结构和全局作用域。理解其层级规则是避免配置冲突的前提：

# values.yaml 示例：微服务部署配置
global:
  registry: "registry.example.com"
  environment: "production"

service:
  name: "user-api"
  replicaCount: 3
  image:
    repository: "user-service"
    tag: "v2.1.0"
  resources:
    requests:
      cpu: "500m"
      memory: "512Mi"
    limits:
      cpu: "1000m"
      memory: "1Gi"

ingress:
  enabled: true
  host: "api.example.com"
  tls: true

2.4 Release生命周期管理

Release是Helm在集群中安装Chart后生成的可追溯实例。每个Release都有唯一名称、版本号和修订历史。核心管理命令如下：

2.5 修订版本与回滚机制

Helm每次 install、upgrade、rollback 都会生成递增的修订版本号（revision）。回滚操作本质上是将Release的配置和模板重新渲染为指定修订版本的状态，然后应用到集群。

# 查看Release历史
$ helm history my-release --namespace production
REVISION    STATUS      CHART           APP VERSION    DESCRIPTION
1           deployed    my-app-1.0.0    1.0.0          Install complete
2           deployed    my-app-1.1.0    1.1.0          Upgrade complete
3           failed      my-app-1.2.0    1.2.0          Upgrade failed - timeout
4           deployed    my-app-1.1.0    1.1.0          Rollback to revision 2

# 回滚到指定修订版本
$ helm rollback my-release 2 --namespace production --wait

2.6 本章知识结构总结