2. Helm Chart 开发：Chart.yaml 规范、values.yaml 设计模式、模板函数与管道、命名模板

Helm Chart 是 Kubernetes 应用交付的标准打包格式。理解 Chart 的核心文件规范与模板引擎设计模式，是构建可维护、可复用的云原生基础设施的前提。本节将围绕 Chart.yaml 元数据声明、values.yaml 分层设计、模板函数与管道链式处理、以及命名模板的复用机制展开。

2.1 Chart.yaml 规范：元数据声明与版本约束

Chart.yaml 是 Chart 的“身份证”，位于 Chart 根目录。它定义了 Chart 的名称、版本、API 版本、依赖关系以及应用版本等关键元数据。Helm v3 要求 apiVersion 必须为 v2。

# Chart.yaml 示例
apiVersion: v2
name: dns-resolver
description: A DNS resolver with SLO-aware failover
type: application
version: 0.3.1
appVersion: "2.1.0"
kubeVersion: ">=1.22.0-0 <1.30.0-0"
dependencies:
  - name: common
    version: "2.x"
    repository: "https://charts.bitnami.com/bitnami"
annotations:
  category: Network
  licenses: Apache-2.0

2.2 values.yaml 设计模式：分层、默认与覆盖

values.yaml 是 Chart 的配置入口。良好的设计模式应遵循“三层结构”：全局默认值、组件级配置、环境覆盖。通过 YAML 的层级嵌套与 Helm 的 --values / --set 机制，实现配置的灵活组合。

# values.yaml 设计示例
global:
  imageRegistry: docker.io/myorg
  dnsDomain: cluster.local

resolver:
  name: dns-resolver
  replicas: 3
  image:
    repository: dns-resolver
    tag: "2.1.0"
    pullPolicy: IfNotPresent
  service:
    type: ClusterIP
    port: 53
    protocol: UDP
  resources:
    requests:
      cpu: 500m
      memory: 256Mi
    limits:
      cpu: 1000m
      memory: 512Mi

monitoring:
  enabled: true
  prometheusRule:
    sloLatency: "0.05"  # 50ms SLO 阈值

2.3 模板函数与管道：数据转换与链式处理

Helm 模板引擎基于 Go text/template，内置了 Sprig 函数库（超过 70 个函数）。管道（Pipeline） 允许将前一个函数的输出作为后一个函数的输入，形成链式处理流。这是 Helm 模板最强大的特性之一。

{{- /* 管道链式处理示例 */ -}}
{{- $imageFull := printf "%s/%s:%s" .Values.global.imageRegistry .Values.resolver.image.repository .Values.resolver.image.tag | lower -}}
image: {{ $imageFull | quote }}

{{- /* 默认值回退 */ -}}
replicas: {{ .Values.resolver.replicas | default 1 | int }}

{{- /* 字符串截断与格式化 */ -}}
name: {{ .Values.resolver.name | upper | trunc 12 | quote }}

{{- /* 列表过滤与连接 */ -}}
{{- $ports := list "53" "853" "5353" -}}
ports: {{ $ports | join "," | quote }}

2.4 命名模板：复用逻辑与作用域控制

命名模板（Named Templates）通过 define 关键字定义，使用 template 或 include 调用。它们通常存储在 templates/_helpers.tpl 文件中，用于封装重复的标签、名称生成、条件判断等逻辑。include 比 template 更灵活，因为它允许将输出传递给管道。

{{- /* _helpers.tpl 文件内容 */ -}}
{{- define "dns-resolver.labels" -}}
app.kubernetes.io/name: {{ .Chart.Name }}
app.kubernetes.io/instance: {{ .Release.Name }}
app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
app.kubernetes.io/managed-by: {{ .Release.Service }}
helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
{{- end -}}

{{- define "dns-resolver.selectorLabels" -}}
app.kubernetes.io/name: {{ .Chart.Name }}
app.kubernetes.io/instance: {{ .Release.Name }}
{{- end -}}

{{- define "dns-resolver.fullname" -}}
{{- $name := default .Chart.Name .Values.resolver.name -}}
{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
{{- end -}}

{{- /* 在 Deployment 模板中调用命名模板 */ -}}
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "dns-resolver.fullname" . }}
  labels:
    {{- include "dns-resolver.labels" . | nindent 4 }}
spec:
  replicas: {{ .Values.resolver.replicas }}
  selector:
    matchLabels:
      {{- include "dns-resolver.selectorLabels" . | nindent 6 }}
  template:
    metadata:
      labels:
        {{- include "dns-resolver.selectorLabels" . | nindent 8 }}
    spec:
      containers:
        - name: resolver
          image: {{ printf "%s/%s:%s" .Values.global.imageRegistry .Values.resolver.image.repository .Values.resolver.image.tag | lower | quote }}

2.5 综合实践：构建可测试的 Chart 结构

一个生产级的 Helm Chart 目录结构应遵循以下布局，确保模板、测试、文档与 CI 配置分离：

dns-resolver/
├── Chart.yaml                 # 元数据与依赖声明
├── values.yaml                # 默认配置值
├── values.schema.json         # JSON Schema 校验（可选）
├── charts/                    # 子 Chart 依赖（helm dependency 生成）
├── templates/
│   ├── _helpers.tpl           # 命名模板定义
│   ├── deployment.yaml        # 工作负载模板
│   ├── service.yaml           # 网络暴露模板
│   ├── servicemonitor.yaml    # 监控指标模板
│   ├── prometheusrule.yaml    # SLO 告警规则模板
│   ├── hpa.yaml               # 弹性伸缩模板
│   ├── configmap.yaml         # 配置注入模板
│   └── tests/
│       ├── test-connection.yaml  # 连通性测试
│       └── test-dns-resolution.yaml  # DNS 解析测试
├── ci/                        # CI 测试用的 values 覆盖文件
│   ├── prod-values.yaml
│   └── stress-values.yaml
└── README.md                  # 使用说明与参数文档