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

作者: Anoyi

2018.06.28 15:33*

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

相关资料

评论

评论

昵称
邮箱