# 2020-03-31-helm3 全新版本带来了什么 ## Helm用途 Helm把Kubernetes资源(比如deployments、services或 ingress等) 打包到一个chart中，而chart被保存到chart仓库。\ 通过chart仓库可用来存储和分享chart。\ Helm使发布可配置参数，支持发布应用配置的版本管理，简化了Kubernetes部署应用的版本控制、打包、发布、删除、更新等操作。 **可以简单理解为： 应用商店** ## helm3 变化 helm3 与helm2的变动很大，主要有几处 ### 1. 去除Tiller 和 helm serve 现在helm命令通过kubeconfig 直接操作k8s集群，类似于kubectl\ Helm使用与kubectl上下文相同的访问权限，也无需再使用helm init来初始化Helm\ 这点在helm部署和使用上方便了很多，也减少了服务发布可能遇到的因为tiller引起的异常 ![helm-v2-to-v3](https://1058386515-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDervEOwTvx5D-716B0%2F-M4E_GETGWPRbx2K8l37%2F-M4E_IGrlv5ccJ0_fZry%2Fhelm-v2-to-v3.png?generation=1586178111816213\&alt=media) 而且移除了 helm serve 的功能，不再本地提供chart仓库能力​ ### 2. 预定义仓库被移除，添加helm hub helm search 现在区分 repo 和hub\ repo 是自己手动添加的源\ 比如官方的有稳定版和在建设的，还有ibm的 ```bash # 安装helm curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 chmod 700 get_helm.sh ./get_helm.sh # 添加仓库 helm repo add stable https://kubernetes-charts.storage.googleapis.com helm repo add incubator https://kubernetes-charts-incubator.storage.googleapis.com/ helm repo add ibmstable https://raw.githubusercontent.com/IBM/charts/master/repo/stable helm repo add bitnami https://charts.bitnami.com/bitnami # 此处 repo add 的时候，如果名称已存在了也不提醒，居然直接覆盖了，是bug吧 ``` hub 是 helm 的中心库，各软件商需要在 hub 把应用更新到最新，我们才能在上面查到最新的，同dockerhub 这个建设还不久，好处是范围比较广泛, hub 搜到的包需要进入hub页面查看下载地址 我们可以把 hub 和 google repo 配合起来食用，效果更佳 `helm search hub mysql` ### 3. Values 支持 JSON Schema 校验器 当我们运行 helm install 、 helm upgrade 、 helm lint 、 helm template 命令时，JSON Schema 的校验会自动运行，如果失败就会立即报错。 这样等于是先都校验了一遍，再创建。 kubectl 说你呢，能不能学学！！！ 我测试了一下 ```bash helm pull stable/mysql tar -zxvf mysql-1.6.2.tgz cd mysql vim values.yaml # 把port: 3306 改成 port: 3306aaa # 安装测试，会校验port的格式，而且确实是在安装之前，一旦有错任何资源都不会被创建 helm install mysqlll . Error: unable to build kubernetes objects from release manifest: error validating "": error validating data: ValidationError(Service.spec.ports[0].port): invalid type for io.k8s.api.core.v1.ServicePort.port: got "string", expected "integer" ``` ### 4. 代码复用 - Library Chart 支持 Helm 3 中引入了一种新的 Chart 类型，名为 Library Chart 。它不会部署出一些具体的资源，只能被其他的 Chart 所引用，提高代码的可用复用性。当一个 Chart 想要使用该 Library Chart内的一些模板时，可以在 Chart.yaml 的 dependencies 依赖项中指定。 ### 5. requirements.yaml 被整合到了 Chart.yaml 中，但格式保持不变 还有一些其他的功能，比如 helm test 等，不属于主要功能，且属于测试阶段，我还没有去尝试。 ## helm2/3 命令差异 本节命令差异部分摘自 \ 作者： liumiaocn Helm 2和Helm 3在使用上还是有些区别的，除了在Helm 3中移除了Tiller，一些常用的命令也发生了变化，在这篇文章中进行简单的整理。 ### 常用命令一览 | 命令 | Helm 2 | Helm 3 | 命令说明区别 | 命令说明 | | ---------- | ------ | ------ | ------ | -------------------------------------------------------------------------------- | | create | 有 | 有 | 无 | create a new chart with the given name | | delete | 有 | 无 | - | given a release name, delete the release from Kubernetes | | dependency | 有 | 有 | 无 | manage a chart’s dependencies | | fetch | 有 | 无 | - | download a chart from a repository and (optionally) unpack it in local directory | | get | 有 | 有 | 有 | download a named release | | history | 有 | 有 | 无 | fetch release history | | home | 有 | 无 | - | displays the location of HELM\_HOME | | init | 有 | 无 | - | initialize Helm on both client and server | | inspect | 有 | 无 | - | inspect a chart | | install | 有 | 有 | 有 | install a chart archive | | lint | 有 | 有 | 无 | examines a chart for possible issues | | list | 有 | 有 | 无 | list releases | | package | 有 | 有 | 无 | package a chart directory into a chart archive | | plugin | 有 | 有 | 有 | add, list, or remove Helm plugins | | repo | 有 | 有 | 无 | add, list, remove, update, and index chart repositories | | reset | 有 | 无 | - | uninstalls Tiller from a cluster | | rollback | 有 | 有 | 无 | roll back a release to a previous revision | | search | 有 | 有 | 无 | search for a keyword in charts | | serve | 有 | 无 | - | start a local http web server | | status | 有 | 有 | 无 | displays the status of the named release | | template | 有 | 有 | 无 | locally render templates | | test | 有 | 有 | 有 | test a release | | upgrade | 有 | 有 | 无 | upgrade a release | | verify | 有 | 有 | 无 | verify that a chart at the given path has been signed and is valid | | version | 有 | 有 | 有 | print the client/server version information | | env | 无 | 有 | - | Helm client environment information | | help | 无 | 有 | - | Help about any command | | pull | 无 | 有 | - | download a chart from a repository and (optionally) unpack it in local directory | | show | 无 | 有 | - | show information of a chart | | uninstall | 无 | 有 | - | uninstall a release | ### Helm3: 不再存在的Helm2的命令 在前面的文章示例中，我们发现helm init已经在Helm 3中不存在了。类似的共有如下7条命令，在Helm 3中或删除或改名或则功能增强，比如因为Tiller的去除，所以导致了reset命令没有存在的意义，同时init存在仅剩客户端需要设定的功能，所以被去除了。另外诸如fetch命令，而在Helm 3中提供了pull命令予以替代。本来home命令用于显示HELM\_HOME环境变量，而在Helm 3中提供env命令可以显示所有的环境变量信息，用增强的功能予以了替换。但是无论如何，总之已经无法在Helm 3中直接使用如下7条命令。 | 命令 | Helm 2 | Helm 3 | 命令说明 | | ------- | ------ | ------ | -------------------------------------------------------------------------------- | | delete | 有 | 无 | given a release name, delete the release from Kubernetes | | fetch | 有 | 无 | download a chart from a repository and (optionally) unpack it in local directory | | home | 有 | 无 | displays the location of HELM\_HOME | | init | 有 | 无 | initialize Helm on both client and server | | inspect | 有 | 无 | inspect a chart | | reset | 有 | 无 | uninstalls Tiller from a cluster | | serve | 有 | 无 | start a local http web server | ### Helm3: 相较与Helm2新增的命令 相较于Helm 2，从helm --help中获得的信息看到如下5条命令在Helm 3中为新增的命令。 | 命令 | Helm 2 | Helm 3 | 命令说明 | | --------- | ------ | ------ | -------------------------------------------------------------------------------- | | env | 无 | 有 | Helm client environment information | | help | 无 | 有 | Help about any command | | pull | 无 | 有 | download a chart from a repository and (optionally) unpack it in local directory | | show | 无 | 有 | show information of a chart | | uninstall | 无 | 有 | uninstall a release | 稍作分析，会发现如下事实： env是对被删除的命令home的强化\ pull是对被删除的命令fetch的替换\ show是对被删除的命令inspect的替换\ help命令本身在Helm 2时代就可以使用，只是helm --help里面没有显示，算是文档自包含的强化\ uninstall是功能特性的增强 ### Helm3: 命令说明发生变化 由于Tiller的移除，版本显示命令helm version的表述从显示client/server的版本信息变成了显示client的版本信息，类似的发生变化的共有5条命令，到底是文档的变化还是功能性的反映，在后续的文章中将继续通过实例进行进一步的说明。 | 命令 | Helm 2 | Helm 3 | 命令说明区别 | Helm2命令说明 | Helm3命令说明 | | ------- | ------ | ------ | ------ | ----------------------------------------------------------------------------------- | --------- | | get | 有 | 有 | 有 | download a named release download extended information of a named release | | | install | 有 | 有 | 有 | install a chart archive install a chart | | | plugin | 有 | 有 | 有 | add, list, or remove Helm plugins install, list, or uninstall Helm plugins | | | test | 有 | 有 | 有 | test a release run tests for a release | | | version | 有 | 有 | 有 | print the client/server version information print the client version information | | ### Helm3: 其他变化 并不是说helm --help没有变化的，使用上就没有区别，以repo和install为例，在使用上都发生了变化，但是在helm自身提供的帮助信息中却未提供，这些也会在后续的示例的使用中进一步进行说明。 ## 结尾 helm3 新加的命令基本都是对helm2命令的强化，不再做一个个测试了。 附 helm2 的学习笔记。 ## 安装 mysql 试下mysql，并使用持久化存储。 获取chart ```bash helm repo add stable https://kubernetes-charts.storage.googleapis.com helm search repo mysql # 稳定版库里面找到了mysql5.7，正是所需要的，下载下来 helm pull stable/mysql tar -zxvf mysql-1.6.2.tgz # 查看 valume 说明，persistence 默认已经是enable # 没有使用storageclass，直接安装 helm install mysql123 . # 查看pod 和pvc，都是Pending，缺少pv 建一个hostpath的pv vim /tmp/mysql-pv.yaml kind: PersistentVolume apiVersion: v1 metadata: name: mysql-data labels: release: stable spec: capacity: storage: 10Gi accessModes: - ReadWriteOnce hostPath: path: /tmp/mysql-data kubectl create -f /tmp/mysql-pv.yaml kubectl get po NAME READY STATUS RESTARTS AGE mysql123-b86d7c687-9795n 1/1 Running 0 35s ``` ## 参考文档 \ \ \