Helm 用户指南系列（2）安装

安装

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提供多种操作系统的二进制版本。这些二进制版本可以手动下载和安装。

到这里，你应该可以运行客户端了：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。