Kubernetes Helm 入门实战：Chart 结构解析与常用命令速查，助你轻松部署应用

2025/7/6 09:28:15 218 0 0 0

如果你正在拥抱 Kubernetes，那么 Helm 绝对是你不可或缺的利器。它可以帮助你轻松管理和部署复杂的 Kubernetes 应用。但对于初学者来说，Helm 的 Chart 结构和各种命令可能会让人感到有些头疼。别担心，本文将带你一步步了解 Helm 的核心概念，并提供一个实战演练，让你快速上手。

什么是 Helm？

Helm 被誉为 Kubernetes 的包管理器。想象一下，如果没有 apt、yum 或 npm，软件的安装和管理将会变得多么痛苦。Helm 的作用类似，它可以将一组 Kubernetes 资源打包成一个 Chart，方便部署、升级、回滚和共享。简单来说，Helm 解决了 Kubernetes 应用部署的复杂性问题，让应用管理更加高效。

Helm 的核心概念

在深入学习 Helm 之前，我们需要了解几个核心概念：

Chart: Helm 的包格式，包含描述 Kubernetes 资源的所有必要信息，例如 Deployment、Service 等。
Release: Chart 的一个运行实例。你可以多次部署同一个 Chart，每次部署都会创建一个新的 Release。例如，你可以部署一个名为 my-nginx 的 Chart，然后创建多个 Release，如 my-nginx-dev、my-nginx-prod，分别对应开发环境和生产环境。
Repository: Chart 的仓库，用于存储和分享 Chart。类似于 Docker Hub，你可以从公共的 Helm Repository 下载 Chart，也可以创建私有的 Repository。

Chart 结构详解

一个典型的 Helm Chart 目录结构如下：

my-chart/
  ├── Chart.yaml          # Chart 的元数据，如名称、版本、描述等
  ├── values.yaml         # Chart 的默认配置值
  ├── templates/          # 包含 Kubernetes 资源定义的模板文件
  │   ├── deployment.yaml # Deployment 资源定义
  │   ├── service.yaml    # Service 资源定义
  │   └── ...
  ├── charts/             # 包含依赖的子 Chart
  └── README.md           # Chart 的说明文档

Chart.yaml

Chart.yaml 文件是 Chart 的核心，它定义了 Chart 的元数据。以下是一个示例：

apiVersion: v2
name: my-nginx
description: A simple Nginx deployment
type: application
version: 0.1.0
appVersion: 1.21.0

apiVersion: Chart API 版本，目前常用的是 v2。
name: Chart 的名称，必须是唯一的。
description: Chart 的描述信息。
type: Chart 的类型，可以是 application 或 library。application 表示一个完整的应用，library 表示一个可重用的组件。
version: Chart 的版本号，遵循语义化版本规范。
appVersion: 应用的版本号，例如 Nginx 的版本。

values.yaml

values.yaml 文件定义了 Chart 的默认配置值。这些值可以在部署时被覆盖，从而实现 Chart 的定制化。以下是一个示例：

replicaCount: 1

image:
  repository: nginx
  tag: 1.21.0
  pullPolicy: IfNotPresent

service:
  type: ClusterIP
  port: 80

templates 目录

templates 目录包含 Kubernetes 资源定义的模板文件。这些文件使用 Go 模板语言，可以根据 values.yaml 中的配置值动态生成 Kubernetes 资源。例如，deployment.yaml 文件可能如下所示：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-deployment
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app: {{ .Release.Name }}
  template:
    metadata:
      labels:
        app: {{ .Release.Name }}
    spec:
      containers:
      - name: nginx
        image: {{ .Values.image.repository }}:{{ .Values.image.tag }}
        ports:
        - containerPort: 80

{{ .Release.Name }}: 获取 Release 的名称。
{{ .Values.replicaCount }}: 获取 values.yaml 中 replicaCount 的值。
{{ .Values.image.repository }}: 获取 values.yaml 中 image.repository 的值。
{{ .Values.image.tag }}: 获取 values.yaml 中 image.tag 的值。

Helm 使用 Go 模板引擎将 templates 目录下的文件渲染成最终的 Kubernetes 资源定义。

charts 目录

charts 目录包含当前 Chart 依赖的子 Chart。例如，如果你的应用需要依赖 MySQL 数据库，你可以将 MySQL 的 Chart 放在 charts 目录下。 Helm 会自动安装和管理这些依赖。

常用 Helm 命令速查

以下是一些常用的 Helm 命令：

helm create <chart-name>: 创建一个新的 Chart。
helm install <release-name> <chart-name>: 安装 Chart。
helm upgrade <release-name> <chart-name>: 升级 Release。
helm rollback <release-name> <revision>: 回滚 Release 到指定的版本。
helm uninstall <release-name>: 卸载 Release。
helm list: 列出所有已安装的 Release。
helm status <release-name>: 查看 Release 的状态。
helm get values <release-name>: 获取 Release 的配置值。
helm lint <chart-name>: 检查 Chart 的语法和配置是否正确。
helm template <chart-name>: 在本地渲染 Chart 模板，但不进行部署。

实战演练：部署一个简单的 Nginx 应用

现在，让我们通过一个实战演练来巩固所学知识。我们将使用 Helm 部署一个简单的 Nginx 应用。

1. 创建 Chart

首先，创建一个名为 my-nginx 的 Chart：

helm create my-nginx

2. 修改 values.yaml

修改 my-nginx/values.yaml 文件，设置 Nginx 的镜像版本：

replicaCount: 1

image:
  repository: nginx
  tag: 1.21.0
  pullPolicy: IfNotPresent

service:
  type: ClusterIP
  port: 80

3. 修改 deployment.yaml

修改 my-nginx/templates/deployment.yaml 文件，确保镜像名称和版本与 values.yaml 中的配置一致：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-deployment
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app: {{ .Release.Name }}
  template:
    metadata:
      labels:
        app: {{ .Release.Name }}
    spec:
      containers:
      - name: nginx
        image: {{ .Values.image.repository }}:{{ .Values.image.tag }}
        ports:
        - containerPort: 80

4. 部署 Chart

使用以下命令部署 Chart：

helm install my-nginx ./my-nginx

5. 验证部署

使用 kubectl 命令验证 Nginx 应用是否成功部署：

kubectl get deployments
kubectl get services

如果一切顺利，你应该能够看到名为 my-nginx-deployment 的 Deployment 和名为 my-nginx 的 Service。

6. 访问 Nginx 应用

由于我们使用的是 ClusterIP 类型的 Service，你需要通过 Kubernetes 集群内部访问 Nginx 应用。你可以使用 kubectl port-forward 命令将本地端口转发到 Service：

kubectl port-forward service/my-nginx 8080:80

然后在浏览器中访问 http://localhost:8080，你应该能够看到 Nginx 的欢迎页面。

进阶学习

Helm Hooks: 在 Chart 部署的不同阶段执行自定义操作，例如数据库迁移、配置初始化等。
Helm Library Chart: 创建可重用的 Chart 组件，方便在多个 Chart 中共享。
Helm Plugin: 扩展 Helm 的功能，例如集成 CI/CD 工具、自动化部署等。
Helmfile: 用于管理多个 Helm Release，特别适合复杂的应用场景。

总结

通过本文的学习，你应该对 Helm 的基本概念、Chart 结构和常用命令有了初步的了解。希望这个实战演练能够帮助你快速上手 Helm，并在 Kubernetes 的世界里自由驰骋。记住，实践是最好的老师，多尝试、多探索，你一定能够成为 Helm 的高手！

Helm学徒 Kubernetes Helm Chart