Helm V2 迁移到 V3 版本

时间 2021-01-07

标签 git github redis 安全架构 app less ide 工具测试栏目 Git 繁體版

原文原文链接

Helm V3 版本已经发布了第三个 Beta 版本了，因为 V2 和 V3 版本之间的架构变化较大，因此若是咱们如今正在使用 V2 版本的话，要迁移到 V3 版本了就有点小麻烦，其中最重要的固然就是数据迁移的问题，为了解决这个版本迁移问题，官方提供了一个名为 helm-2to3 的插件能够来简化咱们的迁移工做。git

安装 Helm V3

为了可以让 Helm V2 CLI 包还能够继续使用，因此咱们这里就不直接覆盖了，让两个版本的 CLI 包能够共存，比较迁移仍是有风险的，等到咱们准备好移除 V2 版本的时候再删除也不迟。github

在 Helm GitHub 仓库上下载最新的 V3 Beta 版本，地址：https://github.com/helm/helm/releases，要注意选择和你系统一致的二进制包，好比咱们这里是 Mac 系统，就下载 MacOSamd64这个包，下载完成后解压将对应的 Helm CLI 包重命名为 helm3，并移动到 PATH 路径（好比 /usr/local/bin）下面去，而后咱们就能够准备使用 helm3 命令了：redis

$ helm3 version

version.BuildInfo{Version:"v3.0.0-beta.3", GitCommit:"5cb923eecbe80d1ad76399aee234717c11931d9a", GitTreeState:"clean", GoVersion:"go1.12.9"}

$ helm repo list

NAME            URL

stable          http://mirror.azure.cn/kubernetes/charts/

local           http://127.0.0.1:8879/charts

$ helm3 repo list

Error: no repositories to show

咱们能够看到使用 helm3 命令查看不到咱们以前配置的 chart 仓库信息。安全

HELM-2TO3 插件

helm-2to3 插件就可让咱们将 Helm V2 版本的配置和 release 迁移到 Helm V3 版本去。架构

安装的 Kubernetes 对象不会被修改或者删除，因此不用担忧。接下来咱们就来安装这个插件。app

安装

直接使用下面的命令安装便可：less

$ helm3 plugin install https://github.com/helm/helm-2to3

Downloading and installing helm-2to3 v0.1.1 ...

https://github.com/helm/helm-2to3/releases/download/v0.1.1/helm-2to3_0.1.1_darwin_amd64.tar.gz

Installed plugin: 2to3

而后能够使用 helm3 命令查看插件是否安装成功：ide

$ helm3 plugin list

NAME    VERSION DESCRIPTION

2to3    0.1.1   migrate Helm v2 configuration and releases in-place to Helm v3

$ helm3 2to3

Migrate Helm v2 configuration and releases in-place to Helm v3

Usage:

  2to3 [command]

Available Commands:

  convert     migrate Helm v2 release in-place to Helm v3

  help        Help about any command

  move        migrate Helm v2 configuration in-place to Helm v3

Flags:

  -h, --help   help for 2to3

Use "2to3 [command] --help" for more information about a command.

到这里就证实咱们的 helm-2to3 插件已经安装成功了。工具

插件特性

如今插件支持的功能主要有两个部分：测试

迁移 Helm V2 配置
迁移 Helm V2 release

接下来咱们就来分别操做下。

迁移 Helm V2 配置

首先咱们须要迁移 Helm V2 版本的相关配置和数据目录：

$ helm3 2to3 move config

[Helm 2] Home directory: /Users/ych/.helm

[Helm 3] Config directory: /Users/ych/Library/Preferences/helm

[Helm 3] Data directory: /Users/ych/Library/helm

[Helm 3] Create config folder "/Users/ych/Library/Preferences/helm" .

[Helm 3] Config folder "/Users/ych/Library/Preferences/helm" created.

[Helm 2] repositories file "/Users/ych/.helm/repository/repositories.yaml" will copy to [Helm 3] config folder "/Users/ych/Library/Preferences/helm/repositories.yaml" .

[Helm 2] repositories file "/Users/ych/.helm/repository/repositories.yaml" copied successfully to [Helm 3] config folder "/Users/ych/Library/Preferences/helm/repositories.yaml" .

[Helm 3] Create data folder "/Users/ych/Library/helm" .

[Helm 3] data folder "/Users/ych/Library/helm" created.

[Helm 2] plugins "/Users/ych/.helm/plugins" will copy to [Helm 3] data folder "/Users/ych/Library/helm/plugins" .

[Helm 2] plugins "/Users/ych/.helm/plugins" copied successfully to [Helm 3] data folder "/Users/ych/Library/helm/plugins" .

[Helm 2] starters "/Users/ych/.helm/starters" will copy to [Helm 3] data folder "/Users/ych/Library/helm/starters" .

[Helm 2] starters "/Users/ych/.helm/starters" copied successfully to [Helm 3] data folder "/Users/ych/Library/helm/starters" .

上面的操做会迁移：

Chart starters
Chart 仓库
插件

不过须要注意的是，请检查下全部的 Helm V2 下面的插件是否可以在 Helm V3 下面正常工做，把不起做用的插件删除便可。

如今咱们再查看下 Chart 仓库信息：

$ helm3 repo list

NAME            URL

stable          http://mirror.azure.cn/kubernetes/charts/

local           http://127.0.0.1:8879/charts

$ helm3 plugin list

NAME    VERSION DESCRIPTION

2to3    0.1.1   migrate Helm v2 configuration and releases in-place to Helm v3

push    0.7.1   Push chart package to ChartMuseum

上面的 move config 命令会建立 Helm V3 配置和数据目录（若是它们不存在），并将覆盖 repositories.yaml文件（若是存在）。

此外，该插件还支持将非默认的 Helm V2 主目录以及 Helm V3 配置和数据目录，使用以下配置使用便可：

$ export HELM_V2_HOME=$HOME/.helm2

$ export HELM_V3_CONFIG=$HOME/.helm3

$ export HELM_V3_DATA=$PWD/.helm3

$ helm3 2to3 move config

迁移 Helm V2 Release

如今咱们能够开始迁移 releases 了。能够使用以下命令查看下命令的可用选项：

$ helm3 2to3 convert -h

migrate Helm v2 release in-place to Helm v3

Usage:

  2to3 convert [flags] RELEASE

Flags:

      --delete-v2-releases       v2 releases are deleted after migration. By default, the v2 releases are retained

      --dry-run                  simulate a convert

  -h, --help                     help for convert

  -l, --label string             label to select tiller resources by (default "OWNER=TILLER")

  -s, --release-storage string   v2 release storage type/object. It can be 'secrets' or 'configmaps'. This is only used with the 'tiller-out-cluster' flag (default "secrets")

  -t, --tiller-ns string         namespace of Tiller (default "kube-system")

      --tiller-out-cluster       when  Tiller is not running in the cluster e.g. Tillerless

能够看到最后的 --tiller-out-cluster 参数，甚至支持 Tillerless Helm v2。

如今咱们来查看下 Helm V2 下面的 release，而后选择一个来测试下迁移：

$ helm list

NAME        REVISION    UPDATED                     STATUS      CHART               APP VERSION NAMESPACE

minio        1           Wed Sep 11 11:47:51 2019    DEPLOYED    minio-2.5.13    RELEASE.2019-08-07T01-59-21Z    argo

redis       1           Wed Sep 11 14:52:57 2019    DEPLOYED    redis-9.1.7         5.0.5       redis

上面咱们也看到该迁移命令支持 --dry-run选项，固然最安全的方式是先使用下该参数测试下效果：

$ helm3 2to3 convert --dry-run minio

NOTE: This is in dry-run mode, the following actions will not be executed.

Run without --dry-run to take the actions described below:

Release "minio" will be converted from Helm 2 to Helm 3.

[Helm 3] Release "minio" will be created.

[Helm 3] ReleaseVersion "minio.v1" will be created.

咱们能够查看上面的 dry-run模式下面的一些描述信息，没有什么问题的话就能够真正的来执行迁移操做了：

$ helm3 2to3 convert minio

Release "minio" will be converted from Helm 2 to Helm 3.

[Helm 3] Release "minio" will be created.

[Helm 3] ReleaseVersion "minio.v1" will be created.

[Helm 3] ReleaseVersion "minio.v1" created.

[Helm 3] Release "minio" created.

Release "minio" was converted successfully from Helm 2 to Helm 3. Note: the v2 releases still remain and should be removed to avoid conflicts with the migrated v3 releases.

迁移完成后，而后检查下是否成功了：

$ helm list

NAME        REVISION    UPDATED                     STATUS      CHART               APP VERSION NAMESPACE

minio        1           Wed Sep 11 11:47:51 2019    DEPLOYED    minio-2.5.13    RELEASE.2019-08-07T01-59-21Z    argo

redis       1           Wed Sep 11 14:52:57 2019    DEPLOYED    redis-9.1.7         5.0.5       redis

$ helm3 list

NAME     NAMESPACE   REVISION    UPDATED                                 STATUS      CHART

咱们能够看到执行 helm3 list命令并无任何 release 信息，这是由于咱们迁移的 minio 这个 release 是被安装在 argo这个命名空间下面的，因此须要指定命名空间才能够看到：

$ helm3 list -n argo

NAME     NAMESPACE   REVISION    UPDATED                                 STATUS      CHART

minio    argo        1           2019-09-11 03:47:51.239461137 +0000 UTC deployed    minio-2.5.13

注意：因为咱们没有指定 --delete-v2-releases选项，因此 Helm V2 minio 这个 release 信息仍是存在的，咱们能够在之后使用 kubectl 进行删除。

当你准备好迁移你全部的 releases 的时候，你能够循环 helm list里面的全部 release 来自动的将每一个 Helm V2 release 迁移到 Helm V3 版本去。

若是你正在使用 Tillerless Helm V2，只须要指定 --tiller-out-cluster选项来迁移 release 便可：

$ helm3 2to3 convert minio --tiller-out-cluster

清理 Helm V2 数据

最后固然就是清理以前版本的旧数据了，虽然这并非必须的，可是仍是建议你清理下，能够避免一些冲突。清理 Helm V2 的数据比较简单：

删除主文件夹 ~/.helm
若是你没有使用 --delete-v2-releases选项，那么旧使用 kubectl 工具来删除 Tiller releases 数据
卸载掉烦人的 Tiller

Happy Helm v3 sailing~

原文连接：https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/