Skip to content

A Helm 的核心价值与三大核心概念 ​

在云原生微服务体系中,部署一个标准服务(如高可用 MySQL 或 Redis)往往涉及一系列繁琐的 YAML 清单:Service、Secret、PVC、ConfigMap、Deployment/StatefulSet。 如果手工管理原生 YAML,将面临环境参数硬编码、多版本追踪困难、无法一键回滚的灾难。

Helm 是 Kubernetes 世界的包管理工具(相当于 Linux 下的 apt 或 yum),具备三大核心概念:

kv
Chart: 模板化的打包集合,包含运行应用所必需的全部 Kubernetes 资源清单
Repository: 集中存放与共享发布 Chart 包的制品仓库 (如 ArtifactHub、Harbor)
Release: Chart 在 Kubernetes 集群中运行的实际部署实例 (具备独立版本与状态)
flow
[工程师编写 Chart 模板] -> [打包为 tar.gz 推送至 Chart 仓库]
[打包为 tar.gz 推送至 Chart 仓库] -> [helm install 部署至集群]
[helm install 部署至集群] -> [动态渲染生成原生 YAML 清单]
[动态渲染生成原生 YAML 清单] -> [API Server 创建 Release 实例资源]
group 生命周期链路: helm install 部署至集群, 动态渲染生成原生 YAML 清单, API Server 创建 Release 实例资源

B Helm 核心指令速查全集 ​

运维阶段常用指令示例核心行为与作用说明
仓库管理helm repo add bitnami https://charts.bitnami.com/bitnami添加远程公共或私有 Chart 仓库源
检索检索helm search repo mysql在已注册仓库中搜索匹配的 Chart 与可用版本号
安装部署helm install my-db bitnami/mysql -n prod -f my-values.yaml将 Chart 渲染并作为名为 my-db 的 Release 部署到集群
在线升级helm upgrade my-db bitnami/mysql --set auth.rootPassword=newpass在线应用新参数或新镜像,触发无缝平滑升级
版本回滚helm rollback my-db 2秒级将 Release 回滚至历史第 2 次发布的完整状态
历史追踪helm history my-db列出该 Release 的所有历史变更版本、时间与描述
卸载清理helm uninstall my-db -n prod级联清理该 Release 关联的所有 Kubernetes 资源
callout
当同一个参数在多处被定义时,Helm 严格遵循以下合并优先级(自顶向下覆盖):
1. **最高优先**:CLI 命令行 `--set key=value` 或 `--set-string`
2. **次高优先**:命令行通过 `-f my-values.yaml` 指定的外部参数文件
3. **最低保底**:Chart 包内部自带的默认 `values.yaml` 文件

C Chart 包规范目录结构拆解 ​

一个符合 Helm 官方标准的 Chart 必须具备严谨的目录拓扑:

tree
my-app-chart/ | 根目录
  Chart.yaml | 必须声明:apiVersion, name, version;可选 type (application 可独立部署应用 / library 纯模板库模块) 与 dependencies 依赖列表
  values.yaml | 默认配置参数字典,供 templates 模板插值引用
  values.schema.json | 可选文件,使用 JSON Schema 校验用户传入的 values 参数合法性
  charts/ | 可选目录,执行 helm dependency update 后存放依赖的子 Chart 包 (Sub-charts)
  crds/ | 可选目录,存放自定义资源定义 CRD 纯 YAML(不可写模板语法,在其余资源前优先安装)
  templates/ | 核心资源模板目录
    deployment.yaml | 包含 Go 模板语法的无状态负载声明
    service.yaml | 动态端口暴露服务声明
    _helpers.tpl | 辅助模板函数定义(define 定义可复用片段,其他模板通过 include 纸面引入)
    NOTES.txt | 安装或升级完成后,在终端向用户打印的使用指南与连接命令(支持模板变量取值)
callout
- **同 Chart 多次依赖别名 (`alias`)**:当一个父 Chart 需要依赖两次相同的 `redis` 子 Chart(一个用作缓存 `redis-cache`,一个用作会话存储 `redis-session`)时,可在 `Chart.yaml` 的 `dependencies` 中使用 `alias: redis-cache` 与 `alias: redis-session` 区分,从而在 `values.yaml` 中分别独立配置两套 Redis 的副本数与内存配额,避免冲突!
- **多级 Chart 变量作用域**:
  1. 当前 Chart 自身参数通过 `.Values.xxx` 访问;
  2. 给子 Chart(如 `mysql`)传参,只需在父 Chart 的 `values.yaml` 下建立同名键 `mysql:` 并在其下书写参数;
  3. **全局跨层级共享参数 (`global`)**:在父 Chart 的 `values.yaml` 下定义 `global:` 字段,所有深层嵌套的子 Chart 均可通过 `.Values.global.xxx` 直接读取!

D Go Template 模板引擎进阶语法 ​

1. 六大内置对象 ​

  • .Values:访问 values.yaml 或外部 --set / -f 传入的实参(支持嵌套对象与列表,列表可用 {{ index .Values.arr 0 }} 取下标)。
  • .Release:当前发布实例元数据(.Release.Name, .Release.Namespace, .Release.IsUpgrade, .Release.IsInstall, .Release.Revision)。
  • .Chart:当前 Chart.yaml 的元数据信息(如 .Chart.Name, .Chart.Version)。
  • .Files:访问 Chart 包内非 templates/ 目录下的普通静态配置文件(注意 Chart 包整体大小限制需小于 1MB),支持 .Files.Get "config.toml"、.Files.GetBytes、.Files.Lines 逐行读取。
  • .Capabilities:获取目标 Kubernetes 集群支持的能力与版本信息(.Capabilities.APIVersions, .Capabilities.KubeVersion)。
  • .Template:获取当前正在渲染的模板文件自身信息(.Template.Name, .Template.BasePath)。

2. 管道、函数与 template vs include ​

yaml
# 管道链式处理:默认值 -> 转大写 -> 重复3次 -> 添加双引号({{- 与 -}} 用于消除模板首尾多余空格换行)
food: {{ .Values.favorite.food | default "rice" | upper | repeat 3 | quote }}

# template 与 include 的核心区别:
# template 仅原样内联输出,无法在后面接管道控制缩进;
# include 返回字符串,可配合 indent / nindent 精准控制每一行的 YAML 缩进(强烈推荐)!
labels:
{{- include "my-app.labels" . | nindent 4 }}

3. 流程控制、with 作用域、range 循环与外部文件注入 ​

yaml
# 1. if / else 条件判断(布尔 false、数字 0、空字符串 ""、nil、空集合均视为 false;支持 eq/ne/lt/gt)
{{- if eq .Values.env "prod" }}
replicas: 5
{{- else }}
replicas: 1
{{- end }}

# 2. with 切换当前作用域 "."(缩短深层引用链;在 with 或 range 内部若需访问根作用域,使用 "$." 如 $.Release.Name)
{{- with .Values.app.config.database }}
dbHost: {{ .host | quote }}
dbPort: {{ .port }}
{{- end }}

# 3. 变量定义 ($var := ...) 与 range 循环(支持遍历列表、字典或 tuple 元组,結合 .Files.Get 批量生成 ConfigMap)
{{- $relName := .Release.Name -}}
data:
  {{- range tuple "config1.toml" "config2.toml" "config3.toml" }}
  {{ . }}: |-
    {{ $.Files.Get . | indent 4 }}
  {{- end }}

E Chart 仓库建设:Nginx 静态站与 Harbor 工业级集成 ​

flow
[方案 A: 极简 Nginx 静态源] -> [helm package 生成 .tgz]
[helm package 生成 .tgz] -> [helm repo index 生成 index.yaml]
[helm repo index 生成 index.yaml] -> (Nginx 静态 Web 目录托管)
[方案 B: 企业级 Harbor 制品库] -> [helm registry login 登录认证]
[helm registry login 登录认证] -> [helm push 将 OCI Chart 规范包推入 Harbor]
[helm push 将 OCI Chart 规范包推入 Harbor] -> (兼具 Docker 镜像与 Chart 版本安全管控)
group 仓库建设双轨: 方案 A: 极简 Nginx 静态源, 方案 B: 企业级 Harbor 制品库

← 返回 Kubernetes 知识库总索引