安装
Helm有两个部分:Helm客户端(helm)和Helm服务端(Tiller)。本指南介绍如何安装客户端,然后继续演示两种安装服务端的方法。
重要提示:如果你负责的群集是在受控的环境,尤其是在共享资源时,强烈建议使用安全配置安装Tiller。有关指导,请参阅“Helm安全安装”。
我在网址 https://whmzsu.github.io/helm-doc-zh-cn/ 不断更新,同时也会搬运到这里,大家有兴趣加入https://github.com/whmzsu/helm-doc-zh-cn/的可以给我提交意见和建议。
安装Helm客户端
Helm客户端可以从源代码安装,也可以从预构建的二进制版本安装。
二进制版本
每一个版本releaseHelm提供多种操作系统的二进制版本。这些二进制版本可以手动下载和安装。
下载你想要的版本
解压缩(tar -zxvf helm-v2.0.0-linux-amd64.tgz)
helm在解压后的目录中找到二进制文件,并将其移动到所需的位置(mv linux-amd64/helm /usr/local/bin/helm)
到这里,你应该可以运行客户端了:helm help。
通过homebrew(macOS)
Kubernetes社区的成员为Homebrew贡献了Helm。这个通常是最新的。
brew install kubernetes-helm
(注意:emacs-helm也是一个软件,这是一个不同的项目。)
从Chocolatey(Windows)
Kubernetes社区的成员为 Chocolatey贡献了Helm包。这个软件包通常是最新的。
choco install kubernetes-helm
从脚本
Helm现在有一个安装shell脚本,将自动获取最新版本的Helm客户端并在本地安装。
可以获取该脚本,然后在本地执行它。这种方法也有文档指导,以便可以在运行之前仔细阅读并理解它在做什么。
$ curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get > get_helm.sh
$ chmod 700 get_helm.sh
$ ./get_helm.sh
curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get | bash
也可以做到这一点。
从金丝雀版本(Canary )构建
“Canary”版本是从最新的主分支构建的Helm软件的版本。它们不是正式版本,可能不稳定。但是,他们提供了测试最新功能的机会。
“Canary”版本Helm二进制文件存储在Kubernetes Helm GCS存储中。以下是常见构建的链接:
Linux AMD64
macOS AMD64
Experimental Windows AMD64
源代码方式(Linux,macOS)
从源代码构建Helm的工作稍微多一些,但如果你想测试最新的(预发布)Helm版本,那么这是最好的方法。
你必须有一个安装Go工作环境 。
$ cd $GOPATH
$ mkdir -p src/k8s.io
$ cd src/k8s.io
$ git clone https://github.com/kubernetes/helm.git
$ cd helm
$ make bootstrap build
该bootstrap目标将尝试安装依赖,重建 vendor/树,并验证配置。
该build目标编译helm并将其放置在bin/helm目录。Tiller也会编译,并且被放置在bin/tiller目录。
安装Tiller
Helm的服务器端部分Tiller通常运行在Kubernetes集群内部。但是对于开发,它也可以在本地运行,并配置为与远程Kubernetes群集通信。
快捷群集内安装
安装tiller到群集中最简单的方法就是运行 helm init。这将验证helm本地环境设置是否正确(并在必要时进行设置)。然后它会连接到kubectl默认连接的任何集群(kubectl config view)。一旦连接,它将安装tiller到 kube-system命名空间中。
helm init以后,可以运行kubectl get pods --namespace kube-system并看到Tiller正在运行。
你可以通过参数运行helm init:
--canary-image 安装金丝雀版本
--tiller-image 安装特定的镜像(版本)
--kube-context 安装到特定群集
--tiller-namespace 用一个特定的命名空间(namespace)安装
一旦安装了Tiller,运行helm version会显示客户端和服务器版本。(如果它仅显示客户端版本, 则helm无法连接到服务器,使用kubectl查看是否有任何 tiller Pod正在运行。)
除非设置--tiller-namespace或TILLER_NAMESPACE环境变量参数,否则Helm将在命名空间kube-system中查找Tiller 。
安装Tiller金丝雀版本
Canary 镜像是从master分支建立的。他们可能不稳定,但他们提供测试最新功能的机会。
安装Canary 镜像最简单的方法是helm init与 –canary-image参数一起使用:
$ helm init --canary-image
这将使用最近构建的容器镜像。可以随时使用kubectl删除kube-system名称空间中的Tiller deployment来卸载Tiller。
本地运行Tiller
对于开发而言,有时在本地运行Tiller更容易,将其配置为连接到远程Kubernetes群集。
上面介绍了构建部署Tiller的过程。
一旦tiller构建部署完成,只需启动它:
$ bin/tiller
Tiller running on :44134
当Tiller在本地运行时,它将尝试连接到由kubectl配置的Kubernetes群集。(运行kubectl config view以查看是哪个群集。)
必须告知helm连接到这个新的本地Tiller主机,而不是连接到群集中的一个。有两种方法可以做到这一点。第一种是在命令行上指定--host选项。第二个是设置$HELM_HOST环境变量。
$ export HELM_HOST=localhost:44134
$ helm version # Should connect to localhost.
Client: &version.Version{SemVer:"v2.0.0-alpha.4", GitCommit:"db...", GitTreeState:"dirty"}
Server: &version.Version{SemVer:"v2.0.0-alpha.4", GitCommit:"a5...", GitTreeState:"dirty"}
注意,即使在本地运行,Tiller也会将安装的release配置存储在Kubernetes内的ConfigMaps中。
升级Tiller
从Helm 2.2.0开始,Tiller可以升级使用helm init --upgrade。
对于旧版本的Helm或手动升级,可以使用kubectl修改Tiller容器镜像:
$ export TILLER_TAG=v2.0.0-beta.1 # Or whatever version you want
$ kubectl --namespace=kube-system set image deployments/tiller-deploy tiller=gcr.io/kubernetes-helm/tiller:$TILLER_TAG
deployment "tiller-deploy" image updated
设置TILLER_TAG=canary将获得master版本的最新快照。
删除或重新安装Tiller
由于Tiller将其数据存储在Kubernetes ConfigMaps中,因此可以安全地删除并重新安装Tiller,而无需担心丢失任何数据。推荐删除Tiller的方法是使用kubectl delete deployment tiller-deploy --namespace kube-system或更简洁使用helm reset。
然后可以从客户端重新安装Tiller:
$ helm init
高级用法
helm init 提供了额外的参数,用于在安装之前修改Tiller的deployment manifest。
使用 --node-selectors
--node-selectors参数允许我们指定调度Tiller Pod所需的节点标签。
下面的例子将在nodeSelector属性下创建指定的标签。
helm init --node-selectors "beta.kubernetes.io/os"="linux"
已安装的deployment manifest将包含我们的节点选择器标签。
...
spec:
template:
spec:
nodeSelector:
beta.kubernetes.io/os: linux
...
使用 –override
--override允许指定Tiller的deployment manifest的属性。与在Helm其他地方--set使用的命令不同,helm init --override修改最终manifest的指定属性(没有”values”文件)。因此,可以为deployment manifest中的任何有效属性指定任何有效值。
覆盖注释
在下面的示例中,我们使用–override添加修订版本属性并将其值设置为1。
helm init --override metadata.annotations."deployment.kubernetes.io/revision"="1"
输出:
apiVersion: extensions/v1beta1
kind: Deployment
metadata:
annotations:
deployment.kubernetes.io/revision: "1"
...
覆盖亲和性
在下面的例子中,我们为节点设置了亲和性属性。--override可以组合来修改同一列表项的不同属性。
helm init --override "spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[0].weight"="1" --override "spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[0].preference.matchExpressions[0].key"="e2e-az-name"
指定的属性组合到“preferredDuringSchedulingIgnoredDuringExecution”属性的第一个列表项中。
...
spec:
strategy: {}
template:
...
spec:
affinity:
nodeAffinity:
preferredDuringSchedulingIgnoredDuringExecution:
- preference:
matchExpressions:
- key: e2e-az-name
operator: ""
weight: 1
...
使用 –output
--output参数允许我们跳过安装Tiller的deployment manifest,并以JSON或YAML格式简单地将deployment manifest输出到标准输出stdout。然后可以使用jq类似工具修改输出,并使用kubectl手动安装。
在下面的例子中,我们helm init用–output json 参数执行。
helm init --output json
Tiller安装被跳过,manifest以JSON格式输出到stdout。
"apiVersion": "extensions/v1beta1",
"kind": "Deployment",
"metadata": {
"creationTimestamp": null,
"labels": {
"app": "helm",
"name": "tiller"
},
"name": "tiller-deploy",
"namespace": "kube-system"
},
...
存储后端
默认情况下,tiller将安装release信息存储在其运行的名称空间中的ConfigMaps中。从Helm 2.7.0开始,现在有一个Secrets用于存储安装release信息的beta存储后端。添加了这个功能是为和Kubernetes的加密Secret一起,保护chart的安全性。
要启用secrets后端,需要使用以下选项启动Tiller:
helm init --override "spec.template.spec.containers[0].command"="{/tiller,--storage=secret}"
目前,如果想从默认后端切换到secrets后端,必须自行为此进行迁移配置信息。当这个后端从beta版本毕业时,将会有更正式的移徙方法。
总结
在大多数情况下,安装和获取预先构建的helm二进制代码及helm init一样简单。这个文档提供而了一些用例给那些想要用Helm做更复杂的事情的人。
一旦成功安装了Helm Client和Tiller,可以继续下一步使用Helm来管理charts。