Helm干货!速度围观!

2023-02-12,,,

最近个人学习Helm,感觉Helm的功能很强大!分享一些干货给大家吧,希望有所帮助!

基本概念

Chart

一个Helm包,包含在K8S集群内,运行一个应用,工具或者服务所需要的所有的资源定义,类似于一个RPM包

Repository

Charts在这里被汇集并共享,它有点像Fedora Package Database,但是是用于kubernetes packages

Release

一个Release相当于一个Chart运行在K8S集群中的一个实例,一个Chart可以在相同集群中安装多次,每次安装,一个Release就被创建,例如MySQL chart,如果你想让两个数据库运行在你的集群,你可以安装相同的Chart多次,每一次一个release,它拥有自己的Release名字。

部署

可以参考如下的网站进行安装

https://helm.sh/doc/intro/install/

https://kubeapps.com/doc/getting-started/

Helm基础命令

基础命令篇

添加公有Repo

helm repo add https://charts.bitnami.com/bitnami

添加私有Repo

helm repo add --username=no-user --password admin@123 https://github.bithaha.com/helm

列出Repo

helm repo list

列出已经安装的charts

helm list

注意 默认是查看default命名空间下
若要切换,-n namespace即可,如:

helm list -n abc

搜索Repo

helm search repo nginx

安装helm包

helm install bitnami-nginx bitnami/nginx

注意 默认是安装到default命名空间下
若指定命名空间,请务必确保命名空间存在的情况之下再指定 :

helm install bitnami-nginx bitnami/nginx -n abc

helm设置参数

设置参数

helm install bithaha bithaha/test-helm --version 0.1.0 --set replicaCount=2,image.tag=1.21

这段意思大概是安装一个test-helm,版本是0.1.0,设置副本数量为2,images的版本是1.21

查看参数

helm get values test-helm

重置一下value

helm upgrade bithaha bithaha/test-helm --reset-values

显示所有的values

helm get values -a bithaha

helm创建自己的charts

创建chart

helm create qqq-helm

检查chart

helm lint qqq-helm

打包chart

helm package qqq-helm

Helm模板

官方文档

https://helm.sh/docs/chart_temlpate_guide/getting_started/

chart默认结构

tree qqai-helm
qqai-helm
|
>charts
>chart.yaml
>templates
——》 deployment.yaml
——》 _helpers.tpl
——》 hpa.yaml
——》 ingress.yaml
——》 NOTES.txt
——》 serviceaccount.yaml
——》 service.yaml
——》 tests
>test-connection.yaml
>values.yaml

templates目录

# 目录结构
>templates
——》 deployment.yaml
——》 _helpers.tpl
——》 hpa.yaml
——》 ingress.yaml
——》 NOTES.txt
——》 serviceaccount.yaml
——》 service.yaml
——》 tests
>test-connection.yaml

templates实战

1、在templates目录中创建一个configmap的YAML文件

cat >/root/qqai-helm/templates/configmap.yaml <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
myvalue: "fook"
EOF

2、测试模板可用性

helm install --debug --dry-run qqai-helm-demo ./qqai-helm

常用的对象说明

Release

Release.Name: Install的时候的名称

Release.Namespace: 命名空间,这个没啥好解释的,默认值是default

Release.IsUpgrade:是升级,如果true那就升级了。

Values,Chart

Values: 来自于values.yaml中定义的参数,默认的Value是空值的

Chart: 来自于Chart.yaml中定义的参数,可以根据需要灵活搭配

Values文件

Values来自于多个源,下面是覆盖顺序,最后的优先

Chart中的values.yaml文件
子Chart中的values.yaml文件
。。。。。。

Values实战

cat /root/qqai-helm/values.yaml <<EOF
banben: v1
shuiguo: apple
mingzi:
name: zhangsan
EOF cat /root/qqai-helm/configmap.yaml <<EOF
apiVersion: {{ .Values.banben}}
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
myvalue: "Hello World"
name: {{ .Values.mingzi.name }}
fruit: {{ .Values.shuiguo }}
EOF

验证一下吧

helm install --debug --dry-run qqai-helm-demo ./qqai-helm

模板函数与管道符

引用上述的案例吧

cat /root/qqai-helm/values.yaml <<EOF
banben: v1
shuiguo: apple
mingzi:
name: zhangsan
EOF cat /root/qqai-helm/configmap.yaml <<EOF
apiVersion: {{ .Values.banben}}
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
myvalue: "Hello World"
name: {{ .Values.mingzi.name }}
fruit: {{ .Values.shuiguo }}
EOF

若将上述案例添加相关的函数,可以像下面这样的做法

cat /root/qqai-helm/values.yaml <<EOF
banben: v1
shuiguo: apple
mingzi:
name: zhangsan
EOF cat /root/qqai-helm/configmap.yaml <<EOF
apiVersion: {{ .Values.banben}}
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
myvalue: "Hello World"
name: {{ .Values.mingzi.name |repeat 5 }}
age: {{ .Values.mingzi.age |default "18" }}
fruit: {{ .Values.shuiguo | upper | quote}}
EOF

流程控制概述

可以通过流程控制来控制helm的逻辑流程,保证部署的正确性。

流程控制-if/else: 如果或者

基本格式

{{ if PIPELINE }}
# Do something
{{ else if OTHER PIPELINE }}
# Do something
{{ else }}
# Default case
{{ end }}

范例

还是请我们老演员登场

cat /root/qqai-helm/values.yaml <<EOF
banben: v1
shuiguo: apple
mingzi:
name: zhangsan
# age: 30
EOF cat /root/qqai-helm/configmap.yaml <<EOF
apiVersion: {{ .Values.banben}}
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
myvalue: "Hello World"
name: {{ .Values.mingzi.name |repeat 5 }}
age: {{ .Values.mingzi.age |default "18" }}
fruit: {{ .Values.shuiguo | upper | quote}}
{{ if eq .Values.mingzi.age "30" }}mug: "true"{{ end }}
EOF

流程控制-with: 指定一个范围

这里需要一个范例来解释下with的具体含义

cat /root/qqai-helm/values.yaml <<EOF
mingzi:
name: zhangsan
age: ten
EOF cat /root/qqai-helm/configmap.yaml <<EOF
apiVersion: {{ .Values.banben}}
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
myvalue: "Hello World"
{{- with .Values.mingzi }}
name: {{ .name|default "lisi"|quote }}
age: {{ .age |upper|quote }}
{{- end }}
EOF

错误示范:

cat /root/qqai-helm/configmap.yaml <<EOF
apiVersion: {{ .Values.banben}}
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
myvalue: "Hello World"
{{- with .Values.mingzi }}
name: {{ .name|default "lisi"|quote }}
age: {{ .age |upper|quote }}
release: {{ .Release.Name }}
{{- end }}
EOF

流程控制-range: For循环

下面演示range如何循环起来

Values.yaml

cat /root/qqai-helm/values.yaml <<EOF
mingzi:
name: zhangsan
age: ten
job:
- sales
- engineer
- guestserver
EOF

configmap.yaml

cat /root/qqai-helm/configmap.yaml <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: {{ .Release.Name }}
data:
config: prometheus
{{- with .Values.mingzi }}
name: {{ mingzi|upper }}
{{- end}}
group: |-
{{- range .Values.job }}
- {{ .|title|quote }}
{{- end}}
EOF

Helm之变量--Variables

下面一个示范教你如何来定义变量

# 普通的定义
cat /root/qqai-helm/configmap.yaml <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
name: {{ .Release.Name }}-configmap
data:
config: "hello world"
{{- $relname :=.Release.Name -}}
{{- with .Values.favorite }}
drink: {{ .drink|default "coka" |quote }}
release: {{ $relname }}
{{- end}}

Templates

下面案例可以告诉你怎么定义这个模板

# 定义一个模板
{{- define "qqai-helm.labels" }}
labels:
generator: helm
date: {{ now | htmlDate }}
{{- end }}
apiVersion: v1
kind: ConfigMap
metadata:
name:{{ .Release.Name }}-configmap
# 此处引用模板
{{- template "qqai-helm-labels" }}
data:
myvalue: "hello world"
一定注意格式,一定注意格式,一定注意格式

NOTES.txt

帮助信息,在安装时可以提醒用户如何操作,随便写写就好,要让用户明白即可。

最后希望大家在写的过程中一定注意格式!注意格式!注意格式!第一次写,希望各位有所收货。

Helm干货!速度围观!的相关教程结束。

《Helm干货!速度围观!.doc》

下载本文的Word格式文档,以方便收藏与打印。