Helm 简介与快速开始

Kubernetes 部署的痛点

假设你要在 K8s 上部署一个完整的 WordPress 应用，需要手写以下 YAML 文件：

Helm 的解决方案

Helm 是 Kubernetes 的包管理器，类比 Linux 的 apt/yum 或 Node.js 的 npm。它将一组相关的 K8s YAML 文件打包为 Chart，通过 Go 模板实现参数化配置，用 Release 跟踪每次安装。

Helm 工作原理

  开发者                    Helm CLI                 Kubernetes
     │                          │                         │
     ├─ helm install myapp ──►  │  渲染模板               │
     │   values.yaml            │  (Go Template)          │
     │                          ├──── kubectl apply ─────►│  创建资源
     │                          │                         │
     │                          │  记录 Release 历史       │
     │                          │  (存入 K8s Secret)      │
     │                          │                         │
     ├─ helm rollback myapp 1 ► │  读取历史 Release        │
     │                          ├──── 还原旧版 YAML ──────►│  回滚资源
     │                          │                         │

三大核心概念

Helm 2 vs Helm 3：废除 Tiller

Helm 3 于 2019 年 11 月发布，移除了 Helm 2 中饱受诟病的服务端组件 Tiller。

安装 Helm CLI

Helm 是纯客户端工具，只需下载一个二进制文件即可。

# macOS（推荐 Homebrew）
brew install helm

# Linux（官方安装脚本）
curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
chmod +x get_helm.sh
./get_helm.sh

# Windows（Chocolatey）
choco install kubernetes-helm

# 验证安装
helm version
# 输出：version.BuildInfo{Version:"v3.14.0", ...}

添加 Chart 仓库

# 添加官方 Bitnami 仓库（包含 1000+ 高质量 Chart）
helm repo add bitnami https://charts.bitnami.com/bitnami

# 添加 Ingress-Nginx 仓库
helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx

# 更新本地仓库索引缓存
helm repo update

# 查看已添加的仓库
helm repo list

# 在仓库中搜索 Chart
helm search repo nginx

# 在 Artifact Hub（公共注册表）搜索
helm search hub wordpress

helm install：部署第一个 Chart

# 语法：helm install [release名称] [chart名称] [flags]

# 安装 nginx（使用 bitnami 仓库）
helm install my-nginx bitnami/nginx

# 指定 Namespace 安装（Namespace 必须已存在）
helm install my-nginx bitnami/nginx --namespace web --create-namespace

# 安装时覆盖 values
helm install my-nginx bitnami/nginx \
  --set replicaCount=2 \
  --set service.type=ClusterIP

# 查看安装结果
helm list
helm status my-nginx

# 查看 Chart 可配置的所有 values
helm show values bitnami/nginx

# 卸载
helm uninstall my-nginx

helm search：探索 Chart

# 搜索仓库中的 Chart（已添加的仓库）
helm search repo redis

# 查看所有可用版本
helm search repo bitnami/redis --versions

# 查看 Chart 详细信息
helm show chart bitnami/redis

# 查看 Chart 的 README
helm show readme bitnami/redis

# 查看所有信息（chart + values + readme）
helm show all bitnami/redis

# 创建命名空间
kubectl create namespace database

# 查看可配置的 values
helm show values bitnami/postgresql | head -60

# 安装 PostgreSQL
helm install pg bitnami/postgresql \
  --namespace database \
  --set auth.postgresPassword=mypassword \
  --set primary.persistence.size=5Gi

# 查看部署状态
helm status pg --namespace database
kubectl get pods -n database

# 验证数据库可访问
kubectl exec -it -n database pg-postgresql-0 -- psql -U postgres

核心术语速查