Helm V2 迁移到 V3 版本

2021-01-07 21:51:50 阅读：293 来源： 互联网

Helm V3 版本已经发布了第三个 Beta 版本了，由于 V2 和 V3 版本之间的架构变化较大，所以如果我们现在正在使用 V2 版本的话，要迁移到 V3 版本了就有点小麻烦，其中最重要的当然就是数据迁移的问题，为了解决这个版本迁移问题，官方提供了一个名为 helm-2to3 的插件可以来简化我们的迁移工作。

安装 Helm V3

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

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

$ 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 对象不会被修改或者删除，所以不用担心。接下来我们就来安装这个插件。

安装

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

$ 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 命令查看插件是否安装成功：

$ 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/

Helm V2 迁移到 V3 版本

标签：helm3,minio,2to3,helm,V2,V3,Helm
来源： https://blog.51cto.com/15077560/2584828

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

ICode9

Helm V2 迁移到 V3 版本

安装 Helm V3

HELM-2TO3 插件

安装

插件特性

迁移 Helm V2 配置

迁移 Helm V2 Release

清理 Helm V2 数据