Helm V2 迁移到 V3 版本

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 版本

上一篇:图片存储方案-MinIo


下一篇:Jquery+Ajax限制查询间隔