2. Helm 安装与配置

本章将指导你在主流操作系统上完成 Helm 的安装、仓库配置与基础验证。安装方式分为包管理器安装和二进制脚本安装两种，推荐生产环境使用官方脚本或包管理器以保持版本一致性。

2.1 安装 Helm

2.1.1 Linux 安装

方式一：官方安装脚本（推荐）

curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
chmod 700 get_helm.sh
./get_helm.sh

方式二：apt（Debian/Ubuntu）

curl https://baltocdn.com/helm/signing.asc | gpg --dearmor | sudo tee /usr/share/keyrings/helm.gpg > /dev/null
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/helm.gpg] https://baltocdn.com/helm/stable/debian/ all main" | sudo tee /etc/apt/sources.list.d/helm-stable-debian.list
sudo apt-get update
sudo apt-get install helm

方式三：yum（RHEL/CentOS）

sudo yum install -y https://get.helm.sh/helm-latest-linux-amd64.tar.gz
# 或使用 rpm 仓库
curl -fsSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

2.1.2 macOS 安装

方式一：Homebrew（推荐）

brew install helm

方式二：MacPorts

sudo port install helm

2.1.3 Windows 安装

方式一：Chocolatey

choco install kubernetes-helm

方式二：Scoop

scoop install helm

方式三：手动下载
从 Helm Releases 下载 helm-v3.x.x-windows-amd64.zip，解压后将 helm.exe 所在目录加入系统 PATH 环境变量。

2.2 配置 Helm 仓库

Helm 使用 Chart 仓库 作为应用分发的中央存储。安装后需要添加官方或第三方仓库才能搜索和安装 Chart。

2.2.1 添加官方稳定仓库

helm repo add stable https://charts.helm.sh/stable
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

2.2.2 常用公共仓库列表

2.2.3 仓库管理常用命令

# 列出已添加的仓库
helm repo list

# 更新仓库索引（获取最新 Chart 列表）
helm repo update

# 移除仓库
helm repo remove <repo-name>

2.3 验证安装

完成安装和仓库配置后，通过以下步骤验证 Helm 是否正常工作：

1. 检查版本

   helm version --short
   # 预期输出: v3.x.x+... (例如 v3.14.0+g2c3c5b6)

2. 搜索 Chart

   helm search repo bitnami/nginx
   # 应返回 nginx Chart 的版本列表

3. 查看仓库列表

   helm repo list
   # 应显示已添加的仓库名称和 URL

4. 安装测试 Chart

   helm install test-nginx bitnami/nginx --dry-run --debug
   # --dry-run 模拟安装，不实际部署到集群

2.4 Helm 常用命令概览

Helm 3 的命令体系围绕 Chart 管理、Release 管理 和 仓库管理 三大核心功能展开。下表列出日常使用频率最高的命令：

2.5 Helm 安装与配置流程总览

下图展示了从安装 Helm 到首次部署 Chart 的完整链路：

2.6 常见安装问题与排查