Version:"v3.0.1"

GitCommit:"7c22ef9ce89e0ebeb7125ba2ebf7d421f3e82ffa"

GitTreeState:"clean"

GoVersion:"go1.13.4"

http:

/mirror.azure.cn/kubernetes/charts/
$

http:

for

in

for

update

from

updatefrom

Update

!

getall-

release=

-1575619811

/

-1575619811-8479

-

0/1

027

-

EXTERNAL-

/

-1575619811

10.106.141.228<none>3306/

27

-TO-DATE

/

-15756198110/11027

CURRENT

/

-1575619811-8479

11027

ls

-1575619811
release

getall-

release=

-1575619811
No

-1575619811

release

not

-1575619811--keep-history
release

-1575619811

-1575619811

-1575619811
LAST

Dec616

47

142019

default

-

-1575619811default12019-12-0616

47

14.415214+0800

## mysql image version
## ref: https://hub.docker.com/r/library/mysql/tags/
##

## Specify password for root user
##
## Default: random 10 character string
#

## Create a database user
##
#

## Default: random 10 character string
#

## Allow unauthenticated access, uncomment to enable
##
#

true

## Create a database
##
#

## Specify an imagePullPolicy (Required)
## It's recommended to change this to 'Always' if the image tag is 'latest'
## ref: http://kubernetes.io/docs/user-guide/images/#updating-images
##

get

-

release=

-

-

0/1

0119

describe

-

-

<setto

'mysql-root-password'in

'mysql'>

false

<setto

'mysql-password'in

'mysql'>

false

inner

-

-

-

-

default22019-12-0621

06

11.36358+0800

-1.5.05.7.27

1

Dec617

53

032019

-1.5.05.7.27

2

Dec621

06

112019

-1.5.05.7.27

rollback

1
Rollback

!

!

get

-

release=

-

-

1/1Running03

getvalues

USER-

VALUES

# 包含當前 chart 資訊的 YAML 檔案

# 可選：包含 chart 的 license 的文字檔案

# 可選：一個可讀性高的 README 檔案

# 當前 chart 的預設配置 values

# 可選: 一個作用在 values.yaml 檔案上的 JSON 模式

# 包含該 chart 依賴的所有 chart 的目錄

# Custom Resource Definitions

# 模板目錄，與 values 結合使用時，將渲染生成 Kubernetes 資源清單檔案

update

from

updatefrom

updatefrom

updatefrom

updatefrom

Update

!

2

from

//

/

from

//

/

.Values.imageRegistry

/postgres:{{.Values.dockerTag}}
imagePullPolicy:

.Values.pullPolicy

ports:
-containerPort:5432
env:
-name:DATABASE_STORAGE
value:

default"minio".Values.storage

.Values.imageRegistry

/postgres:{{.Values.dockerTag}}
imagePullPolicy:

.Values.pullPolicy

ports:
-containerPort:5432
env:
-name:DATABASE_STORAGE
value:

default"minio".Values.storage

mysql:
max_connections:100# 傳遞到 MySQL
password:"secret"

global:
app:MyWordPress

mysql:
max_connections:100# 傳遞到 MySQL
password:"secret"

global:
app:MyWordPress

mysql:
global:
app:MyWordPress
max_connections:100# 傳遞到 MySQL
password:"secret"

"$schema"

"https://json-schema.org/draft-07/schema#"

"properties"

"image"

"description"

"Container Image"

"properties"

"repo"

"type"

"string"

"tag"

"type"

"string"

"type"

"object"

"name"

"description"

"Service name"

"type"

"string"

"port"

"description"

"Port"

"minimum"

"type"

"integer"

"protocol"

"type"

"string"

"required"

"protocol"

"port"

"title"

"Values"

"type"

"object"

set

.Values.name

create

package

-0.1

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favoriteDrink

debug

Original chart version:""
install.go:165:

debug

CHART PATH:/Users/ych/devs/workspace/yidianzhishi/course/k8strain/content/helm/manifests/mychart

NAME:mychart-1575963545
LAST DEPLOYED:TueDec1015:39:062019
NAMESPACE:default
STATUS:pending-install
REVISION:1
TEST SUITE:None
USER-SUPPLIED VALUES:

COMPUTED VALUES:
favoriteDrink:coffee

debug

Original chart version:""
install.go:165:

debug

CHART PATH:/Users/ych/devs/workspace/yidianzhishi/course/k8strain/content/helm/manifests/mychart

NAME:mychart-1575963760
LAST DEPLOYED:TueDec1015:42:432019
NAMESPACE:default
STATUS:pending-install
REVISION:1
TEST SUITE:None
USER-SUPPLIED VALUES:
favoriteDrink:slurm

COMPUTED VALUES:
favoriteDrink:slurm

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink

food:

.Values.favorite.food

set

set

cat

set

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

quote.Values.favorite.drink

food:

quote.Values.favorite.food

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink|quote

food:

.Values.favorite.food|quote

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink|quote

food:

.Values.favorite.food|upper|quote

debug

Original chart version:""
install.go:165:

debug

CHART PATH:/Users/ych/devs/workspace/yidianzhishi/course/k8strain/content/helm/manifests/mychart

NAME:mychart-1575966483
LAST DEPLOYED:TueDec1016:28:042019
NAMESPACE:default
STATUS:pending-install
REVISION:1
TEST SUITE:None
USER-SUPPLIED VALUES:

COMPUTED VALUES:
favorite:
drink:coffee
food:pizza
favoriteDrink:coffee

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink|repeat5|quote

food:

.Values.favorite.food|upper|quote

default"rice"

printf"%s-rice"

"fullname"

if

# Do something

elseif

# Do something else

else

# Default case

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink|default"tea"|quote

food:

.Values.favorite.food|upper|quote

ifeq.Values.favorite.drink"coffee"

mug:true

end

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink|default"tea"|quote

food:

.Values.favorite.food|upper|quote

ifeq.Values.favorite.drink"coffee"

mug:true

end

--generate-name --dry-run --debug ./mychart

148

""

165

Error

erroron

error

to

line9

not

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink|default"tea"|quote

food:

.Values.favorite.food|upper|quote

ifeq.Values.favorite.drink"coffee"

mug:true

end

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink|default"tea"|quote

food:

.Values.favorite.food|upper|quote

-ifeq.Values.favorite.drink"coffee"

mug:true

-end

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink|default"tea"|quote

food:

.Values.favorite.food|upper|quote

upper

if

"coffee"

true

end

.Release.Name

-configmap
data:
myvalue:"Hello World"
drink:

.Values.favorite.drink|default"tea"|quote

food:

.Values.favorite.food|upper|quote

with

# 限制範圍

.Release.Name

-configmap
data:
myvalue:"Hello World"

-with.Values.favorite

drink:

.drink|default"tea"|quote

food:

.food|upper|quote

-end

with.Values.favorite

.drink

default"tea"

.food

release

.Release.Name

end

with.Values.favorite

.drink

default"tea"

.food

end

release

.Release.Name

-

-

-

-

.Release.Name

-configmap
data:
myvalue:"Hello World"

-with.Values.favorite

drink:

.drink|default"tea"|quote

food:

.food|upper|quote

-end

toppings:

data:

"Hello World"

"coffee"

"PIZZA"

"Mushrooms"

"Cheese"

"Peppers"

rangetuple"small""medium""large"

-

-

-

with.Values.favorite

.drink

default"tea"

.food

release

.Release.Name

end

.Release.Name

-configmap
data:
myvalue:"Hello World"

-$relname:=.Release.Name-

-with.Values.favorite

drink:

.drink|default"tea"|quote

food:

.food|upper|quote

release:

$relname

-end

$index

$topping

$index

$topping

-configmap
data

"Hello World"

$key

$val

$key

$val

end

-range.Values.tlsSecrets

apiVersion:v1
kind:Secret
metadata:
name:

.name

labels:
# helm 模板經常使用 `.`，但是這裡是無效的，用 `$` 是可以生效的。
app.kubernetes.io/name:

template"fullname"$

# 這裡不能引用 `.Chart.Name`，但是可用使用 `$.Chart.Name`
helm.sh/chart:"{{ $.Chart.Name }}-{{ $.Chart.Version }}"
app.kubernetes.io/instance:"{{ $.Release.Name }}"
# 值來自於 Chart.yaml 檔案中的 appVersion
app.kubernetes.io/version:"{{ $.Chart.AppVersion }}"
app.kubernetes.io/managed-by:"{{ $.Release.Service }}"
type:kubernetes.io/tls
data:
tls.crt:

.certificate

tls.key:

.key

---

-end

當使用命名模板的時候有幾個重要細節：模板名稱是全域性的，如果宣告兩個具有相同名稱的模板，則會使用最後被載入的模板。由於子chart中的模板是與頂級模板一起編譯的，所以需要謹慎命名。

一種流行的命名約定是在每個定義的模板前新增chart名稱：{{define"mychart.labels"}}，透過使用特定的chart名作為字首，我們可以避免由於兩個不同的chart實現了相同名稱的模板而引起的衝突。
partials和_檔案¶

到目前為止，我們只使用了一個模板檔案，但是Helm的模板語言允許我們建立命名的嵌入式模板，可以在其他位置進行訪問。在編寫這些模板之前，有一些值得一提的命名約定：

templates/中的大多數檔案都被視為Kubernetes資源清單檔案（NOTES.txt除外）
以_開頭命名的檔案也不會被當做Kubernetes資源清單檔案
下劃線開頭的檔案不會被當做資源清單之外，還可以被其他chart模板呼叫

_開頭的這些檔案其實就是Helm中的partials檔案，所以其實我們完全可以將命名模板定義在這些partials檔案中，預設就是_helpers.tpl檔案，其實在前面我們建立的mychart包中也可以找到這個檔案。
define和template¶

define關鍵字可以讓我們在模板檔案中建立命名模板，它的語法如下所示：

define"MY.NAME"

# 模板內容區域

end

比如我們可以定義一個模板來封裝下Kubernetes的labels標籤：

-define"mychart.labels"

labels:
generator:helm
date:

now|htmlDate

-end

現在我們可以將該模板嵌入到前面的ConfigMap模板中，然後將其包含在模板中：

-define"mychart.labels"

labels:
generator:helm
date:

now|htmlDate

-end

apiVersion:v1
kind:ConfigMap
metadata:
name:

.Release.Name

-configmap

-template"mychart.labels"

data:
myvalue:"Hello World"

-range$key

$val:=.Values.favorite

$key

:

$val|quote

-end

當模板引擎讀取這個檔案的時候，它會儲存mychart.labels的引用，直到該模板被呼叫，然後會內聯渲染該模板。我們渲染這個模板可以都到如下所示的結果（記得先刪掉預設生成的_helpers.tpl檔案）：

# Source: mychart/templates/configmap.yaml
apiVersion:v1
kind:ConfigMap
metadata:
name:mychart-1576034036-configmap
labels:
generator:helm
date:2019-12-11
data:
myvalue:"Hello World"
drink:"coffee"
food:"pizza"

一般來說，Helm中約定將這些模板統一放到一個partials檔案中，通常就是_helpers.tpl檔案中，我們將上面的命名模板移動到該檔案（templates/_helpers.tpl）中去：

/*生成基本的Label標籤*/

-define"mychart.labels"

labels:
generator:helm
date:

now|htmlDate

-end

一般來說，我們也會用一個簡單的塊（{{/*...*/}}）來註釋這個命名模板的作用。

現在雖然我們把命名模板放到了_helpers.tpl檔案中，但是我們在configmap.yaml模板中還是可以訪問，因為命名模板是全域性的：

apiVersion:v1
kind:ConfigMap
metadata:
name:

.Release.Name

-configmap

-template"mychart.labels"

data:
myvalue:"Hello World"

-range$key

$val:=.Values.favorite

$key

:

$val|quote

-end

因為上面我們提到過命名模板是全域性的，我們可以再渲染下上面的模板可以得到正確的結果。
設定模板範圍¶

上面我們定義的模板中，還沒有使用到任何物件，只使用了函式，現在我們來修改下定義的命名模板，包含chart的名稱和版本：

/*生成基本的Label標籤*/

-define"mychart.labels"

labels:
generator:helm
date:

now|htmlDate

chart:

.Chart.Name

version:

.Chart.Version

-end

現在我們來渲染下模板，會出現下面的錯誤：

$helminstall--generate-name--dry-run--debug./my
chart
install.go:148:

debug

Original chart version:""
install.go:165:

debug

CHART PATH:/Users/ych/devs/workspace/yidianzhishi/cour
se/k8strain/content/helm/manifests/mychart

Error: unable to build kubernetes objects from release manifest:errorvalidati
ng"":error validating data:

unknownobjecttype"nil"inConfigMap.metadata.
labels.chart

unknownobjecttype"nil"inConfigMap.metadata.labels.version

helm.go:76:

debug

errorvalidating"":error validating data:

unknownobject
type"nil"inConfigMap.metadata.labels.chart

unknownobjecttype"nil"inCo
nfigMap.metadata.labels.version

......

我們可以看到提示labels.chart為nil，這是因為我們使用的.Chart.Name不在定義的這個模板的作用域範圍內，當渲染命名模板（使用define定義）的時候，它將接收模板呼叫傳遞的作用域。在我們這個示例中，我們是這樣引用這個模板的：

-template"mychart.labels"

沒有傳入任何作用域，所以在模板內我們無法訪問.中的任何內容，當然要解決很簡單，我們只需要把作用域範圍傳遞給模板即可：

apiVersion:v1
kind:ConfigMap
metadata:
name:

.Release.Name

-configmap

-template"mychart.labels".

......

我們這裡在使用template呼叫模板的時候傳遞了.，我們可以很容易傳遞.Values或者.Values.favorite或者我們想要的任何範圍，但是這裡我們想要的是頂級作用域，所以我們傳遞的是.。

現在我們再來重新渲染我們的模板，可以得到如下所示的結果：

# Source: mychart/templates/configmap.yaml
apiVersion:v1
kind:ConfigMap
metadata:
name:mychart-1576035668-configmap
labels:
generator:helm
date:2019-12-11
chart:mychart
version:0.1.0
data:
myvalue:"Hello World"
drink:"coffee"
food:"pizza"

現在

.Chart.Name

解析為了mychart，而

.Chart.Version

解析為了0.1.0。
include函式¶

假設我們定義了一個如下所示的簡單模板：

-define"mychart.app"-

app_name:

.Chart.Name

app_version:"{{ .Chart.Version }}"

-end-

現在我們想把上面的內容插入到模板的labels部分，在data部分也想要這個內容：

apiVersion:v1
kind:ConfigMap
metadata:
name:

.Release.Name

-configmap
labels:

template"mychart.app".

data:
myvalue:"Hello World"

-range$key

$val:=.Values.favorite

$key

:

$val|quote

-end

template"mychart.app".

但是我們直接渲染上面的模板還是會有錯誤：

$helminstall--generate-name--dry-run--debug./my
chart
install.go:148:

debug

Original chart version:""
install.go:165:

debug

CHART PATH:/Users/ych/devs/workspace/yidianzhishi/cour
se/k8strain/content/helm/manifests/mychart

Error: unable to build kubernetes objects from release manifest:errorvalidati
ng"":error validating data:

ValidationError(ConfigMap):unknownfield

inio.k8s.api.core.v1.ConfigMap

ValidationError(ConfigMap):unknownfield
"app_version"inio.k8s.api.core.v1.ConfigMap

helm.go:76:

debug

errorvalidating"":error validating data:

ValidationErro
r(ConfigMap):unknownfield"app_name"inio.k8s.api.core.v1.ConfigMap

Validat
ionError(ConfigMap):unknownfield"app_version"inio.k8s.api.core.v1.ConfigMap

......

因為template只是一個動作，而不是一個函式，所以無法將模板呼叫的輸出傳遞給其他函式，只是內聯插入，相當於渲染的結果是這樣的：

apiVersion:v1
kind:ConfigMap
metadata:
name:measly-whippet-configmap
labels:
app_name:mychart
app_version:"0.1.0+1478129847"
data:
myvalue:"Hello World"
drink:"coffee"
food:"pizza"
app_name:mychart
app_version:"0.1.0+1478129847"

很明顯上面的YAML檔案是不符合ConfigMap資源物件的格式要求的，所以報錯了。為解決這個問題，Helm提供了代替template的函式include，可以將模板的內容匯入到當前的管道中，這樣就可以在管道中傳遞給其他函式進行處理了，如下所示：

apiVersion:v1
kind:ConfigMap
metadata:
name:

.Release.Name

-configmap
labels:

include"mychart.app".|indent4

data:
myvalue:"Hello World"

-range$key

$val:=.Values.favorite

$key

:

$val|quote

-end

include"mychart.app".|indent2

現在我們重新渲染就可以得到正確的結果了，這是因為我們用include函式得到模板內容後透過管道傳給了後面的indent函式來保證了縮排：

Source:mychart/templates/configmap.yaml
apiVersion:v1
kind:ConfigMap
metadata:
name:mychart-1576036671-configmap
labels:
app_name:mychart
app_version:"0.1.0"
data:
myvalue:"Hello World"
drink:"coffee"
food:"pizza"
app_name:mychart
app_version:"0.1.0"

建議

在Helm模板中最好使用include而不是template，這樣可以更好地處理YAML文件的輸出格式。

Helm提供了一個.Files物件對檔案的訪問，但是在模板中使用這個物件之前，還有幾個需要注意的事項值得一提：

可以在Helmchart中新增額外的檔案，這些檔案也會被打包，不過需要注意，由於Kubernetes物件的儲存限制，Charts必須小於1M

由於一些安全原因，透過.Files物件無法訪問某些檔案
無法訪問templates/下面的檔案
無法訪問使用.helmignore排除的檔案

Chart不會保留UNIX模式的資訊，所以，當使用.Files物件時，檔案級別的許可權不會對檔案的可用性產生影響。

基本示例¶

現在我們來編寫一個模板，將3個檔案讀入到ConfigMap模板中，首先我們在chart中新增3個檔案，將3個檔案都直接放置在mychart/目錄中。

config1.toml:

message=Hellofromconfig1

config2.toml:

message=Thisisconfig2

config3.toml:

message=Goodbyefromconfig3

3個檔案都是簡單的TOML檔案，我們知道這些檔案的名稱，所以我們可以使用range函式來遍歷它們，並將其內容注入到ConfigMap中去。

apiVersion:v1
kind:ConfigMap
metadata:
name:

.Release.Name

-configmap
data:

-$files:=.Files

-rangetuple"config1.toml""config2.toml""config3.toml"

.

:

-end

這裡我們聲明瞭一個$files的變數來儲存.Files物件的引用，還使用了tuple函式來迴圈檔案列表，然後我們列印每個資料夾

.

:|-，後面使用

$files.Get.

獲取檔案內容。

現在我們渲染這個模板會產生包含3個檔案內容的單個ConfigMap：

# Source: mychart/templates/configmap.yaml
apiVersion:v1
kind:ConfigMap
metadata:
name:mychart-1576046462-configmap
data:
config1.toml:

config2.toml:

config3.toml:

另外在處理檔案的時候，對檔案路徑本身執行一些標準操作可能非常有用，為了解決這個問題，Helm從Go的路徑包中匯入了許多功能供你使用，它們都可以使用與Go包中相同的相同名稱來訪問，但是首字母需要小寫，比如Base需要變成base，匯入的函式有：-Base-Dir-Ext-IsAbs-Clean。
Glob模式¶

隨著chart的增長，你可能需要更多地組織檔案，因此Helm提供了Files.Glob的方法來幫助我們獲取具有glob模式的檔案。

.Glob返回Files型別，所以你可以在返回的物件上呼叫任何Files方法。比如，我們的檔案目錄結構如下所示：

foo/:
foo.txtfoo.yaml

bar/:
bar.gobar.confbaz.yaml

我們可以用Glob進行多種選擇：

range$path:=.Files.Glob"**.yaml"

$path

:|

.Files.Get$path

end

或者

range$path

$bytes:=.Files.Glob"foo/*"

$path

:'{{ b64enc $bytes }}'

end

ConfigMap和Secrets¶

想要將檔案內容同時放入ConfigMap和Secrets中，以便在執行時安裝到Pod中，這種需求很常見，為了解決這個問題，Helm在Files型別上添加了一個實用的方法。

根據上面的目錄結構，我們可以按照如下的方式進行處理：

apiVersion:v1
kind:ConfigMap
metadata:
name:conf
data:

(.Files.Glob"foo/*").AsConfig|indent2

---
apiVersion:v1
kind:Secret
metadata:
name:very-secret
type:Opaque
data:

(.Files.Glob"bar/*").AsSecrets|indent2

編碼¶

我們也可以匯入一個檔案並用base64編碼進行編碼：

apiVersion:v1
kind:Secret
metadata:
name:

.Release.Name

-secret
type:Opaque
data:
token:

上面將採用我們上面的config1.toml檔案並對其內容進行base64編碼，渲染會得到如下所示的結果：

# Source: mychart/templates/configmap.yaml
apiVersion:v1
kind:Secret
metadata:
name:mychart-1576048287-secret
type:Opaque
data:
token:

Lines¶

有時，需要訪問模板中檔案的每一行內容，Helm也提供了方法的Lines方法，我們可以使用range函式遍歷沒行內容：

data:
some-file.txt:

range.Files.Lines"foo/bar.txt"

.

end

for

{{ .Chart.Name }

is

{{ .Release.Name }

To

try

{{ .Release.Name }

{{ .Release.Name }

NAMETYPE

10

NAME

30

for

is

To

try

同樣在深入瞭解之前，我們需要了解下子chart相關的一些資訊。

子chart是獨立的，這意味著子chart不能顯示依賴其父chart
所以子chart無法訪問其父級的值
父chart可以覆蓋子chart的值
Helm中有可以被所有charts訪問的全域性值的概念

建立子chart¶

同樣還是在之前操作的mychart/這個chart包中，我們來嘗試新增一些新的子chart：

$cdmychart/charts
$helmcreatemysubchart
Creatingmysubchart
$rm-rfmysubchart/templates/*.*

和前面一樣，我們刪除了所有的基本模板，這樣我們可以從頭開始。
新增values和模板¶

接下來我們為mysubchart這個子chart建立一個簡單的模板和values值檔案，mychart/charts/mysubchart中已經有一個values.yaml檔案了，在檔案中新增下面的values：

dessert:cake

下面我們再建立一個新的ConfigMap模板mychart/charts/mysubchart/templates/configmap.yaml：

apiVersion:v1
kind:ConfigMap
metadata:
name:

.Release.Name

-cfgmap2
data:
dessert:

.Values.dessert

因為每個子chart都是獨立的chart，所以我們可以單獨測試mysubchart：

helminstall--generate-name--dry-run--debugmychart/charts/mysubchart
install.go:148:

debug

Original chart version:""
install.go:165:

debug

CHART PATH:/Users/ych/devs/workspace/yidianzhishi/course/k8strain/content/helm/manifests/mychart/charts/mysubchart

NAME:mysubchart-1576050755
LAST DEPLOYED:WedDec1115:52:362019
NAMESPACE:default
STATUS:pending-install
REVISION:1
TEST SUITE:None
USER-SUPPLIED VALUES:

COMPUTED VALUES:
dessert:cake

HOOKS:
MANIFEST:
---
# Source: mysubchart/templates/configmap.yaml
apiVersion:v1
kind:ConfigMap
metadata:
name:mysubchart-1576050755-cfgmap2
data:
dessert:cake

從父chart覆蓋values¶

我們原來的chart-mychart現在是mysubchart的父級chart了。由於mychart是父級，所以我們可以在mychart中指定配置，並將該配置傳送到mysubchart中去，比如，我們可以這樣修改mychart/values.yaml：

favorite:
drink:coffee
food:pizza
pizzaToppings:
-mushrooms
-cheese
-peppers
-onions

mysubchart:
dessert:icecream

最後兩行，mysubchart部分中的所有指令都回被髮送到mysubchart子chart中，所以，如果我們現在渲染模板，我們可以看到mysubchart的ConfigMap會被渲染成如下的內容：

# Source: mychart/charts/mysubchart/templates/configmap.yaml
apiVersion:v1
kind:ConfigMap
metadata:
name:mychart-1576051914-cfgmap2
data:
dessert:icecream

我們可以看到頂層的values值覆蓋了子chart中的值。這裡有一個細節需要注意，我們沒有將mychart/charts/mysubchart/templates/configmap.yaml模板更改為指向.Values.mysubchart.dessert，因為從該模板的絕度來看，該值仍然位於.Values.dessert，當模板引擎傳遞values值的時候，它會設定這個作用域，所以，對於mysubchart模板，.Values中僅僅提供用於該子chart的值。

但是有時候如果我們確實希望某些值可以用於所有模板，這個時候就可以使用全域性chartvalues值來完成了。
全域性值¶

全域性值是可以從任何chart或子chart中都可以訪問的值，全域性值需要顯示的宣告，不能將現有的非全域性物件當作全域性物件使用。

Values資料型別具有一個名為Values.global的保留部分，可以在其中設定全域性值，我們在mychart/values.yaml檔案中新增一個全域性值：

favorite:
drink:coffee
food:pizza
pizzaToppings:
-mushrooms
-cheese
-peppers
-onions

mysubchart:
dessert:icecream

global:
salad:caesar

由於全域性值的原因，在mychart/templates/configmap.yaml和mysubchart/templates/configmap.yaml下面都應該可以以

.Values.global.salad

的形式來訪問這個值。

mychart/templates/configmap.yaml：

apiVersion:v1
kind:ConfigMap
metadata:
name:

.Release.Name

-configmap
data:
salad:

.Values.global.salad

mysubchart/templates/configmap.yaml:

apiVersion:v1
kind:ConfigMap
metadata:
name:

.Release.Name

-cfgmap2
data:
dessert:

.Values.dessert

salad:

.Values.global.salad

然後我們渲染這個模板，可以得到如下所示的內容：

---
# Source: mychart/charts/mysubchart/templates/configmap.yaml
apiVersion:v1
kind:ConfigMap
metadata:
name:mychart-1576053485-cfgmap2
data:
dessert:icecream
salad:caesar
---
# Source: mychart/templates/configmap.yaml
apiVersion:v1
kind:ConfigMap
metadata:
name:mychart-1576053485-configmap
data:
salad:caesar

全域性值對於傳遞這樣的資料比較有用。
共享模板¶

父級chart和子chart可以共享模板，任何chart中已定義的塊都可以用於其他chart。比如，我們可以定義一個簡單的模板，如下所示：

-define"labels"

from:mychart{{end}}

前面我們提到過可以使用在模板中使用include和template，但是使用include的一個優點是可以動態引入模板的內容：

include$mytemplate

install

debug

debug

install

debug

apiVersion:

# some: problem section
# {{ .Values.foo | quote }}

apiVersion:

# some: problem section
# "bar"

在載入任何charts之前，在安裝的時候載入ConfigMap或者Secret
在安裝新的chart之前，執行一個Job來備份資料庫，然後在升級後執行第二個Job還原資料
在刪除release之前執行一個JOb，以在刪除release之前適當地取消相關服務

Hooks的工作方式類似於普通的模板，但是他們具有特殊的註解，這些註解使Helm可以用不同的方式來使用他們。
Hooks¶

在Helm中定義瞭如下一些可供我們使用的Hooks：

預安裝pre-install：在模板渲染後，kubernetes建立任何資源之前執行
安裝後post-install：在所有kubernetes資源安裝到集群后執行
預刪除pre-delete：在從kubernetes刪除任何資源之前執行刪除請求
刪除後post-delete：刪除所有release的資源後執行
升級前pre-upgrade：在模板渲染後，但在任何資源升級之前執行
升級後post-upgrade：在所有資源升級後執行
預回滾pre-rollback：在模板渲染後，在任何資源回滾之前執行
回滾後post-rollback：在修改所有資源後執行回滾請求
測試test：在呼叫Helmtest子命令的時候執行（可以檢視測試文件）

生命週期¶

Hooks允許開發人員在release的生命週期中的一些關鍵節點執行一些鉤子函式，我們正常安裝一個chart包的時候的生命週期如下所示：

使用者執行helminstallfoo
Helm庫檔案呼叫安裝API
經過一些驗證，Helm庫渲染foo模板
Helm庫將產生的資源載入到kubernetes中去
Helm庫將release物件和其他資料返回給客戶端
Helm客戶端退出

如果開發人員在install的生命週期中定義了兩個hook：pre-install和post-install，那麼我們安裝一個chart包的生命週期就會多一些步驟了：

使用者執行helminstallfoo
Helm庫檔案呼叫安裝API
在crds/目錄下面的CRDs被安裝
經過一些驗證，Helm庫渲染foo模板
Helm庫將hook資源載入到kubernetes中，準備執行pre-installhooks
Helm庫會根據權重對hooks進行排序（預設分配權重0，權重相同的hook按升序排序）
Helm庫然後載入最低權重的hook
Helm庫會等待，直到hook準備就緒
Helm庫將產生的資源載入到kubernetes中，注意如果添加了--wait引數，Helm庫會等待所有資源都準備好，在這之前不會執行post-installhook
Helm庫執行post-installhook（載入hook資源）
Helm庫等待，直到hook準備就緒
Helm庫將release物件和其他資料返回給客戶端
Helm客戶端退出

等待hook準備就緒，這是一個阻塞的操作，如果hook中宣告的是一個Job資源，Helm將等待Job成功完成，如果失敗，則釋出失敗，在這個期間，Helm客戶端是處於暫停狀態的。

對於所有其他型別，只要kubernetes將資源標記為載入（新增或更新），資源就被視為就緒狀態，當一個hook聲明瞭很多資源是，這些資源是被序列執行的。

另外需要注意的是hook建立的資源不會作為release的一部分進行跟蹤和管理，一旦Helm驗證了hook已經達到了就緒狀態，它就不會去管它了。

所以，如果我們在hook中建立了資源，那麼不能依賴helmuninstall去刪除資源，因為hook建立的資源已經不受控制了，要銷燬這些資源，你需要將helm.sh/hook-delete-policy這個annotation新增到hook模板檔案中，或者設定Job資源的生存（TTL）欄位。
編寫Hook¶

Hooks就是Kubernetes資源清單檔案，在元資料部分帶有一些特殊的註解，因為他們是模板檔案，所以你可以使用普通模板所有的功能，包括讀取.Values、.Release和.Template。

例如，在templates/post-install-job.yaml檔案中宣告一個post-install的hook：

apiVersion:batch/v1
kind:Job
metadata:
name:"{{ .Release.Name }}"
labels:
app.kubernetes.io/managed-by:

.Release.Service|quote

app.kubernetes.io/instance:

.Release.Name|quote

app.kubernetes.io/version:

.Chart.AppVersion

helm.sh/chart:"{{ .Chart.Name }}-{{ .Chart.Version }}"
annotations:
# 因為添加了這個 hook，所以我們這個資源被定義為了 hook
# 如果沒有這行，則當前這個 Job 會被當成 release 的一部分內容。
"helm.sh/hook":post-install
"helm.sh/hook-weight":"-5"
"helm.sh/hook-delete-policy":hook-succeeded
spec:
template:
metadata:
name:"{{ .Release.Name }}"
labels:
app.kubernetes.io/managed-by:

.Release.Service|quote

app.kubernetes.io/instance:

.Release.Name|quote

helm.sh/chart:"{{ .Chart.Name }}-{{ .Chart.Version }}"
spec:
restartPolicy:Never
containers:
-name:post-install-job
image:"alpine:3.3"
command:

"/bin/sleep"

"{{ default "10" .Values.sleepyTime }}"

當前這個模板成為hook的原因就是新增這個註解：

annotations:
"helm.sh/hook":post-install

一種資源也可以實現多個hooks：

annotations:
"helm.sh/hook":post-install,post-upgrade

類似的，實現給定hook的資源數量也沒有限制，比如可以將secret和一個configmap都宣告為pre-installhook。

當子chart宣告hooks的時候，也會對其進行呼叫，頂層的chart無法停用子chart所宣告的hooks。可以為hooks定義權重，這將有助於確定hooks的執行順序：

annotations:
"helm.sh/hook-weight":"5"

hook權重可以是正數也可以是負數，但是必須用字串表示，當Helm開始執行特定種類的hooks的時候，它將以升序的方式對這些hooks進行排序。
Hook刪除策略¶

我們還可以定義確定何時刪除相應hook資源的策略，hook刪除策略可以使用下面的註解進行定義：

annotations:
"helm.sh/hook-delete-policy":before-hook-creation,hook-succeeded

我們也可以選擇一個或多個已定義的註解：

before-hook-creation：執行一個新的hook之前刪除前面的資源（預設）
hook-succeeded：hook成功執行後刪除資源
hook-failed：hook如果執行失敗則刪除資源

我們這裡為前面的完整示例WordPress開發一個Chart包，在開發Chart包之前很明顯我們最需要的就是要知道我們自己的應用應該如何使用，如何部署，不然是不可能編寫出對應的Chart包的。

我們可以用helmcreate命令來建立一個Chart包，這裡我們就完全手動來建立，首先建立一個名為wordpress的資料夾:

$mkdirwordpress&&cdwordpress

然後在目錄下面建立如下所示的Chart.yaml檔案：

apiVersion:v2
name:wordpress
description:AHelmchartforKubernetes
home:https://wordpress.org/
type:application
# chart 版本號
version:0.1.0
# wordpress 的應用版本
appVersion:5.3.2

由於WordPress應用本身是一來MySQL資料庫的，所以同樣需要新增一個依賴說明requirements.yaml：

dependencies:
-name:mysql
version:1.6.2
repository:http://mirror.azure.cn/kubernetes/charts/
condition:mysql.enabled
tags:
-wordpress-database

這裡依賴的應用我們可以透過helmsearch命令來獲取，當然也可以隨意指定一個Chart版本：

$helmsearchrepostable/mysql
NAMECHARTVERSIONAPPVERSIONDESCRIPTION
stable/mysql1.6.25.7.28Fast,reliable,scalable,andeasytouseopen-...

需要注意的是在依賴的檔案中我們添加了一個condition:mysql.enabled條件，這意味著當Values值mysql.enabled為true的時候才會真正去依賴這個子Chart，因為我們完全可以直接使用一個外部的資料庫。所以首先我們要先新增一個mysql.enabled的Values值，新增如下所示的values.yaml檔案：

##
## MySQL Chart 配置，參考如下 values.yaml
## https://github.com/helm/charts/blob/master/stable/mysql/values.yaml
##
mysql:
## 是否部署mysql服務來滿足wordpress的需求。如果要使用外部資料庫，將 enabled 設定為 false 並配置 externalDatabase 引數。
enabled:true
## todo，其他 mysql 配置

## 當 mysql.enabled=false 的時候使用外部資料庫
externalDatabase:
## 資料庫地址
host:localhost:3306

## WordPress 資料庫的非root使用者
user:wordpress

## 資料庫密碼
password:wordpress

## 資料庫名稱
database:wordpress

上面的Values配置很好理解，就是如果mysql.enabled=true則我們就用mysql這個子Chart去安裝一個MySQL資料庫，如果為false則使用下面externalDatabase的外部資料庫資訊來作為wordpress的資料庫配置，雖然現在這些配置還完全沒有任何作用，但是這些卻是一開始就很容易考慮到的事情。

接下來建立一個templates和charts目錄，並在charts目錄下面獲取mysql這個子chart:

$mkdirtemplates&&mkdircharts
$cdcharts&&helmfetchstable/mysql&&cd..

現在的整個Chart包目錄結構如下所示：

$tree.
.
├──Chart.yaml
├──charts
│└──mysql-1.6.2.tgz
├──requirements.yaml
├──templates
└──values.yaml

2directories,4files

接下來就是我們的重頭戲模板的開發了。我們可以將前面課程示例中的WordPress資源清單直接複製到templates目錄下面，將Deployment和Service分別放在不同的YAML檔案中，同樣還有資料持久化的資源清單，但是這裡我們就需要先將MySQL的部分移除掉，因為我們會透過外部資料庫或者子Chart來渲染，不需要在這裡顯示的聲明瞭，另外還需要將所有資源物件的名稱空間去掉，因為我們可以透過helminstall命令直接指定即可，現在我們的模板目錄結構就如下所示了：

$treetemplates
templates
├──deployment.yaml
├──pvc.yaml
└──service.yaml

0directories,4files

名稱¶

這個時候我們可以嘗試去安裝除錯下這個Chart模板：

$helminstall--generate-name--dry-run--debug.
install.go:148:

debug

Original chart version:""
install.go:165:

debug

CHART PATH:/Users/ych/devs/workspace/yidianzhishi/course/k8strain/content/helm/manifests/wordpress

load.go:112: Warning:DependenciesarehandledinChart.yamlsinceapiVersion"v2".WerecommendmigratingdependenciestoChart.yaml.
Error: rendered manifests contain a resource that already exists. Unable to continue with install: existing resource conflict: kind:Middleware,namespace:default,name:redirect-https
helm.go:76:

debug

existing resource conflict: kind:Middleware,namespace:default,name:redirect-https
renderedmanifestscontainaresourcethatalreadyexists.Unabletocontinuewithinstall
helm.sh/helm/v3/pkg/action.(*Install).Run
/home/circleci/helm.sh/helm/pkg/action/install.go:242
main.runInstall
/home/circleci/helm.sh/helm/cmd/helm/install.go:209
main.newInstallCmd.func1
/home/circleci/helm.sh/helm/cmd/helm/install.go:115
github.com/spf13/cobra.(*Command).execute
/go/pkg/mod/github.com/spf13/[email protected]/command.go:826
github.com/spf13/cobra.(*Command).ExecuteC
/go/pkg/mod/github.com/spf13/[email protected]/command.go:914
github.com/spf13/cobra.(*Command).Execute
/go/pkg/mod/github.com/spf13/[email protected]/command.go:864
main.main
/home/circleci/helm.sh/helm/cmd/helm/helm.go:75
runtime.main
/usr/local/go/src/runtime/proc.go:203
runtime.goexit
/usr/local/go/src/runtime/asm_amd64.s:1357

我們看到出現了錯誤，其中還有這樣的一條警告資訊load.go:112: Warning:DependenciesarehandledinChart.yamlsinceapiVersion"v2".WerecommendmigratingdependenciestoChart.yaml.，大概意思就是在Helm3中依賴項的配置被移動到了Chart.yaml檔案中，也就是在Helm2版本的時候依賴才會在requirements.yaml中宣告，這裡我們可以將requirements.yaml檔案中的內容全部複製到Chart.yaml檔案中去，然後刪除requirements.yaml檔案，這個時候重新DEBUG下就沒有這個提示資訊了。

下面的錯誤提示基本上都是類似於renderedmanifestscontainaresourcethatalreadyexists.這樣的資訊，意思就是這些資源物件在現有叢集中已經包含了，這很正常，因為我們的資源物件名稱都是寫死的，是非常有可能和現有的叢集衝突的，所以接下來我們要給這些資源清單改名，如何才能避免衝突又具有很好的擴充套件性呢？這裡我們建立一個如下所示的命名模板：

/*
建立一個預設的應用名稱，擷取63個字元是因為Kubernetes的name屬性的限制（DNS命名規範）。
*/

-define"wordpress.fullname"-

-if.Values.fullnameOverride-

-.Values.fullnameOverride|trunc63|trimSuffix"-"-

-else-

-$name:=default.Chart.Name.Values.nameOverride-

-ifcontains$name.Release.Name-

-.Release.Name|trunc63|trimSuffix"-"-

-else-

-printf"%s-%s".Release.Name$name|trunc63|trimSuffix"-"-

-end-

-end-

-end-

根據規範命名模板的名稱最好以Chart名作為字首，這裡我們命名成wordpress.fullname，首先就是判斷是否定義了fullnameOverride這個Values值，如果定義了則擷取63個字元並移除-這樣的前後綴作為名稱，如果沒有定義呢？就要檢查Chart名是否包含Release名稱，如果包含則擷取Release名的63個字元並移除-這樣的前後綴作為名稱，如果不包含，則將Release名稱和Chart名稱用-連線起來作為名稱，這個命名的方式也是符合大部分Chart模板中的命名，以後的模板開發中都可以直接使用。在templates目錄下面新建一個_helpers.tpl這樣的partials檔案，然後將上面定義的命名模板放置到裡面去。後面我們所有的命名模板都將在該檔案中完成。

接下來將templates目錄下面的所有資源物件name屬性全都換成上面我們定義的命名模板，由於這裡並沒有什麼空格控制之類的，我們直接使用template函式即可，同樣作為慣例，也習慣將Release和Chart名稱之類作為Label標籤，所以最終，這些資源清單的Meta資訊如下所示，如果有其他額外的資訊當然可以隨意新增：

metadata:
name:

template"wordpress.fullname".

labels:
app:"{{ template "wordpress.fullname" . }}"
chart:"{{ template "wordpress.chart" . }}"
release:

.Release.Name|quote

heritage:

.Release.Service|quote

然後當然也需要將Deployment的matchLabels和template下面的Label標籤進行修改，以及Service的selector匹配的標籤。

同樣還有PVC物件，以前我們直接使用的一個確定名稱的PVC物件：

volumes:
-name:wordpress-data
persistentVolumeClaim:
claimName:wordpress-pvc

但是現在我們這裡作為模板就要考慮到各種情況了，很有可能使用我們模板的使用者根本就不需要持久化，也有可能直接傳遞一個存在的PVC物件進來使用，所以這裡做了如下改變：

volumes:
-name:wordpress-data

-if.Values.persistence.enabled

persistentVolumeClaim:
claimName:

.Values.persistence.existingClaim|default(include"wordpress.fullname".)

-else

emptyDir:

end

當我們定義了Values值persistence.enabled=true為true時候就表示要使用持久化了，所以要指定下面的claimName屬性，但是還需要判斷persistence.existingClaim這個Values值是否存在，如果存在則表示直接使用，如果不存在則使用我們模板裡面渲染的PVC物件，如果不需要持久化，則直接使用emptyDir:{}即可。最後我們的PVC物件模板變成了如下所示：

-ifand.Values.persistence.enabled(not.Values.persistence.existingClaim)

kind:PersistentVolumeClaim
apiVersion:v1
metadata:
name:

template"wordpress.fullname".

labels:
app:"{{ template "wordpress.fullname" . }}"
chart:"{{ template "wordpress.chart" . }}"
release:

.Release.Name|quote

heritage:

.Release.Service|quote

spec:

-if.Values.persistence.storageClass

storageClassName:

.Values.persistence.storageClass|quote

-end

accessModes:
-

.Values.persistence.accessMode|quote

resources:
requests:
storage:

.Values.persistence.size|quote

-end-

其中訪問模式、儲存容量、StorageClass、存在的PVC都透過Values來指定，增加了靈活性。對應的values.yaml配置部分我們可以給一個預設的配置：

## 是否使用 PVC 開啟資料持久化
persistence:
enabled:true
## 是否使用 storageClass，如果不適用則補配置
# storageClass: "xxx"
##
## 如果想使用一個存在的 PVC 物件，則直接傳遞給下面的 existingClaim 變數
# existingClaim: your-claim
accessMode:ReadWriteMany# 訪問模式
size:2Gi# 儲存容量

現在我們去重新做一次DEBUG，可以看到正常了，但是還遠遠不夠，接下來我們就來定製其他部分。
定製¶

比如副本數我們可以透過Values來指定，變成replicas:

.Values.replicaCount

。

更新策略也可以，因為更新策略並不是一層不變的，這裡和之前不太一樣，我們需要用到一個新的函式toYaml：

-if.Values.updateStrategy

strategy:

toYaml.Values.updateStrategy|nindent4

-end

意思就是我們將updateStrategy這個Values值轉換成YAML格式，並保留4個空格。然後新增其他的配置，比如是否需要新增nodeSelector、容忍、親和性這些，這裡我們都是使用toYaml函式來控制空格，如下所示：

-if.Values.nodeSelector

nodeSelector:

toYaml.Values.nodeSelector|indent8

-end-

-with.Values.affinity

affinity:

toYaml.|indent8

-end

-with.Values.tolerations

tolerations:

toYaml.|indent8

-end

接下來當然就是映象的配置了，如果是私有倉庫還需要指定imagePullSecrets：

-if.Values.image.pullSecrets

imagePullSecrets:

-range.Values.image.pullSecrets

-name:

.

-end

-end

containers:
-name:wordpress
image:

printf"%s:%s".Values.image.name.Values.image.tag

imagePullPolicy:

.Values.image.pullPolicy|quote

ports:
-containerPort:80
name:web

對應的Values值如下所示：

image:
name:wordpress
tag:5.3.2-apache
## 指定 imagePullPolicy 預設為 Always
pullPolicy:IfNotPresent
## 如果是私有倉庫，需要指定 imagePullSecrets
# pullSecrets:
# - myRegistryKeySecretName