ubuntu 18.04 安装参考:GHOST_URL/ubuntu-18-04-an-zhuang-helm/
Helm 简单入门(Helm 升级到 3.0 以后,命令有所修改,网上很多教程都不适用了)。
首先,运行 helm create example
创建一个 example 项目。
可以看到生成了一个 example 文件夹及一些文件如下:
mychart/
Chart.yaml
values.yaml
charts/
templates/
...
下面,我们先修改 Chart.yaml
:
apiVersion: v2
name: example
description: A Helm chart for Kubernetes
type: application
version: 0.1.0
appVersion: 1.16.0
为了保持简洁,我删掉了所有的注释。
接下来,修改 values.yaml
如下:
message: "Hello World"
同上,为了保持简洁,同时,为了能尽快理解每个文件的含义与作用,我删掉了所有的内容,只用了一个变量:message
。这个文件里定义的是之后 Helm 安装应用时,我们可以修改的变量。
再接下来,就是删掉 templates
里的所有文件。之所以删除的原因,原因也是同上的,是因为我们这是入门教程,文件太多太全,让人望而生畏,不是好事。所以,我们先清零,再慢慢添加。
好了,接下来,在 templates
文件夹下,创建 NOTES.txt
文件,内容如下:
This a example for your helm, your message is {{ .Value.message }}
这个文件里的内容会在 install
之后展示在控制台。
接着,还是 templates
文件夹下,创建 _helpers.tpl
文件,内容如下:
{{/* vim: set filetype=mustache: */}}
{{/*
Expand the name of the chart.
*/}}
{{- define "example.name" -}}
{{- default .Chart.Name .Values.message | trunc 63 | trimSuffix "-" -}}
{{- end -}}
这个文件负责定义一些复用的模板。
下面,我们只创建一个 ConfigMap
。在 templates
文件夹创建一个 config-map.yaml
的文件,内容如下:
apiVersion: v1
kind: ConfigMap
metadata:
name: mychart-configmap
data:
myvalue: {{ .Values.message }}
很简单的 config,只为介绍 Helm 的入门用法。
下面,在 example
文件夹下,运行 helm lint
检查我们的语法是否正确。
若结果如下,就是正确的:
==> Linting .
[INFO] Chart.yaml: icon is recommended
1 chart(s) linted, 0 chart(s) failed
以上,我们准备好了 chart。下面,开始安装:
helm install ./example --generate-name
结果如下:
NAME: example-1574665451
LAST DEPLOYED: Mon Nov 25 07:04:11 2019
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
This a example for your helm, your message is Hello World
可以看到最后一项的 NOTES
,正是我们编写好的 Notes 内容。
下面,看一下我们的 config-map
:
kubectl get cm
结果如下:
NAME DATA AGE
mychart-configmap 1 89s
可看到确实创建好了。因为,我们 install 的时候没有指定 namespace,所以在 默认 的 namespace 中。
下面,我们创建一个 namespace 后,设置 helm 一下参数再来一次:
# create ns
kubectl create ns example
helm install ./example --generate-name --set message="Hello2" --namespace example
结果如下:
NAME: example-1574665820
LAST DEPLOYED: Mon Nov 25 07:10:20 2019
NAMESPACE: example
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
This a example for your helm, your message is Hello2
创建成功。
接下来,运行 helm list --all-namespaces
,可看到我们部署的两个 example 服务。
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
example-1574665451 default 1 2019-11-25 07:04:11.690862151 +0000 UTC deployed example-0.1.0 1.16.0
example-1574665820 example 1 2019-11-25 07:10:20.936011141 +0000 UTC deployed example-0.1.0 1.16.0
还可以运行 helm get manifest example-1574665451
来查看 manifest 内容:
---
# Source: example/templates/config-map.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: mychart-configmap
data:
myvalue: Hello World
删除,helm uninstall example-1574665451
。
以上,就是 helm 的入门教程,至于 deployment, service什么的,也是写在 templates
文件夹之中,大家可依据自己的需求自行扩展。