跳到主要内容

Helm Chart 本地化定制与部署

在使用 Helm 管理 Kubernetes 应用时，我们通常会直接从远程仓库安装 Chart。然而，在需要进行深度定制、离线部署或版本控制时，将 Chart 下载到本地并进行管理就变得尤为重要。本文将详细介绍如何通过 Helm 命令下载 Chart 文件到本地，并基于本地 Chart 进行自定义安装。

理解 Helm Chart 安装的两种模式​

在深入本地化操作之前，我们先回顾一下 Helm Chart 的两种主要安装方式：

  1. 从远程仓库安装： 这是最常见的安装方式，Helm 会自动从配置的 Chart 仓库下载 Chart 并进行部署。 
    helm repo add dify https://borispolonsky.github.io/dify-helm
    helm repo update
    helm install my-release dify/dify
  2. 从本地文件或目录安装： 这种方式允许用户指定本地磁盘上的 Chart 文件（.tgz 压缩包）或解压后的 Chart 目录进行安装。

下载 Helm Chart 到本地​

要实现本地定制，第一步是获取 Chart 的本地副本。Helm 提供了 helm pull 命令专门用于此目的。

使用 helm pull 命令下载​

helm pull 命令能够将指定仓库中的 Chart 下载到当前工作目录。

命令格式：

helm pull [仓库名称]/[Chart名称] [OPTIONS]

示例：下载 Dify Chart

假设我们已经添加了 Dify 的 Helm 仓库：

helm repo add dify https://borispolonsky.github.io/dify-helm
helm repo update

现在，我们可以将 dify Chart 下载到本地：

helm pull dify/dify

执行此命令后，Helm 会将 dify Chart 的最新版本（例如 dify-X.Y.Z.tgz）下载到您运行命令的当前目录下。

helm pull 的常用选项​

  • --version <版本号>：下载指定版本的 Chart。例如：helm pull dify/dify --version 1.0.0
  • --untar：在下载后自动解压 Chart 包到一个目录。这在您计划直接修改 Chart 内容时非常有用。
  • --untar-dir <目录>：配合 --untar 使用，指定解压的目标目录。

通过本地 Chart 文件进行安装​

一旦 Chart 文件下载到本地，我们就可以使用 helm install 命令指定本地路径进行安装。

方案一：使用 .tgz 压缩包安装​

如果您下载的是一个 .tgz 格式的 Chart 包（例如 dify-x.y.z.tgz），可以直接指定该文件进行安装。

命令示例：

helm install my-release ./dify-x.y.z.tgz

请确保将 ./dify-x.y.z.tgz 替换为实际的 Chart 文件路径和文件名。例如，如果文件在当前目录下，就直接写文件名；如果文件在 ~/charts/dify 目录下，那么就写 ~/charts/dify/dify-x.y.z.tgz。

方案二：使用解压后的目录安装​

如果您下载后已经将 Chart 文件解压，形成了一个目录（例如 dify/），那么您可以指定这个目录进行安装。

命令示例：

helm install my-release ./dify/

请确保将 ./dify/ 替换为实际的 Chart 目录的路径。例如，如果解压后的目录在当前目录下，就写目录名；如果目录在 ~/charts/dify 目录下，那么就写 ~/charts/dify/。

核心参数说明​

  • my-release: 这是您为 Helm 部署的发行版（Release）指定的名称。一个 Kubernetes 集群中可以有多个同 Chart 但不同名称的 Release。
  • ./dify-x.y.z.tgz 或 ./dify/: 这指定了 Helm Chart 的本地路径，可以是压缩包文件或解压后的目录。

自定义配置 (values.yaml)​

无论您选择哪种安装方式，对 Chart 进行自定义配置是 Helm 的核心功能之一。您可以通过创建一个 values.yaml 文件来覆盖 Chart 内部的默认配置。

步骤：

  1. 查看默认 Values (可选): 在自定义之前，通常建议先查看 Chart 默认的配置项，以便了解哪些参数可以修改。

    helm show values dify/dify > default-values.yaml

    或者如果您有本地 Chart，可以查看 Chart 解压后的目录内的 values.yaml 文件。

  2. 创建自定义 values.yaml: 根据您的需求，创建一个新的 YAML 文件（例如 my-values.yaml），只包含您需要修改的配置项。Helm 会将这些自定义值与 Chart 默认值进行合并。

    # my-values.yaml 示例
    replicaCount: 2
    service:
      type: NodePort
      port: 80
    image:
      tag: "latest"
    # ... 其他自定义配置

  3. 安装时指定 values.yaml: 在 helm install 命令中使用 -f 或 --values 参数指向您的自定义 values.yaml 文件。

    • 如果使用 .tgz 文件安装： 
      helm install my-release ./dify-X.Y.Z.tgz -f my-values.yaml
    • 如果使用解压后的目录安装： 
      helm install my-release ./dify/ -f my-values.yaml

通过 helm pull 命令下载 Chart 到本地，结合灵活的自定义 values.yaml，您将能够更精细地控制 Helm Chart 的部署行为，从而满足复杂的应用场景需求，如开发测试、CI/CD 自动化或生产环境的严格配置管理。