Kubernetes 应用管理工具 Helm 使用指南

轻量级云原生架构实验室

发布于 2018-08-02 11:19:49

1.2K0

发布于 2018-08-02 11:19:49

文章被收录于专栏：轻量级微服务

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