曾国藩:一勤天下无难事

Helm安装使用

2019.05.09

简介

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
    

相关资料