Kubernetes 应用管理工具 Helm 使用指南
Helm 是一个类似于 yum/apt/homebrew 的 Kubernetes 应用管理工具。Helm 使用 Chart 来管理 Kubernetes manifest 文件。
安装 Helm
1、使用官方脚本安装最新版
curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get > get_helm.sh
chmod 700 get_helm.sh
./get_helm.sh
2、更新 charts 列表
helm repo update
3、为 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
然后，执行
kubectl create -f rbac-config.yaml
4、查看 Helm 版本号
helm version
Client: &version.Version{SemVer:"v2.9.1", GitCommit:"20adb27c7c5868466912eebdf6664e7390ebe710", GitTreeState:"clean"}
5、初始化 Helm 并安装 Tiller 服务（需要事先配置好 kubectl）
helm init --upgrade --service-account tiller --tiller-image registry.cn-hangzhou.aliyuncs.com/google_containers/tiller:v2.9.1
Helm 工作原理
1、基本概念
- Chart：包含了创建一个 Kubernetes 应用的必要信息
- Repository：Helm package 存储仓库
- Release：是一个 chart 及其配置的一个运行实例
2、组成结构
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
3、helm charts
Helm 使用 Chart 来管理 Kubernetes manifest 文件。每个 chart 都至少包括
- 应用的基本信息
Chart.yaml - 一个或多个 Kubernetes manifest 文件模版（放置于
templates/目录中），可以包括 Pod、Deployment、Service 等各种 Kubernetes 资源 - 模板默认值
values.yaml（可选）
示例 Chart ： Mysql
4、依赖管理
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
5、插件管理
插件提供了扩展 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
helm search mysql
☆ 查询 package 详细信息
helm inspect stable/mysql
☆ 部署 package
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，步骤如下：
① 新建文件夹 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
kubectl create -f local-pv.yaml
☆ 查看 Release 列表
helm ls
☆ 升级 / 回滚 Release
# 升级
helm upgrade --set mysqlRootPassword=passwd db-mysql stable/mysql
# 回滚
helm rollback db-mysql 1
☆ 删除 Release
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
