コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

テンプレートの概要

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 がテンプレートとして宣言する名前付きのフィールド間ルールで、レンダリングの前に評価されます。