tpl：Values の文字列をレンダリングする

values.yaml 内の値にテンプレート構文が含まれることがあります。デフォルトでは、Helm はそれを単なる文字列として扱い、評価しません。

tpl 関数は文字列とコンテキストを受け取り、呼び出した場所でその文字列を Go テンプレートとしてレンダリングします。

tpl の2番目の引数は、レンダリング時に使うスコープです。ルートのドットを渡すと、文字列から Values と Release にアクセスできます。

これでユーザーは、リリース名から組み立てたホスト名のような dynamic 文字列を values に保存し、レンダリング時に展開できるようになります。

テンプレート内でそのフィールドをルートコンテキストとともに tpl に渡し、保存されているプレースホルダーを実際の値に変換します。

直接参照すると、生の波括弧がテキストとして出力されます。保存された文字列内の埋め込みディレクティブを実際に評価できるのは tpl だけです。

ファイルの内容をtplに渡すこともできます。これにより、チャートに同梱した設定ファイルにリリース固有のプレースホルダーを含められます。

コンテキストはルートである必要はありません。任意のdictを渡せば、レンダリングされる文字列から、選択した変数だけを正確に参照できます。

チャートでは、この方法でingressのホストやアノテーションをテンプレート化することがよくあります。柔軟な設定をテンプレートではなくvaluesに置けます。

保存した文字列に誤りがあると、tplはレンダリング時に失敗します。そのため、テンプレート化したvaluesを追加したら、helm templateでテストしてください。

テンプレート化したホストにはドットやコロンが含まれる場合があるため、tplの結果をquoteにパイプしてください。最終的なYAMLの値を安全な文字列として扱えます。

tplの動作を確認しましょう。

tplは、valuesやファイルに保存されたテンプレート文字列を、ルートのドットなど指定したコンテキストを使って評価することを学びました。🎉