本页面由机器翻译。阅读英文原文。
模板概述
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,locals 前导和源解析对应 Recipe .locals 和 .source,基础渲染对应基础 Recipe valuesMapping,特性渲染对应 FeatureRecipe 资源生成。
分主题参考
- 模板展开矩阵——权威的按位置表格,涵盖每个模板求值点、该位置读取哪些支柱,以及输出如何流入 IR 图或下游子阶段。
- 模板上下文契约——编译器交给模板的模板上下文的正式结构,包括双状态的
.inject/.inject_raw对以及增强的.context.usesJOIN 投影。 - 为渲染的资源命名——两个标识键分别命名什么、
uses目标与生产者发布的引用之间的区别、哪些 provider 会为其渲染的资源报告名称以及其他 provider 为何不报告,以及在不存在此类名称时拒绝该键的中止。 - Sprig 函数与辅助函数——Go 模板中可用的 Sprig 辅助函数,以及 Aggrega 特有的扩展和安全辅助函数;编写的数字在值模板中如何读取、打印和比较;以及哪些辅助函数判断某个值是否被编写、哪些判断它是否为空。
- 参数模板上下文——由 Release 填充的
parameters:值在何处到达模板:在值模板运行之前插值到其中,只有路径模板会直接读取它们。 assertions:块——Component、Feature、Recipe 或 FeatureRecipe 以模板形式声明的具名跨字段规则,在渲染之前求值。