テンプレートの概要
Recipe と FeatureRecipe の作成者は、特定の評価箇所で Go の text/template コードを記述します。対象となるのは、provides エントリ、locals エントリ、valuesMapping(インライン、または $import: による読み込み)、workload: の内容(インライン、または $import: による読み込み)、artifacts: エントリ(インライン、またはエントリごとの $import: による読み込み)、FeatureRecipe の injectMapping、source:、assertions: エントリ、および各 pipeline: ステップの with: と when: です。各箇所は、コンパイルパイプラインの定められたフェーズで実行され、ピラーコンテキストの定められたビューを受け取ります。この一連の章では、テンプレートが実行される場所、各箇所でコンテキストが公開する内容、利用できるヘルパー関数というテンプレートの仕様面を説明します。
テンプレートコンテキストの形状と評価順序は、根幹を支える契約です。どちらかを変更すると、既存のすべての Recipe テンプレートが動作しなくなります。テンプレートコンテキストは、コンパイラに同梱される JSON Schema で形式的に定義されています。箇所ごとの評価マトリクスは、どの箇所でどのピラーを読み取れるかを示し、Go テンプレートエンジンには Sprig ヘルパーライブラリと Aggrega 固有の拡張が同梱されています。これらの評価箇所の基盤となるパイプラインの各ステージは、../architecture/10-compilation-pipeline.md でアーキテクチャのレベルで説明されています。FeatureRecipe の injectMapping には inject mapping、Recipe の .locals と .source には locals プリアンブルとソース解決、ベース Recipe の valuesMapping にはベースレンダリング、FeatureRecipe のリソース生成にはフィーチャーレンダリングが対応します。
トピック別リファレンス
- テンプレート展開マトリクス — すべてのテンプレート評価箇所、各箇所が読み取るピラー、出力が IR グラフまたは後続のサブパスへどのように流れるかを網羅した、箇所ごとの正式な表です。
- テンプレートコンテキストの契約 — コンパイラがテンプレートに渡すテンプレートコンテキストの形式的な形状です。二状態の
.inject/.inject_rawの組と、拡張された.context.usesの JOIN 射影を含みます。 - レンダリングされたリソースの命名 — 2 つの識別キーのどちらが何を命名するか、
usesのターゲットとプロデューサーが公開する参照の違い、どのプロバイダーがレンダリングしたリソースの名前を報告し、他のプロバイダーがなぜ報告しないのか、そしてそのような名前が存在しない場合にキーを拒否する停止について説明します。 - Sprig 関数とヘルパー — Go テンプレート内で利用できる Sprig ヘルパーに加え、Aggrega 固有の拡張と安全性ヘルパー、記述された数値が値テンプレートでどのように読み取られ、出力され、比較されるか、そして値が記述されたかどうかを問うヘルパーと、値が空かどうかを問うヘルパーの区別です。
- パラメーターのテンプレートコンテキスト — Release が充足した
parameters:の値がテンプレートに届く場所です。値テンプレートには実行前に補間され、直接読み取るのはパステンプレートだけです。 assertions:ブロック — Component、Feature、Recipe、FeatureRecipe がテンプレートとして宣言する名前付きのフィールド間ルールで、レンダリングの前に評価されます。