Kubernetes 包管理器 Helm

                +------------------------+
                |    Chart Repository    |
                +------------------------+
            +-->|     Dependency A       |---+
            +-->|     Dependency B       |---+
            |   +------------------------+   |
      (dependency)                           |
            |   +------------------------+   |
            |   |      Chart: App        |---+
            |   +------------------------+   |
            |   |      /templates        |   |
            |   |      values.yaml       |   |
            +---|      Chart.yaml        |   |
                +------------------------+   |
                                             |
    Deploy                                   +---(Go template engine)---> Kubernetes Configurations ------> Kubernetes Cluster Namespace (Release)
(helm install)                               |                                                                               |
                                             |                                                                               |
                +------------------------+   |                                      +-------------------------+              |
                |     Release Values     |---+                                      |Metadata Storage backends|    Record release metadata
                +------------------------+                                          +-------------------------+              |
                | --set-file values.yaml |                                          | On Released Kubernetes  |<-------------+
                | --set foo=bar          |                                          |    Namespace Secret     |
                +------------------------+                                          +-------------------------+

RUN wget https://get.helm.sh/helm-v3.8.1-linux-amd64.tar.gz && \
    tar -zxvf helm-v3.8.1-linux-amd64.tar.gz &&  \
    mv linux-amd64/helm /usr/local/bin/helm &&  \
    rm -rf linux-amd64 helm-v3.8.1-linux-amd64.tar.gz

brew install helm

curl https://baltocdn.com/helm/signing.asc | sudo apt-key add -
sudo apt-get install apt-transport-https --yes
echo "deb https://baltocdn.com/helm/stable/debian/ all main" | sudo tee /etc/apt/sources.list.d/helm-stable-debian.list
sudo apt-get update
sudo apt-get install helm

mkdir -p deploy/charts
helm create deploy/charts/myapp

deploy/charts/myapp
├── Chart.yaml
├── charts
├── templates
│   ├── NOTES.txt
│   ├── _helpers.tpl
│   ├── deployment.yaml
│   ├── hpa.yaml
│   ├── ingress.yaml
│   ├── service.yaml
│   ├── serviceaccount.yaml
│   └── tests
│       └── test-connection.yaml
└── values.yaml

func Render(tpl string, values interface{}) (output string, err error)

package main

import (
	"fmt"
	"os"
	"text/template"
)

type Foo struct {
	Bar string
	Baz int
}

func (f *Foo) String() string {
	return fmt.Sprintf("Foo{ Bar: %s, Baz: %d }", f.Bar, f.Baz)
}

func (f *Foo) MethodHasParam(a, b string) string {
	return fmt.Sprintf("a: %s, b: %s", a, b)
}

func (f *Foo) Add(i int) *Foo {
	return &Foo{Bar: f.Bar, Baz: f.Baz + i}
}

var data = map[string]interface{}{
	"Foo": &Foo{
		Bar: "bar",
		Baz: 42,
	},
	"Field": "string",
	"List": []string{
		"a", "b", "c",
	},
	"EmptyList": []string{},
	"Cond":      true,
	"Func": func(p string) string {
		return "func called: " + p
	},
	"Map": map[string]string{
		"a": "1",
		"b": "2",
	},
	"Nil": map[string]string(nil),
}

var globalFuncs = template.FuncMap{
	"version": func() string { return "v1.2.3" },
	"add":     func(a, b int) int { return 1 + 1 },
}

const tpl = `1. 不使用 {{"{{}}"}} 包裹的字符串会被原样输出：
	没有两个 { 开头和两个 } 结尾包裹的字符串被原样渲染。

2. 使用 {{"{{}}"}} 包裹，可以使用模板引擎提供的动态渲染的能力：
	{{ "模板语法" }}

3. 前导和后续空白字符删除
	a. {{"{{- 模板语法 }}"}} ，会删除前导空白字符：

		abc

		{{- "前导空白字符会被删除"}}
		def

	b. {{"{{ 模板语法 -}}"}} ，会删除后续空白字符：

		abc
		{{ "后续空白字符会被删除" -}}

		def

	c. {{"{{- 模板语法 -}}"}} ，会删除前导和后续空白字符：

		abc

		{{- "前导和后续空白字符会被删除" -}}

		def

4. 注释语法 {{ "{{/* a comment */}}" }} 注释内容不会被渲染：
	abc {{/* a comment */}} def

5. 字面量：
	a. bool {{true}}
	b. 字符串 {{"abc"}}
	c. 字符 {{'a'}}
	d. int (位数取决于操作系统) {{ 1 }}
	e. float {{ 1.1 }}
	f. 虚数 {{ 1i }}
	g. 复数 {{ 1+1i }}


6. 渲染数据 {{ "{{ .Field }}" }}：
	a. . 是一个特殊的变量，默认指向的是 Execute 函数 data 参数：{{ . }}
	b. 渲染 Field 字段：{{ .Field }}
	c. 渲染 Foo 结构体的 Bar 字段：{{ .Foo.Bar }}
	d. 渲染并调用无参数方法：{{ .Foo.String }}
	d. 调用并渲染有参数方法：{{ .Foo.MethodHasParam "a" "b" }}
	e. 渲染 data 的 List 切片的 0 号元素：{{ index .List 0 }}
	f. 调用渲染 data 的 函数类型变量 Func：{{ call .Func "abc" }}
	g. 通过 key 渲染 map 的元素：{{ index .Map "a" }} 或 {{ .Map.a }}

7. 临时改变 . 的指向: 
	with: {{ with .Foo }} Bar = {{ .Bar }}, Baz = {{ .Baz }} {{ end }}
	with-else: {{ with .Nil }} {{.}} {{else}} . 是 nil {{ end }}

8. 流程控制
	a. 条件渲染：
		{{if .Cond}} .Cond is true {{end}}
		{{if not .Cond}} .Cond is false {{else}} .Cond is true {{end}} 
		{{if lt .Foo.Baz 10 }} .Foo.Baz < 10 {{ else if lt .Foo.Baz 100 }} 10 <= .Foo.Baz < 100 {{else}} .Foo.Baz >= 100 {{end}} 
	b. 遍历（只支持  array, slice, map, or channel）：
		遍历并改变 . 指向：
			range-end: {{range .List}} {{.}}, {{end}}
			range-else-end: {{range .EmptyList}} {{.}}, {{else}} is empty list {{end}}
			range-if-break-continue: {{range .List}} {{.}}, {{if eq . "a"}} {{continue}} {{else}} {{break}} {{end}}  {{end}}
		遍历不改变 . 指向，并获取索引：
			range-with-index: {{range $i, $e := .List}} {{$i}}: {{$e}}, {{end}}
		遍历 map：
			range-map: {{range $k, $v := .Map}} {{$k}}: {{$v}}, {{end}}

9. Arguments 概念，如下几种语法都叫做 Arguments：
	a. 上文提到的字面量: {{1}}
	b. nil 关键字：{{printf "%v" nil}}
	c. 数据指向数据的引用 . 以及对数据中的字段的引用(map 或 结构体) .Field: {{.Field}}
	d. $ 等对变量的引用，以及对变量的字段的引用（map 或结构体） $Xxx.Xxx，下文有阐述
	e. 数据或变量中，无参方法调用：{{.Foo.String}}
	f. 无参全局函数：{{version}}
	g. 上述之一的带括号的实例，用于分组。结果可以通过字段或映射键调用来访问。
		{{ printf ".List[0]=%s" (index .List 0) }}
		{{ (.Foo.Add 1).String }}

10. 全局函数调用
	语法为 {{ "{{函数名 Arguments1 Arguments2 ...}}" }}: {{ printf "%s" "hello" }}
	内置全局函数(参见 https://pkg.go.dev/text/template#hdr-Functions ）调用：{{ printf "%s" "hello" }}
	自定义全局函数，通过 func (*Template).Funcs(funcMap template.FuncMap) *template.Template 函数添加：{{add 1 2}}

11. Pipelines 能力，和 shell 中的 Pipelines 类似，如下元素可以通过 | 管道符连接。
	a. 语法为: Argument | 函数或方法（可选） | 函数或方法（可选） | ...
		Argument 就是上文定义的
		函数或方法可能是：
			.XXx.XxxMethod [Argument...] 保证最后一个是有参数有返回值的方法
			$Xxx.XxxMethod [Argument...] 保证最后一个是有参数有返回值的方法
			有参数有返回值的全局函数 Func [Argument...]
		函数或方法的写法，不应书写最后一个参数，因为最后一个参数从 Pipeline 中来
	d. 一个例子： {{"Pipeline" | printf "hello %s"}}

12. 变量
	a. 定义 $variable := pipeline: {{ $variable := "value" }} {{ $variable }}
	b. 赋值 $variable = pipeline: {{ $variable = "override" }} {{ $variable }}

13. 嵌套模板
	a. 定义: {{define "T1"}}ONE{{end}}
	b. 调用: {{template "T1" .}}
	c. 不要求定义一定发生在调用之前：{{template "T2" .}} {{define "T2"}}TWO{{end}}
	d. 同一个 tpl 不允许重复定义，但是多个模板可以重复定义，后 Parse 的将覆盖之前的嵌套模板
		{{template "T3" .}} {{define "T3"}}THREE{{end}}
	e. block 定义一个模板并立即调用，等价于 define 后立即 template 调用，用于实现给 template 提供一个默认值。
		{{block "T4" .}}T4 没有定义{{end}}
		{{block "T5" .}}T5 没有定义{{end}}

14. Parse 多个模板时，Execute 函数，只会渲染最后一个包含实际内容的模板（不包含实际内容的模板指的是该模板只包含 define 没有其他内容）。

15. Action 和 函数
	在 Go 模板中 Action 和 全局函数，使用起来看似相同。但是 Action 不支持 Pipeline。
	除了 if 、else、range 这类流程控制的 Action 外，template 就是一个 Action，因此 template 不支持管道符。
`

const tpl2 = `{{define "T3"}}THREE 来自 tpl2{{end}}{{define "T5"}}T5 有定义{{end}}`

func main() {
	t, err := template.New("tpl").Funcs(globalFuncs).Parse(tpl)
	if err != nil {
		panic(err)
	}
	_, err = t.Parse(tpl2)
	if err != nil {
		panic(err)
	}

	err = t.Execute(os.Stdout, data)
	if err != nil {
		panic(err)
	}
}

1. 不使用 {{}} 包裹的字符串会被原样输出：
        没有两个 { 开头和两个 } 结尾包裹的字符串被原样渲染。

2. 使用 {{}} 包裹，可以使用模板引擎提供的动态渲染的能力：
        模板语法

3. 前导和后续空白字符删除
        a. {{- 模板语法 }} ，会删除前导空白字符：

                abc前导空白字符会被删除
                def

        b. {{ 模板语法 -}} ，会删除后续空白字符：

                abc
                后续空白字符会被删除def

        c. {{- 模板语法 -}} ，会删除前导和后续空白字符：

                abc前导和后续空白字符会被删除def

4. 注释语法 {{/* a comment */}} 注释内容不会被渲染：
        abc  def

5. 字面量：
        a. bool true
        b. 字符串 abc
        c. 字符 97
        d. int (位数取决于操作系统) 1
        e. float 1.1
        f. 虚数 (0+1i)
        g. 复数 (1+1i)


6. 渲染数据 {{ .Field }}：
        a. . 是一个特殊的变量，默认指向的是 Execute 函数 data 参数：map[Cond:true EmptyList:[] Field:string Foo:Foo{ Bar: bar, Baz: 42 } Func:0x10ee480 List:[a b c] Map:map[a:1 b:2] Nil:map[]]
        b. 渲染 Field 字段：string
        c. 渲染 Foo 结构体的 Bar 字段：bar
        d. 渲染并调用无参数方法：Foo{ Bar: bar, Baz: 42 }
        d. 调用并渲染有参数方法：a: a, b: b
        e. 渲染 data 的 List 切片的 0 号元素：a
        f. 调用渲染 data 的 函数类型变量 Func：func called: abc
        g. 通过 key 渲染 map 的元素：1 或 1

7. 临时改变 . 的指向: 
        with:  Bar = bar, Baz = 42 
        with-else:  . 是 nil 

8. 流程控制
        a. 条件渲染：
                 .Cond is true 
                 .Cond is true  
                 10 <= .Foo.Baz < 100  
        b. 遍历（只支持  array, slice, map, or channel）：
                遍历并改变 . 指向：
                        range-end:  a,  b,  c, 
                        range-else-end:  is empty list 
                        range-if-break-continue:  a,   b,  
                遍历不改变 . 指向，并获取索引：
                        range-with-index:  0: a,  1: b,  2: c, 
                遍历 map：
                        range-map:  a: 1,  b: 2, 

9. Arguments 概念，如下几种语法都叫做 Arguments：
        a. 上文提到的字面量: 1
        b. nil 关键字：<nil>
        c. 数据指向数据的引用 . 以及对数据中的字段的引用(map 或 结构体) .Field: string
        d. $ 等对变量的引用，以及对变量的字段的引用（map 或结构体） $Xxx.Xxx，下文有阐述
        e. 数据或变量中，无参方法调用：Foo{ Bar: bar, Baz: 42 }
        f. 无参全局函数：v1.2.3
        g. 上述之一的带括号的实例，用于分组。结果可以通过字段或映射键调用来访问。
                .List[0]=a
                Foo{ Bar: bar, Baz: 43 }

10. 全局函数调用
        语法为 {{函数名 Arguments1 Arguments2 ...}}: hello
        内置全局函数(参见 https://pkg.go.dev/text/template#hdr-Functions ）调用：hello
        自定义全局函数，通过 func (*Template).Funcs(funcMap template.FuncMap) *template.Template 函数添加：2

11. Pipelines 能力，和 shell 中的 Pipelines 类似，如下元素可以通过 | 管道符连接。
        a. 语法为: Argument | 函数或方法（可选） | 函数或方法（可选） | ...
                Argument 就是上文定义的
                函数或方法可能是：
                        .XXx.XxxMethod [Argument...] 保证最后一个是有参数有返回值的方法
                        $Xxx.XxxMethod [Argument...] 保证最后一个是有参数有返回值的方法
                        有参数有返回值的全局函数 Func [Argument...]
                函数或方法的写法，不应书写最后一个参数，因为最后一个参数从 Pipeline 中来
        d. 一个例子： hello Pipeline

12. 变量
        a. 定义 $variable := pipeline:  value
        b. 赋值 $variable = pipeline:  override

13. 嵌套模板
        a. 定义: 
        b. 调用: ONE
        c. 不要求定义一定发生在调用之前：TWO 
        d. 同一个 tpl 不允许重复定义，但是多个模板可以重复定义，后 Parse 的将覆盖之前的嵌套模板
                THREE 来自 tpl2 
        e. block 定义一个模板并立即调用，等价于 define 后立即 template 调用，用于实现给 template 提供一个默认值。
                T4 没有定义
                T5 有定义

14. Parse 多个模板时，Execute 函数，只会渲染最后一个包含实际内容的模板（不包含实际内容的模板指的是该模板只包含 define 没有其他内容）。

15. Action 和 函数
        在 Go 模板中 Action 和 全局函数，使用起来看似相同。但是 Action 不支持 Pipeline。
        除了 if 、else、range 这类流程控制的 Action 外，template 就是一个 Action，因此 template 不支持管道符。

apiVersion: v2
name: myapp
description: A Helm chart for Kubernetes
type: application
version: 0.1.0
appVersion: "1.16.0"

apiVersion: chart API 版本 （必需）
name: chart名称 （必需）
version: 语义化2 版本（必需）
kubeVersion: 兼容Kubernetes版本的语义化版本（可选）
description: 一句话对这个项目的描述（可选）
type: chart类型 （可选）
keywords:
  - 关于项目的一组关键字（可选）
home: 项目home页面的URL （可选）
sources:
  - 项目源码的URL列表（可选）
dependencies: # chart 必要条件列表 （可选）
  - name: chart名称 (nginx)
    version: chart版本 ("1.2.3")
    repository: （可选）仓库URL ("https://example.com/charts") 或别名 ("@repo-name")
    condition: （可选） 解析为布尔值的yaml路径，用于启用/禁用chart (e.g. subchart1.enabled )
    tags: # （可选）
      - 用于一次启用/禁用 一组chart的tag
    import-values: # （可选）
      - ImportValue 保存源值到导入父键的映射。每项可以是字符串或者一对子/父列表项
    alias: （可选） chart中使用的别名。当你要多次添加相同的chart时会很有用
maintainers: # （可选）
  - name: 维护者名字 （每个维护者都需要）
    email: 维护者邮箱 （每个维护者可选）
    url: 维护者URL （每个维护者可选）
icon: 用做icon的SVG或PNG图片URL （可选）
appVersion: 包含的应用版本（可选）。不需要是语义化，建议使用引号
deprecated: 不被推荐的chart （可选，布尔值）
annotations:
  example: 按名称输入的批注列表 （可选）.

replicaCount: 1

image:
  repository: nginx
  pullPolicy: IfNotPresent
  # Overrides the image tag whose default is the chart appVersion.
  tag: ""

{{/*
Expand the name of the chart.
*/}}
{{- define "myapp.name" -}}
{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
{{- end }}

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "myapp.fullname" . }}
  labels:
    {{- include "myapp.labels" . | nindent 4 }}

apiVersion: apps/v1
kind: Deployment
metadata:
  name: release-name-myapp
  labels:
    helm.sh/chart: myapp-0.1.0
    app.kubernetes.io/name: myapp
    app.kubernetes.io/instance: release-name
    app.kubernetes.io/version: "1.16.0"
    app.kubernetes.io/managed-by: Helm

apiVersion: v1
entries:
  alpine:
    - created: 2016-10-06T16:23:20.499814565-06:00
      description: Deploy a basic Alpine Linux pod
      digest: 99c76e403d752c84ead610644d4b1c2f2b453a74b921f422b9dcb8a7c8b559cd
      home: https://helm.sh/helm
      name: alpine
      sources:
      - https://github.com/helm/helm
      urls:
      - https://technosophos.github.io/tscharts/alpine-0.2.0.tgz
      version: 0.2.0
    - created: 2016-10-06T16:23:20.499543808-06:00
      description: Deploy a basic Alpine Linux pod
      digest: 515c58e5f79d8b2913a10cb400ebb6fa9c77fe813287afbacf1a0b897cd78727
      home: https://helm.sh/helm
      name: alpine
      sources:
      - https://github.com/helm/helm
      urls:
      - https://technosophos.github.io/tscharts/alpine-0.1.0.tgz
      version: 0.1.0
  nginx:
    - created: 2016-10-06T16:23:20.499543808-06:00
      description: Create a basic nginx HTTP server
      digest: aaff4545f79d8b2913a10cb400ebb6fa9c77fe813287afbacf1a0b897cdffffff
      home: https://helm.sh/helm
      name: nginx
      sources:
      - https://github.com/helm/charts
      urls:
      - https://technosophos.github.io/tscharts/nginx-1.1.0.tgz
      version: 1.1.0
generated: 2016-10-06T16:23:20.499029981-06:00