【笔记】Helm-3 主题-13 Helm v2迁移到 v3

发布时间:2024年01月22日

Helm v2 迁移到 v3

该指南介绍如何将Helm v2迁移到v3.Helm v2需要被安装且在一个或多个集群中管理版本。

Helm 3变化概述

Helm 2 to 3完整的变化列表在FAQ部分。以下是用户在迁移之前应该要注意的一些改变的概述:

Helm | Docs

1.移除了Tiller:

1、用client/library结构(仅仅helm)替换了client/server

2、安全性现在是每个用户的基础(委托给了Kubernetes用户集群安全)

3、发布版本现在作为集群内的密钥存储且改变了发布对象的元数据

4、发布版本实在版本命名空间的基础上持久化的并且不再是Tiller的命名空间

2.升级了Chart仓库:

1、helm search现在支持本地仓库搜索和Aritifact Hub查询

3.对于以下更新的规范,Chart的apiVersion升级到了“v2”:

1、动态依赖的chart依赖移动到了Chart.yaml(删除可requirements.yaml且requirements-->dependencies)

2、库chart(辅助/公共库)现在可以添加为动态链路的chart依赖

3、Chart有个type元数据字段将chart定义为application或library的chart。默认是壳渲染和安装的应用

4、Helm 2的chart(apiVersion=v1)依然可用

4.添加了XDG目录规范:

1、Helm根目录针对存储配置文件删除和替换了XDG目录规范

2、不再需要初始化Helm

3、移除了helm init和helm home

5.其他更改

1、简化了Helm的安装和设置:

1)仅针对Helm客户端(二进制)

2)按照已有范式运行

2、不再默认设置local或stable仓库

3、删除了crd-install钩子并用chart中的crds目录替换了,在渲染chart之前会安装所有的crd

4、删除了test-failure钩子注释值,且弃用了test-success。使用test代替

5、删除/替换/添加的命令:

1)delete-->uninstall:默认删除所有的发布记录(之前需要 --purge)

2)fetch-->pull

3)home(已删除)

4)init(已删除)

5)install:需要发布名称或者 --generate-name参数

6)inspect-->show

7)reset(已删除)

8)serve(已删除)

9)templete:-x / --execute参数重命名为-s / --show-only

10)upgrade:添加了参数 --history-max,限制每个版本保存的最大记录数量(0表示不限制)

6)Helm 3 Go库经历了很多变化,不再兼容Helm 2库

7)发行版二进制包现在托管在get.helm.sh

迁移用例

迁移用例如下:

1.Helm v2和v3来管理相同的集群:

1、只有打算逐步淘汰Helm v2时,才建议使用此用例,且不需要使用v3管理任何v2部署的发布。所有的新发布都应该使用v3部署且现有v2删除和升级

2、Helm v2和v3可以很欢快地管理同一个集群。Helm版本可以安装在相同或单独的系统上。

3、如果将Helm v3安装在相同的系统上,需要执行额外的步骤来保证两个客户端版本可以共存,直到删除Helm v2客户端。重命名或者将Helm v3执行文件放在不同的文件夹中以避免冲突

4、否则由于以下区别两个版本不存在冲突:

1)v2和v3发布(历史)存储是独立的。修改包括存储的Kubernetes资源和包含在资源中的发布对象元数据。发布版本会在每个用户命名空间而不是Tiller命名空间(比如,v2默认的命名空间kube-system)。v2使用Tiller命名空间中的“ConfigMaps”或“Secrets”和TILLER所有权。v3在用户命名空间中使用“Secrets”和helm所有权。发布版本在v2和v3中都是增量的。

2)唯一的问题是如果Kubernetes集群范围内的资源(比如clusterroles.rbac)定义在chart中。即使资源在命名空间中是唯一的,因为冲突v3部署会失败。

3)v3配置不再使用$HELM_HOME并使用XDG目录规范代替。还可以根据需要动态创建。因此它独立于v2配置。这仅适用于两个版本安装在同一个系统上的情况。

2.将Helm v2迁移到v3

1、此案例适用于您希望用Helm v3管理现有Helm v2版本时

2、需要注意的是Helm v2客户端:

1)可以管理1个或多个Kubernetes集群

2)可以为一个集群连接1个或多个Tiller实例

3、这意味着您必须注意当通过Tiller和它的命名空间迁移部署在集群中的发布。因此您必须注意使用Helm v2客户端实例管理的每个集群和Tiller实例的迁移

4、推荐的数据迁移步骤如下:

1)备份v2数据

2)迁移Helm v2配置

3)迁移Helm v2发布

4)当确信Helm v3按预期管理所有的Helm v2数据时(针对Helm v2客户端实例的所有集群和Tiller实例)

5、迁移过程由Helm v3的 2to3 插件自动完成

https://github.com/helm/helm-2to3

参考

helm v3 2to3 插件

https://github.com/helm/helm-2to3

post附带示例阐述了 2to3 插件的使用

Helm | How to migrate from Helm v2 to Helm v3

————————————

仅用于本人学习

来源:Helm | Docs?

文章来源:https://blog.csdn.net/m0_46141283/article/details/135735984
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。