Helm安装使用

简介

Helm 是一个类似于 yum/apt/homebrew 的 Kubernetes 应用管理工具。Helm 使用 Chart 来管理 Kubernetes manifest 文件。

安装 Helm

使用官方脚本安装最新版

1
2
3

curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get > get_helm.sh
chmod 700 get_helm.sh
./get_helm.sh

更新 charts 列表
1
helm repo update

为 Tilier 添加权限
参考 role-based-access-control

新建 rbac-config.yaml

  apiVersion: v1
  kind: ServiceAccount
  metadata:
  name: tiller
  namespace: kube-system
  ---
  apiVersion: rbac.authorization.k8s.io/v1beta1
  kind: ClusterRoleBinding
  metadata:
  name: tiller
  roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
  subjects:
  - kind: ServiceAccount
      name: tiller
      namespace: kube-system

执行以下命令创建
1
kubectl create -f rbac-config.yaml

查看 Helm 版本号

1
2
3

[root@xuejian-1 linux-amd64]# ./helm  version
Client: &version.Version{SemVer:"v2.13.1", GitCommit:"618447cbf203d147601b4b9bd7f8c37a5d39fbb4", GitTreeState:"clean"}
Server: &version.Version{SemVer:"v2.13.1", GitCommit:"618447cbf203d147601b4b9bd7f8c37a5d39fbb4", GitTreeState:"clean"}

初始化 Helm 并安装 Tiller 服务（需要事先配置好 kubectl）

1	helm init --upgrade --service-account tiller --tiller-image registry.cn-hangzhou.aliyuncs.com/google_containers/tiller:v2.9.1

Helm 工作原理

基本概念

Chart：包含了创建一个 Kubernetes 应用的必要信息
Repository：Helm package 存储仓库
Release：是一个 chart 及其配置的一个运行实例

组成结构

Helm Client 是用户命令行工具，其主要负责如下：

本地 chart 开发
仓库管理
与 Tiller sever 交互
发送预安装的 chart
查询 release 信息
要求升级或卸载已存在的 release

Tiller Server 是一个部署在 Kubernetes 集群内部的 server，其与 Helm client、Kubernetes API server 进行交互。

Tiller server 主要负责如下：

监听来自 Helm client 的请求
通过 chart 及其配置构建一次发布
安装 chart 到 Kubernetes 集群，并跟踪随后的发布
通过与 Kubernetes 交互升级或卸载 chart
简单的说，client 管理 charts，而 server 管理发布 release

helm charts

Helm 使用 Chart 来管理 Kubernetes manifest 文件。每个 chart 都至少包括

应用的基本信息 Chart.yaml
一个或多个 Kubernetes manifest 文件模版（放置于 templates/ 目录中），可以包括 Pod、Deployment、Service 等各种 Kubernetes 资源
模板默认值 values.yaml （可选）

示例 Chart ： Mysql

依赖管理

Helm 支持两种方式管理依赖的方式：

直接把依赖的 package 放在 charts/ 目录中

使用 requirements.yaml 并用 helm dep up foochart 来自动下载依赖的 packages

  dependencies:
  - name: apache
      version: 1.2.3
      repository: http://example.com/charts
  - name: mysql
      version: 3.2.1
      repository: http://another.example.com/charts

插件管理

插件提供了扩展 Helm 核心功能的方法，它在客户端执行，并放在 $(helm home)/plugins 目录中。一个典型的 helm 插件格式为

    $(helm home)/plugins/
    |- keybase/
        |
        |- plugin.yaml
        |- keybase.sh

而 plugin.yaml 格式为

    name: "keybase"
    version: "0.1.0"
    usage: "Integreate Keybase.io tools with Helm"
    description: |-
    This plugin provides Keybase services to Helm.
    ignoreFlags: false
    useTunnel: false
    command: "$HELM_PLUGIN_DIR/keybase.sh"

这样，就可以用 helm keybase 命令来使用这个插件。

Helm 常用命令

查询 charts
1
helm search mysql
查询 package 详细信息
1
helm inspect stable/mysql

部署 package

1	helm install stable/mysql

部署之前可以自定义 package 的选项：

# 查询支持的选项
helm inspect values stable/mysql

# 自定义 password 持久化存储
helm install --name db-mysql --set mysqlRootPassword=anoyi  stable/mysql

注意：如果出现无可用 PV，即 kubectl get pv 提示 No resources found. 需要创建 PV

创建pv

新建文件夹
1
mkdir /k8s

新建文件 local-pv.yaml，storage 大小依据当前主机的磁盘大小来修改，查看磁盘使用命令 df -lh

  apiVersion: "v1"
  kind: "PersistentVolume"
  metadata:
  name: "local-pv"
  spec:
  capacity:
      storage: "20Gi"
  accessModes:
      - "ReadWriteOnce"
  persistentVolumeReclaimPolicy: Recycle
  hostPath:
      path: /k8s

创建 PV
1
kubectl create -f local-pv.yaml
查看 Release 列表
1
helm ls

升级 / 回滚 Release

# 升级
helm upgrade --set mysqlRootPassword=passwd db-mysql stable/mysql

# 回滚
helm rollback db-mysql 1

删除 Release
1
helm delete --purge db-mysql

管理 repo

# 添加 incubator repo
helm repo add my-repo https://kubernetes-charts-incubator.storage.googleapis.com/

# 查询 repo 列表
helm repo list

# 生成 repo 索引（用于搭建 helm repository）
helm repo index

管理 chart

# 创建一个新的 chart
helm create hello-chart

# validate chart
helm lint

# 打包 chart 到 tgz
helm package hello-chart