二重中括弧による Action 構文

Helm チャートは通常の YAML ではありません。テンプレートです。通常の YAML に小さなロジックを追加し、Helm が値を埋め込みます。✨

すべてのテンプレートディレクティブは、2 つの波括弧の間に記述します。{{ }} の組は、静的な YAML から Helm のテンプレートエンジンへ移る入口です。

波括弧の間に置かれるものは アクション と呼ばれます。Helm はレンダリング時にそれを評価し、結果を YAML に戻します。

最も単純なアクションは、何かを出力するだけです。ここでは、マニフェストが適用される前に Helm がアクションをリリース名に置き換えます。

先頭のドットは コンテキスト です。これは Helm が把握しているすべての情報を保持するトップレベルオブジェクトです。さらにドットを重ねることで、.Release.Name のように内部へ進めます。

波括弧内のスペースは書式にすぎません。{{ .Chart.Name }} と {{.Chart.Name}} は同じようにレンダリングされます。Helm の慣例では、読みやすさのため前者の形式を使います。

値を生成するアクションは 式 アクションです。記述した場所にテキストを置き換えるため、名前、タグ、ラベルに最適です。

別のアクションは何も出力しません。if や range などのキーワードがレンダリング内容を制御し、ブロックを表示するか、繰り返すかを決めます。

この構文全体は、Go の text/template エンジンに由来します。Helm はその上に追加の関数を重ねていますが、{{ }} の基盤は純粋な Go です。

波括弧の外側にあるテキストは変更されずに渡されます。評価されるのはアクションだけなので、レンダリング後も YAML の構造はそのまま維持されます。🧱

helm template を実行し、それぞれのアクションが消えて計算結果に置き換わる様子を確認します。その出力が、実際に Kubernetes に渡される内容です。

チャートテンプレート内に {{ .Release.Name }} があるとします。

基本的な構文を理解できました。{{ }} はアクションを表し、ドットはルートコンテキストを示します。波括弧の外側はすべて変更されずにレンダリングされます。🎯