简介

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

安装 Helm

  • 使用官方脚本安装最新版
curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get > get_helm.sh
chmod 700 get_helm.sh
./get_helm.sh
  • 更新 charts 列表
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
      
    • 执行以下命令创建

    kubectl create -f rbac-config.yaml
    
  • 查看 Helm 版本号

[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)
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
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

创建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
    

相关资料