主题
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 制品库