helm入门指南及kubernetes应用部署实践
helm 入门指南
一、架构简述
Helm架构由Helm客户端、Tiller服务器端和Chart仓库所组成；Tiller部署在Kubernetes中，Helm客户端从Chart仓库中获取Chart安装包，并将其安装部署到Kubernetes集群中。node
二、安装helm
#下载安装包 wget https://storage.googleapis.com/kubernetes-helm/helm-v2.12.2-linux-amd64.tar.gz tar -zxvf helm-v2.12.2-linux-amd64.tar.gz cd linux-amd64/ cp helm /usr/local/bin/
三、安装tiller服务端
3.1 建立rbca
rbca-config.yamllinux
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
3.2 安装tiller
这里使用阿里的镜像和阿里的charts仓库，由于默认仓库和镜像须要×××nginx
helm init --upgrade -i registry.cn-hangzhou.aliyuncs.com/google_containers/tiller:v2.12.2 --aliyun-repo-url https://kubernetes.oss-cn-hangzhou.aliyuncs.com/charts
查看tiller是否安装完成web
# kubectl get pod -n kube-system -l app=helm NAME READY STATUS RESTARTS AGE tiller-deploy-84bcb9978c-5xccb 1/1 Running 2 10d
验证是否正常,注意 helm和tiller 版本要一致json
# helm version
Client: &version.Version{SemVer:"v2.12.2", GitCommit:"7d2b0c73d734f6586ed222a567c5d103fed435be", GitTreeState:"clean"}
Server: &version.Version{SemVer:"v2.12.2", GitCommit:"7d2b0c73d734f6586ed222a567c5d103fed435be", GitTreeState:"clean"}
3.3 卸载helm
helm reset 或 helm reset --force
四、helm的使用
4.1 仓库的操做
-
查看仓库列表api
# helm repo list NAME URL stable https://kubernetes.oss-cn-hangzhou.aliyuncs.com/charts bitnami https://charts.bitnami.com/bitnami emar http://192.168.1.57:8879
- 删除指定仓库
helm repo remove reponame
- 添加新的仓库地址
helm repo add stable https://kubernetes.oss-cn-hangzhou.aliyuncs.com/charts
- 更新仓库
helm repo update
- 建立私有仓
helm serve --address 192.168.1.57:8879 --repo-path /data/helm/repository/ --url http://192.168.1.57:8879/charts/ &
4.2 安装使用kubeapps
kubeapps是一个基于web的用户界面，用于部署和管理在kubernetes群集中的应用程序。Kubeapps容许你：安全
- 浏览并部署存储库中的chats
- 检查、升级和删除集群中安装的基于helm的应用程序
- 添加自定义和私有的chat存储库（支持ChartMuseum and JFrog Artifactory)
- 浏览并提供来自Service Catalog的外部服务和可用的服务中介
- 用服务目录绑定基于helm的应用程序链接到外部服务
- 基于kubernetes RBAC的安全认证和受权
安装访问服务器
- 使用helm安装
helm repo add bitnami https://charts.bitnami.com/bitnami helm install --name kubeapps --namespace kubeapps bitnami/kubeapps
- 建立Kubernetes API token
kubectl create serviceaccount kubeapps-operator kubectl create clusterrolebinding kubeapps-operator --clusterrole=cluster-admin --serviceaccount=default:kubeapps-operator
- 访问kubeapps dashboard
#使用port-forward代理访问pod，能够临时从外网访问。这种方式临时使用能够，最好改为ingress模式 export POD_NAME=$(kubectl get pods -n kubeapps -l "app=kubeapps,release=kubeapps" -o jsonpath="{.items[0].metadata.name}") kubectl port-forward --address 0.0.0.0 -n kubeapps $POD_NAME 8080:8080
卸载kubeapps架构
helm delete --purge kubeapps kubectl delete crd apprepositories.kubeapps.com
5 构建本身的helm chart
下面咱们经过一个完整的示例来学习如何使用 Helm 建立、打包、分发、安装、升级及回退Kubernetes应用。并发
5.1 建立自定义chart，默认建立的chart是nginx
helm create firstchart
查看mychart结构：
firstchart/ ├── charts ├── Chart.yaml ├── templates │ ├── deployment.yaml │ ├── _helpers.tpl │ ├── ingress.yaml │ ├── NOTES.txt │ └── service.yaml └── values.yaml
生成chart目录里有Chart.yaml, values.yaml and NOTES.txt等文件，下面分别对chart中几个重要文件解释：
- Chart.yaml 包含了chart的metadata，描述了Chart名称、描述信息与版本。
- values.yaml：存储了模板文件变量。
- templates/：记录了所有模板文件。
- charts/：依赖chart存储路径。
其中firstchart/templates/的文件及其做用以下：
- NOTES.txt：给出了部署chart后的帮助文档，例如如何使用chart、列出默认的设置等。
- deployment.yaml：建立 Kubernetes deployment的yaml文件。
- service.yaml：建立deployment的service endpoint yams文件。
- _helpers.tpl: 模板使用帮助文件。
Templates 目录下 YAML 文件模板的值默认都是在 values.yaml 里定义的，好比在 deployment.yaml 中定义的容器镜像。
image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
其中的 .Values.image.repository 的值就是在 values.yaml 里定义的 nginx，.Values.image.tag 的值就是 stable。
$ cat firstchart/values.yaml|grep repository repository: nginx $ cat firstchart/values.yaml|grep tag tag: stable
以上两个变量值是在 create chart 的时候就自动生成的默认值，你能够根据实际状况进行修改。
5.2 编写应用的介绍信息
打开 Chart.yaml, 填写你部署的应用的详细信息，以 firstchart 为例：
$ cat firstchart/Chart.yaml apiVersion: v1 appVersion: "1.0" description: A Helm chart for Kubernetes name: firstchart version: 0.1.0
5.3 编写应用具体部署信息
编辑 values.yaml，它默认会在 Kubernetes 部署一个 Nginx。下面是 firstchart 应用的 values.yaml 文件的内容：
$ cat mychart/values.yaml
# Default values for mychart.
# This is a YAML-formatted file.
# Declare variables to be passed into your templates.
replicaCount: 1
image:
repository: nginx
tag: stable
pullPolicy: IfNotPresent
service:
type: ClusterIP
port: 80
ingress:
enabled: false
annotations: {}
# kubernetes.io/ingress.class: nginx
# kubernetes.io/tls-acme: "true"
path: /
hosts:
- chart-example.local
tls: []
# - secretName: chart-example-tls
# hosts:
# - chart-example.local
resources: {}
# We usually recommend not to specify default resources and to leave this as a conscious
# choice for the user. This also increases chances charts run on environments with little
# resources, such as Minikube. If you do want to specify resources, uncomment the following
# lines, adjust them as necessary, and remove the curly braces after 'resources:'.
# limits:
# cpu: 100m
# memory: 128Mi
# requests:
# cpu: 100m
# memory: 128Mi
nodeSelector: {}
tolerations: []
affinity: {}
5.4 检查依赖和模板配置是否正确
$ helm lint firstchart/ ==> Linting . [INFO] Chart.yaml: icon is recommended 1 chart(s) linted, no failures
若是文件格式错误，能够根据提示进行修改。
5.5 将应用打包
$ helm package firstchart Successfully packaged chart and saved it to: /data/helm/repository/firstchart-0.1.0.tgz
firstchart 目录会被打包为一个 firstchart-0.1.0.tgz 格式的压缩包，该压缩包会被放到当前目录下。
若是你想看到更详细的输出，能够加上 --debug 参数来查看打包的输出，输出内容应该相似以下：
$ helm package firstchart --debug Successfully packaged chart and saved it to: /data/helm/repository/firstchart-0.1.0.tgz [debug] Successfully saved /home/k8s/mychart-0.1.0.tgz to /data/helm/repository/
5.5 将应用发布到 Repository
虽然咱们已经打包了 Chart 并发布到了 Helm 的本地目录中，但经过 helm search 命令查找，并不能找不到刚才生成的 firstchart包。
$ helm search mychart No results found
这是由于 Repository 目录中的 Chart 包尚未被 Helm 管理。经过 helm repo list 命令能够看到目前 Helm 中已配置的 Repository 的信息。
# helm repo list NAME URL stable https://kubernetes.oss-cn-hangzhou.aliyuncs.com/charts bitnami https://charts.bitnami.com/bitnami emar http://192.168.1.57:8879
经过 helm repo index 命令将 Chart 的 Metadata 记录更新在 index.yaml 文件中:
# 更新 Helm Repository 的索引文件 $ cd /data/helm/repository/ $ helm repo index --url=http://192.168.1.57:8879/charts .
如今再次查找 firstchart 包，就能够搜索到了。
$ helm repo update $ helm search firstchart NAME CHART VERSION APP VERSION DESCRIPTION firstchart 0.1.0 1.0 A Helm chart for Kubernetes
6 在 Kubernetes 中部署应用
6.1 部署一个应用
注: 由于网上文档都是deployment，我这里使用daemonset来展现
来看下基于busybox，daemonset的配置
#tree . . ├── charts ├── Chart.yaml ├── templates │ ├── busybox-ds.yaml │ ├── _helpers.tpl │ └── NOTES.txt └── values.yaml
查看value
# more values.yaml # Default values for busybox-ds. # This is a YAML-formatted file. # Declare variables to be passed into your templates. image: repository: busybox tag: latest pullPolicy: IfNotPresent
查看template里面的busybox-ds.yaml
apiVersion: extensions/v1beta1
kind: DaemonSet
metadata:
name: busybox
spec:
template:
metadata:
labels:
app: busybox
spec:
containers:
- name: busybox
image: {{ .Values.image.repository }}:{{ .Values.image.tag }}
command:
- sleep
- "3600"
nodeSelector:
ds-test: dstest
status:
Chart 被发布到仓储后，就能够经过 helm install 命令部署该 Chart。
- 检查配置和模板是否有效
当使用helm install 命令部署应用时，实际上就是将 templates 目录下的模板文件渲染成 Kubernetes 可以识别的 YAML 格式。
在部署前咱们可使用
helm install --dry-run --debug <chart_dir> --name <release_name>
命令来验证 Chart 的配置。该输出中包含了模板的变量配置与最终渲染的 YAML 文件。
[root@kvm-ht242057 busybox-ds]# helm install --debug --dry-run --set image.tag='2.0' .
[debug] Created tunnel using local port: '22888'
[debug] SERVER: "127.0.0.1:22888"
[debug] Original chart version: ""
[debug] CHART PATH: /etc/kubernetes/addons/helm/busybox-ds
NAME: bailing-terrier
REVISION: 1
RELEASED: Tue Jan 29 15:20:54 2019
CHART: busybox-ds-0.2.1
USER-SUPPLIED VALUES:
image:
tag: "2.0"
COMPUTED VALUES:
image:
pullPolicy: IfNotPresent
repository: busybox
tag: "2.0"
HOOKS:
MANIFEST:
---
# Source: busybox-ds/templates/busybox-ds.yaml
apiVersion: extensions/v1beta1
kind: DaemonSet
metadata:
name: busybox
spec:
template:
metadata:
labels:
app: busybox
spec:
containers:
- name: busybox
image: busybox:2.0
command:
- sleep
- "3600"
nodeSelector:
ds-test: dstest
status:
验证完成没有问题后，咱们就可使用如下命令将其部署到 Kubernetes 上了。
# 部署时需指定 Chart 名及 Release（部署的实例）名。 helm install emar/busybox-ds --name busybox Release "busybox" has been upgraded. Happy Helming! LAST DEPLOYED: Thu Jan 24 17:39:26 2019 NAMESPACE: default STATUS: DEPLOYED RESOURCES: ==> v1beta1/DaemonSet NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE busybox 1 1 1 0 1 ds-test=dstest 24h ==> v1/Pod(related) NAME READY STATUS RESTARTS AGE busybox-n7725 1/1 Running 24 24h NOTES: please ignore it, this is a test node selector: ds-test: dstest
注意 ：helm install 默认会用到 socat，须要在全部节点上安装 socat 软件包。
完成部署后，如今 busybox 就已经部署到 Kubernetes 集群上。
# kubectl get ds NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE busybox 1 1 1 0 1 ds-test=dstest 5d22h
使用下面的命令列出的全部已部署的 Release 以及其对应的 Chart。
# helm list NAME REVISION UPDATED STATUS CHART APP VERSION NAMESPACE busybox 6 Thu Jan 24 17:40:02 2019 DEPLOYED busybox-ds-0.2.1 1.0 default dealing-buffalo 1 Thu Jan 24 17:39:02 2019 FAILED busybox-ds-0.2.1 1.0 default kubeapps 1 Tue Jan 22 17:45:00 2019 DEPLOYED kubeapps-1.2.3 v1.1.1 kubeapps wobbling-butterfly 1 Thu Jan 24 17:25:48 2019 FAILED busybox-ds-0.2.1 1.0 default
还可使用 helm status 查询一个特定的 Release 的状态。
helm status busybox LAST DEPLOYED: Thu Jan 24 17:40:02 2019 NAMESPACE: default STATUS: DEPLOYED RESOURCES: ==> v1beta1/DaemonSet NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE busybox 1 1 1 0 1 ds-test=dstest 5d22h ==> v1/Pod(related) NAME READY STATUS RESTARTS AGE busybox-n7725 1/1 Running 142 5d22h NOTES: please ignore it, this is a test node selector: ds-test: dstest
6.2 升级和回退一个应用
从上面 helm list 输出的结果中咱们能够看到有一个 Revision（更改历史）字段，该字段用于表示某一个 Release 被更新的次数，咱们能够用该特性对已部署的 Release 进行回滚
- 修改 Chart.yaml 文件
将版本号从 0.1.0 修改成 0.2.0, 而后使用 helm package 命令打包并发布到本地仓库
$ cat busybox-ds/Chart.yaml apiVersion: v1 appVersion: "1.0" description: A Helm chart for Kubernetes,test Daemonset name: busybox version: 0.2.0 $ helm package busybox-ds Successfully packaged chart and saved it to: /data/helm/repository/busybox-ds-0.2.0.tgz
咱们能够看到在本地仓库中 busybox-ds 有两个版本。
# helm search busy -l NAME CHART VERSION APP VERSION DESCRIPTION emar/busybox-ds 0.2.0 1.0 A Helm chart for Kubernetes, test Daemonset emar/busybox-ds 0.1.0 1.0 A Helm chart for Kubernetes
6.2.1 升级一个应用
如今用 helm upgrade 命令将已部署的 busybox 升级到新版本。你能够经过 --version 参数指定须要升级的版本号，若是没有指定版本号，则缺省使用最新版本。
helm upgrade emar/busybox-ds --name busybox Release "busybox" has been upgraded. Happy Helming! LAST DEPLOYED: Thu Jan 24 17:39:26 2019 NAMESPACE: default STATUS: DEPLOYED RESOURCES: ==> v1beta1/DaemonSet NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE busybox 1 1 1 0 1 ds-test=dstest 24h ==> v1/Pod(related) NAME READY STATUS RESTARTS AGE busybox-n7725 1/1 Running 24 24h NOTES: please ignore it, this is a test node selector: ds-test: dstest
完成后，能够看到已部署的 mike-test 被升级到 0.2.0 版本
helm list NAME REVISION UPDATED STATUS CHART APP VERSION NAMESPACE busybox 6 Thu Jan 24 17:40:02 2019 DEPLOYED busybox-ds-0.2.0 2.0 default
6.2.2 回滚一个应用
若是更新后的程序因为某些缘由运行有问题，须要回退到旧版本的应用。首先咱们可使用 helm history 命令查看一个 Release 的全部变动记录
# helm history busybox REVISION UPDATED STATUS CHART DESCRIPTION 1 Wed Jan 23 17:04:18 2019 SUPERSEDED busybox-ds-0.1.1 Install complete 2 Wed Jan 23 17:09:47 2019 SUPERSEDED busybox-ds-0.2.1 Upgrade complete 3 Wed Jan 23 17:11:01 2019 SUPERSEDED busybox-ds-0.1.1 Rollback to 1 4 Wed Jan 23 17:13:05 2019 SUPERSEDED busybox-ds-0.2.1 Upgrade complete 5 Thu Jan 24 17:39:26 2019 SUPERSEDED busybox-ds-0.2.1 Upgrade complete 6 Thu Jan 24 17:40:02 2019 DEPLOYED busybox-ds-0.2.1 Upgrade complete
其次，咱们可使用下面的命令对指定的应用进行回退。
$ helm rollback busybox 1 Rollback was a success! Happy Helming!
- 注：其中的参数 1 是 helm history 查看到 Release 的历史记录中 REVISION 对应的值。
6.2.3 如何快速上线和回滚
若是每次上线回滚都要打包，更新chart仓，明显是不切实际的。由于业务上线不只要保证稳定、可追溯，也要保证时效。
一、使用set参数，动态指定镜像tag。这里要用到values.yaml
以busybox举例：
values.yaml
# Default values for busybox-ds. # This is a YAML-formatted file. # Declare variables to be passed into your templates. image: repository: busybox tag: latest pullPolicy: IfNotPresent
关于values的相关命令
查看charts默认配置 helm inspect values busybox 覆盖chart中的默认值，经过指定配置文件方式 helm install -f values.yaml ./busybox 或者经过–set key=value形式 helm install --set image.tag='2.0' ./busybox 单独跑查看配置是否正常 helm install -debug --dry-run --set image.tag='2.0'
咱们能够看到，每次上线没必要修改charts,只要修改image 的tag，就能够达到修改镜像版本的目的，这样就能够快速变动imagetag，达到快速上线和回滚。
注：对于单一项目的多个配置，咱们也能够写多个values.yaml来实现不一样的环境，启动的时候指定不一样的values.yaml来实现环境的区分。就是写多个文件，这里不详细演示了。
6.3 删除一个应用
- 若是须要删除一个已部署的 Release，能够利用 helm delete 命令来完成删除。
# helm delete busybox release "busybox" deleted
- 确认应用是否删除，该应用已被标记为 DELETED 状态。
# helm ls -a busybox NAME REVISION UPDATED STATUS CHART APP VERSION NAMESPACE busybox 1 Thu Jan 24 17:39:02 2019 DELETED busybox-ds-0.2.1 1.0 default
- 也可使用 --deleted 参数来列出已经删除的 Release
# helm ls --deleted NAME REVISION UPDATED STATUS CHART APP VERSION NAMESPACE busybox 1 Thu Jan 24 17:39:02 2019 DELETED busybox-ds-0.2.1 1.0 default
- 从上面的结果也能够看出，默认状况下已经删除的 Release 只是将状态标识为 DELETED 了 ，但该 Release 的历史信息仍是继续被保存的。
# helm hist busybox REVISION UPDATED STATUS CHART DESCRIPTION 1 Thu Jan 24 17:39:02 2019 DELETED busybox-ds-0.2.1 Deletion complete 2 Wed Jan 23 17:09:47 2019 SUPERSEDED busybox-ds-0.2.1 Upgrade complete 3 Wed Jan 23 17:11:01 2019 SUPERSEDED busybox-ds-0.1.1 Rollback to 1
- 若是要移除指定 Release 全部相关的 Kubernetes 资源和 Release 的历史记录，能够用以下命令：
# helm delete --purge busybox release "busybox" deleted
- 再次查看已删除的 Release，已经没法找到相关信息。
# helm hist busybox Error: release: "busybox" not found # helm ls 命令也已均无查询记录。 # helm ls --deleted # helm ls -a busybox
相关文章
- 1. Kubernetes Helm入门指南
- 2. CentOS 7 Kubernetes应用部署指南 Kubeapps+Dashboard+Helm
- 3. Helm 入门指南
- 4. 利用Helm简化Kubernetes应用部署
- 5. JupyterHub on Kubernetes部署与应用指南
- 6. github actions 入门指南及博客自动部署实践
- 7. 简化Kubernetes应用部署工具-Helm
- 8. 简化kubernetes应用部署工具之Helm应用部署
- 9. Kubernetes应用部署策略实践
- 10. 《Kubernetes指南》1-Kubernetes入门
- 更多相关文章...
- • SQL 指南 - 网站建设指南
- • HTML 指南 - 网站建设指南
- • TiDB 在摩拜单车在线数据业务的应用和实践
- • Java Agent入门实战（一）-Instrumentation介绍与使用
相关标签/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
欢迎关注本站公众号,获取更多信息
相关文章