helm3的基础使用

2021-04-03 本文已影响0人流雨声

helm3的资源与调试

概述

美国时间 2019 年 11 月 13 日，Helm 团队宣布 Helm 3 第一个稳定版本发布。
Helm 3 以 Helm 2 的核心功能为基础，对 Chart repo、发行版管理、安全性和 library Charts 进行了改进。
相比 Helm 2，Helm 3 最明显的变化是 Tiller 的删除，它新增丰富功能，某些功能已被弃用或重构，与 Helm 2 不再兼容。此外，Helm 3 还引入了一些新的实验功能，包括 OCI 支持。
Helm Go SDK 已重构为通用，目标是共享和重用 Go 社区开源代码。

什么是 Helm

Helm 为团队提供了在 Kubernetes 内部创建、安装和管理应用程序时需要协作的工具，有点类似于 Ubuntu 中的 APT 或 CentOS 中的 YUM。
有了 Helm，开发者可以：

查找要安装和使用的预打包软件（Chart）
轻松创建和托管自己的软件包
将软件包安装到任何 K8s 集群中
查询集群以查看已安装和正在运行的程序包
更新、删除、回滚或查看已安装软件包的历史记录
……

Helm 组件及相关术语

helm

Helm 是一个命令行下的客户端工具。主要用于 Kubernetes 应用程序 Chart 的创建、打包、发布以及创建和管理本地和远程的 Chart 仓库。

Chart

Helm 的软件包，采用 TAR 格式。类似于 APT 的 DEB 包或者 YUM 的 RPM 包，其包含了一组定义 Kubernetes 资源相关的 YAML 文件。

Repoistory

Helm 的软件仓库，Repository 本质上是一个 Web 服务器，该服务器保存了一系列的 Chart 软件包以供用户下载，并且提供了一个该 Repository 的 Chart 包的清单文件以供查询。Helm 可以同时管理多个不同的 Repository。

Release

使用 helm install 命令在 Kubernetes 集群中部署的 Chart 称为 Release。可以理解为 Helm 使用 Chart 包部署的一个应用实例。

安装 Helm3

二进制安装

$ wget https://get.helm.sh/helm-v3.1.2-linux-amd64.tar.gz

$ tar -zxvf helm-v3.1.2-linux-amd64.tar.gz$ cd linux-amd64

$ mv helm /usr/local/bin/$ helm --help

脚本安装

$ curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3

$ chmod 700 get_helm.sh$ ./get_helm.sh

命令补全

# 在~/.bashrc追加
source <(helm completion bash)

其他安装详情

快速开始

添加常用仓库

$ helm repo add stable https://kubernetes-charts.storage.googleapis.com/
$ helm repo add bitnami https://charts.bitnami.com/bitnami
$ helm repo add incubator https://kubernetes-charts-incubator.storage.googleapis.com/
$ helm repo update              # Make sure we get the latest list of charts

微软也提供了stable仓库的镜像：

stable: http://mirror.azure.cn/kubernetes/charts/

列出stable仓库可以安装的charts

helm search repo stable

安装stable仓库的一个mysql的chart

$ helm install stable/mysql --generate-name

查看详情

$ helm show all stable/mysql

查看chart怎么写的

$ helm pull stable/mysql
$ ls mysql-1.6.3.tgz$ tar -zxvf mysql-1.6.3.tgz
$ tree mysqlmysql

查看用helm安装的release

$ helm ls
NAME             VERSION   UPDATED                   STATUS    CHART
smiling-penguin  1         Wed Sep 28 12:59:46 2016  DEPLOYED  mysql-0.1.0

卸载release

$ helm uninstall smiling-penguin

查看status

$ helm status smiling-penguin
Status: UNINSTALLED

Chart 的使用

下面我们通过一个完整的示例来学习如何使用 Helm 创建、打包、分发、安装、升级及回退Kubernetes应用。

创建一个名为 mychart 的 Chart

官网的例子

$ helm create mychart

该命令在当前目录创建了一个 mychart 目录，该目录结构如下所示:

$ tree mychart/mychart/

介绍:

Templates 目录下 YAML 文件模板(go template语法)填充的值默认都是在 values.yaml 里定义的，比如在 deployment.yaml 中定义的容器镜像:

image: "{{ .Values.image.repository }}:{{ .Chart.AppVersion }}"

$ cat mychart/values.yaml|grep repository  
repository: nginx

以上变量值是在 create chart 的时候就自动生成的默认值，你可以根据实际情况进行修改。

编写应用的介绍信息

打开 mychart/Chart.yaml：

编写应用具体部署信息
编辑 mychart/values.yaml，它默认会在 Kubernetes 部署一个 Nginx。下面是 mychart 应用的 values.yaml 文件的内容：

检查依赖和模板配置是否正确

$ helm lint mychart/
==> Linting mychart/[INFO] 
Chart.yaml: icon is recommended1 chart(s) 
linted, 0 chart(s) failed

如果文件格式错误，可以根据提示进行修改。

将应用打包

$ helm package mychart
Successfully packaged chart and saved it to: /root/mychart-0.1.0.tgz

mychart 目录会被打包为一个 mychart-0.1.0.tgz 格式的压缩包，该压缩包会被放到当前目录下。
如果你想看到更详细的输出，可以加上 --debug 参数来查看打包的输出。

离线部署

注意: ~/.kube/config不存在的情况下要用 helm --kubeconfig 指定配置文件

# 方式一
$ helm install demo-test ./mychart
# 可根据不同的配置来install，默认是values.yaml
# helm install demo-test ./mychart -f ./mychart/values-prod.yaml
# 方式二
$ helm install demo-test ./mychart-0.1.0.tgz
$ helm list
# 升级 
$ helm upgrade demo-test ./mychart-0.2.0.tgz
$ helm uninstall demo-test

将应用发布到 Repository

harbor1.6+ 支持存储 helm charts，这里使用 helm 安装 harbor
这里为了简化测试操作，我关闭了数据卷的挂载并使用的是 NodePort 方式进行访问。

$ helm repo add goharbor https://helm.goharbor.io
$ helm repo update
# 查看harbor chart的各个版本
$ helm search repo harbor -l
# --version选择chart的版本
$ helm install harbor goharbor/harbor --set persistence.enabled=false --set expose.type=nodePort --set expose.tls.enabled=false --set externalURL=http://10.13.84.187:30002

参数说明：

persistence.enabled=false 关闭存储，为了方便操作，真实使用时需要挂在存储
expose.type=nodePort 使用 NodePort 访问
expose.tls.enabled=false 关闭tls
externalURL=http://10.13.84.187:30002 设置登录 harbor 的外部链接，ip是某个node的ip

harbor 装好之后，我们访问 http://10.13.84.187:30002 进行登录 harbor, harbor 的默认账号密码是 admin/Harbor12345
新建一个项目 chart_repo
新建一个用户test，密码Test1234，加入到项目的成员里面，并赋予权限
安装使用 helm-push 插件

helm plugin install https://github.com/chartmuseum/helm-push

超时没装成功，直接下载:

$ mkdir ~/.local/share/helm/plugins/helm-push
$ wget https://github.com/chartmuseum/helm-push/releases/download/v0.8.1/helm-push_0.8.1_linux_amd64.tar.gz$ tar -zxvf helm-push_0.8.1_linux_amd64.tar.gz -C ~/.local/share/helm/plugins/helm-push$ helm push --help

添加repo

# helm repo add --ca-file  --cert-file  --key-file      --username  --password   http://10.13.84.187:30002/chartrepo/chart_repo
$ helm repo add myrepo http://10.13.84.187:30002/chartrepo/chart_repo

push

$ helm push mychart/ myrepo -u test -p Test1234Pushing mychart-0.1.0.tgz to myrepo...Done.

查找chart

$ helm repo update
$ helm search repo mychart
NAME              CHART VERSION    APP VERSION    DESCRIPTION                
myrepo/mychart    0.1.0            1.16.0          A Helm chart for Kubernetes

部署应用

注意: ~/.kube/config不存在的情况下要用 helm --kubeconfig 指定配置文件

# helm install --ca-file  --cert-file  --key-file      --username= --password= --version 0.2.0 /mychart
# 在部署前使用 --dry-run 参数验证 Chart 的配置
$ helm install demo-test  --dry-run --debug myrepo/mychart
# 没问题就install
$ helm install demo-test  myrepo/mychart

测试:

export POD_NAME=$(kubectl get pods --namespace default -l "app.kubernetes.io/name=mychart,app.kubernetes.io/instance=demo-test" -o jsonpath="{.items[0].metadata.name}")
echo "Visit http://127.0.0.1:8080 to use your application"
kubectl --namespace default port-forward $POD_NAME 8080:80

访问nginx

curl http://127.0.0.1:8080

使用下面的命令列出的所有已部署的 Release 以及其对应的 Chart。

$ helm list
NAME                      NAMESPACE    REVISION    UPDATED                                    STATUS      CHART                      APP VERSION
demo-test                 default      1           2020-04-21 11:06:27.672714497 +0800 CST    deployed    mychart-0.1.0              1.16.0

从上面 helm list 输出的结果中我们可以看到有一个 REVISION（更改历史）字段，该字段用于表示某一个 Release 被更新的次数，我们可以用该特性对已部署的 Release 进行回滚。
查看状态

$ helm status demo-test 
NAME: demo-testLAST 
DEPLOYED: Tue Apr 21 11:06:27 2020
NAMESPACE: default
STATUS: deployed
REVISION: 1
NOTES:1. Get the application URL by running these commands:  
export POD_NAME=$(kubectl get pods --namespace default -l "app.kubernetes.io/name=mychart,app.kubernetes.io/instance=demo-test" -o jsonpath="{.items[0].metadata.name}")  
echo "Visit http://127.0.0.1:8080 to use your application"  
kubectl --namespace default port-forward $POD_NAME 8080:80

升级应用

修改 mychart/Chart.yaml 文件

apiVersion: v2
name: mychart
description: A Helm chart for Kubernetes
type: application
# 改了下面两行
version: 0.2.0
appVersion: 1.17.0

上传chart

$ helm push mychart/ myrepo -u test -p Test1234
Pushing mychart-0.2.0.tgz to myrepo...Done.
$ helm repo udpate
$ helm search repo mychart -l
NAME              CHART VERSION    APP VERSION    DESCRIPTION                
myrepo/mychart    0.2.0            1.17.0          A Helm chart for Kubernetes
myrepo/mychart    0.1.0            1.16.0          A Helm chart for Kubernetes