跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

编译流水线(概览)

本章详细介绍 Go 编译器的内部机理,说明抽象的 YAML 如何经由编译流水线、中间表示(IR)图和 WebAssembly(Wasm)执行插槽转换为物理配置。

编译流水线与执行流程

Aggrega 运行一条严格、固定顺序的预先(Ahead-of-Time,AOT)编译器流水线,而不是硬编码的编排逻辑。编译器由 aggrega build 触发,在相互隔离的 WebAssembly(Wasm)插槽之间传递扁平图,在渲染物理制品之前对架构进行评估。

Wasm 插槽运行在一个嵌入式宿主上(基于 Wazero 引擎的 Extism 工具包),位于 AOT 纯度防火墙之后。该防火墙拒绝向插件提供任何运行时访问能力(网络、文件系统、挂钟时间、环境变量、标准 I/O),因此插件无法破坏确定性的预先编译保证。宿主通过 aggrega lint 以带外方式运行发布 linter。下文描述的带内关卡(治理插槽在拓扑构建阶段的 label-transform 角色和在静态分析阶段的 IR-verdict 角色,以及收尾渲染的插件流水线)在每次构建中都会运行:只要工作区为某个治理角色挂载了插件,该角色就会运行;每个声明了步骤的 Recipe 都会运行插件流水线。语言状态记录了每个流水线阶段的状态。

流水线完全在内存中按严格、固定的顺序执行:

解析:解析器与语法验证器

  • **机制:**继承合并、Go 模板插值以及 JSON Schema 2020-12 验证。
  • **操作:**CLI 获取所有请求的实体(Components、Features、Releases)。它首先检查这些定义中是否有 extends 关键字。对于 Catalog 实体,它会深度合并 YAML 元数据,而两种实体在数据支柱上各行其道:Feature 的 schema: 按 JSON Schema 2020-12 组合规则与其基础实体的组合,而进行扩展的 Component 只组合结构(其挂载槽、拓扑插槽、自注入允许列表和命名断言),并原样接收基础实体编写的 schema: 块。进行扩展的 Release 按相同规则折叠:子级的值逐键胜出,直到第一个不可分割的值(标量、列表、模板)为止,该值整体替换;子级写为 null 的键会被移除。因此其整个编写面都会被继承(包括带有各组件 infra 和 Feature 挂载的边界树、parameters 块、注解以及 Manifest 指针),而任何 metadata 字段都不会被继承,因为身份和来源是每个 Release 各自独有的。 接下来,它分三个子步骤执行内存中的插值:依据 Aggregate 的类型化 parameters: 声明进行参数契约验证;将解析后的值插入外围的 values: 字符串;从每个值模板上下文中撤除 .parameters 映射,使其仅对运维人员编写的路径模板可读。最后,它将解析后的 infra 块注入目标组件载荷。蓝图完全具体化后,编译器使用 Catalog 中统一的 schema: 声明(紧凑形式或完整的 JSON Schema 2020-12),在本地严格验证开发者的 values 和 infra 配置。
    • **Release Feature schema 验证:**通过 Release 挂载的 Features(包括边界范围的和组件特定的)会在此步骤中依据其 Catalog 实体进行解析。编译器在 catalog 解析之后立即依据每个 Feature 的 schema: 声明验证 Release 提供的 infra 块,从而在构建拓扑之前确保类型安全。
    • **注解驱动的 Feature 展开子阶段:**在 Manifest 解析、Recipe/Provider 绑定以及 Manifest 绑定目标验证(mappings.features.annotations.<key>.maps 下声明的路径存在于所引用 Feature 的 spec.schema 中)之后,编译器会在拓扑构建器之前运行注解展开子阶段。该子阶段由外向内遍历 Release 边界,并由外向内遍历 Aggregate 子系统,通过级联 + 覆盖 + null 退出合并计算每个组件的有效注解集;将每个注解值作为 YAML 解析为标量、结构化值或 null;将每个值(标量,或按子键的结构化值)经由 Manifest 绑定的 maps 声明路由到目标 Feature 的 schema 支柱,并强制执行侧与支柱的对应关系(Aggregate 侧触发 maps.values;Release 侧触发 maps.infra);依据 Feature 的 spec.schema 验证每个叶节点的类型;并注入合成的 Feature 挂载,IR 图会以 origin: annotation 标记这些挂载。Schema 在每次构建中只编译一次,并在各次级联遍历中复用。展开在绑定目标验证之后、拓扑构建之前运行,因此下游阶段在结构上对合成挂载与显式挂载一视同仁(通过来源检查除外)。有关绑定形态、级联语义和跨侧组合规则,请参阅 13-catalog-and-registry.md §“注解驱动的 Feature 展开”和 language-reference/providers/well-known-annotations.md。

拓扑构建:拓扑构建器与变更关卡

  • **机制:**AST 展开 + 治理插槽的 label-transform 角色。
  • 操作:编译器原生读取已验证组件中显式声明的 uses 块,以确定性地在图中节点之间绘制拓扑边,而 values 块保持完全不透明。随后它评估变更关卡,将图的一个投影——每个节点的标签及其实例声明的 values,编译器不加读取便直接交出——连同 Release 的名称和环境,传递给挂载在 label-transform 角色上的治理插件。插件评估上下文并返回 JSONPatch,以动态地为图自动打标签(例如,根据 Release 的环境注入标签 compliance.aggrega.ai/data-class: restricted,或根据数据库声明的扩展注入 datastore.aggrega.ai/engine: vector);这些补丁只作用于标签。

图的最终确定

  • **机制:**规范化。
  • **操作:**编译器最终确定扁平的中间表示(IR)图,保留拓扑构建器绘制的显式拓扑边。随后它将挂载的 Features 及其 values 载荷规范化为按节点 ID 映射的扁平字典,为验证准备好与能力无关的图。
    • **IR 载荷规范化:**IR 的结构形态为配置强制实行单一事实来源:拓扑层只承载图结构(节点身份、边、元数据标签),而规范化后的配置状态存放在一个独立的内存字典中,由编译器传递给下游插件。修改配置的变更器只在一处修改;provider 读取规范化状态,不存在因冗余存储而产生偏差的风险。

静态分析:静态分析器与验证关卡

  • **机制:**拓扑纯度检查 + 治理插槽的 ir-verdict 角色。
  • 操作: 编译器对 IR 图运行抽象静态分析。首先,它从 usesSchema 定义中提取 selector 字符串,并使用原生 Go 标签匹配引擎(支持 Kubernetes 风格的 AND、通过 in() 实现的 OR,以及通过 != 实现的 NOT 语义)在显式定义的图边上对其求值,以保证已声明套接字上的跨节点类型安全。ad-hoc 套接字上的边——由 Aggregate 作者命名而目录未声明的套接字——没有目录条目,因此也没有选择器,所以此检查既无可求值之物,也没有任何缺失;每条边都会记录自己属于哪一种,而 ad-hoc 边可以承载的内容则由目标声明的 provides 来界定。它还会对 Feature 的 appliesTo 和 appliesToAnyOf 选择器求值,以验证所附加的 feature 与其目标组件的标签兼容,并将每个已填充附加槽自身的 selector 与填充该槽的 Feature 的标签进行比对。其次,它将节点的 Component 声明的每个存在性要求——即每个 features.aggrega.ai/requiredType.<label> 注解——与该节点的最终附加集进行比对。此检查之所以放在分析器中,是因为这是第一个同时掌握该规则两部分的阶段:已解析 Component 实体的注解,以及 5 层级联产生的附加集,其中 Aggregate 附加、子系统附加、Release 附加和注解展开的附加一视同仁地计入。没有任何附加满足的要求会中止构建;声明格式错误的要求会以不同的诊断中止,因此损坏的声明绝不会被当作已满足的要求。第三,它执行验证门,将完整的图结构(包括所有节点、边、附加的 feature 以及预先计算的 DFS 路径)传递给附加在 ir-verdict 角色上的治理插件。企业的自定义 Wasm 策略对拓扑进行评估。如果 Wasm 插件返回失败数组(例如,检测到从 public 节点到 restricted 节点之间存在一条没有特定代理 feature 的连续路径),构建即中止。

渲染

  • 机制: 渲染前拦截(injectMapping)、延迟绑定(valuesMapping)以及 Wasm 渲染套接字(pipeline)。
  • 操作: 最终的制品生成阶段被划分为严格按时间顺序的子阶段,这些子阶段以固定顺序运行,从而保持执行的确定性:
    • 注入映射(渲染前拦截): Go 编译器解析开发者抽象的 .context.inject 契约。随后,它按照严格的 5 层洋葱模型执行顺序(子 Aggregate——先是模块组件自身的附加,再是其模块的子系统所声明的附加,由外向内 → 根 Aggregate 组件 → 根 Aggregate 子系统 → Release 边界由外向内 → Release 特定组件),执行所有附加的 FeatureRecipes 中的 injectMapping Go 模板。编译器原生地将生成的字典深度合并到调用方的 .context.inject 内存管道之上。这会在 Base Recipe 看到环境变量和连接字符串之前,为调用方安全地重写它们。映射可以重写调用方自身的 inject: 块或其某个连接所提供的内容;而对于另一个已附加的 Feature 已经提供的键——无论是通过其自身的映射还是自身的 inject: 块——构建会中止并指明两个附加,因此执行顺序绝不会在两个附加的值之间做出取舍。
    • Locals 前导: 在任何 provides 模板运行之前,编译器按书写顺序对 Recipe 的 .locals 条目求值,每个条目都基于一个自包含的节点本地上下文——.context.instance_id、.values、.infra 以及同一块中迄今已解析的条目,但不包括 .context.inject 或 .context.uses。因此,一个条目可以读取定义在其上方的同级条目,并获得该同级条目的已解析值;凡是一个条目读取另一个条目之处,作者书写的顺序都是契约的一部分,且绝不会为了让引用得以解析而对该块重新排序。先解析 locals,正是 provides 模板能够读取 .locals 的原因。在这些 locals 解析完成后,Recipe 的 .source 模板基于同一上下文求值,这使 .locals 可以作为 Recipe 各模板之间的简写复用,并让作者能够按边界对 .source(chart 版本、路径、仓库)进行参数化。
    • 基础渲染(基础 Recipe 的 valuesMapping): 编译器对 Base Recipe 的 valuesMapping 模板求值。该模板从 .context.inject 管道(在注入映射期间被重写)中读取被拦截的字符串,生成的 values 字典被交给 Recipe 的 capability 所指定的 provider——helm 和 helm-chart provider 都通过 Helm 渲染——以渲染基础基础设施制品。
    • Workload 解析与验证: 对于声明了 workload: 的 Recipe——无论是内联块内容,还是指定文件的 workload: { $import: <path> }——该文档会基于节点的渲染上下文作为模板求值,然后作为 YAML 解析为 Workload 结构并进行检查:渲染出的字节会依据 Workload schema 验证,解码后的值也会依据它验证(字节中带有解码时丢弃的键,而解码会省略以空值提供的字段,因此两者各自拒绝对方无法察觉的问题),每个 attachments 条目都会与所绑定 Component 的 featuresSchema 声明的槽进行比对,每个资源引用都会与其所指定槽的已解析 provides 进行比对。此处的失败会中止构建。解析后的 Workload 以 .workload 的形式放入模板上下文,因此之后在同一节点上求值的模板可以读取它。
    • Artifacts 求值: Recipe 在 artifacts: 下声明的每个条目——无论是内联内容,还是由该条目自身的 $import: 指定的文件——都会被读取、作为模板解析、基于完整的模板上下文求值,并携带构建的来源信息。生成的投影被交给 provider,由其决定输出格式、来源信息的落点、输出路径以及最终字节。每个输出的文件都会记录其来自哪种编写形式,因此在文件名冲突时可以指明每一个贡献者。
    • Workload 合成: 解析后的 Workload 被交给 Recipe 的 capability 所指定的 provider,由其转换为该 provider 的原生资源。未声明 workload: 的 Recipe 在此没有需要合成的内容;它的文件改由源渲染产生。
    • Feature 渲染(FeatureRecipe 资源生成): 节点上每个所绑定的 FeatureRecipe 自带 source、workload、artifacts 和/或 valuesMapping 的附件——即资源生成模式,用于 ServiceMonitor、NetworkPolicy、sidecar ConfigMap 或凭据交付资源等辅助清单——都在一次遍历中求值,顺序与注入映射所遵循的 5 层洋葱模型顺序相同。只有一个序列、一个附件集:运维 Feature 与凭据 Feature 走同一路径,二者的区别在于各自的 FeatureRecipe 输出什么。每个附件的 .values 和 .infra 会切换到其自身作用域;它继承基础 Recipe 已求值的 .locals;.attachment_name 指明正在渲染的实例,.provides 携带该附件自身已解析的 provides,即消费方读取的同一数据包。所得的值字典被传给 FeatureRecipe 自身 capability 所指定的 provider,渲染出的文件追加到该边界的输出中,并带有两个坐标——Feature 所附加到的 component,以及其附加时使用的名称——因此附加到多个 component 的同一 Feature 名称会各自保持独立。这些坐标采用何种形式取决于宿主 provider 自身的布局:若目标为每个贡献者提供独立位置,则使用与该 component 自身目录并列的 <component>--<instance>/ 目录;若目标只读取直接位于某目录中的文件,则使用 <component>--<instance>-- 文件名前缀。仅注入的 FeatureRecipes——只携带 injectMapping、已在注入映射阶段处理的那些——在此跳过。与之前的子阶段一样,Feature 渲染一次处理一个 component,因此附件通常在其所附加的 component 之后立即求值。若某附件的 FeatureRecipe 声明了 readsCallerRenderFacts: true 或 readsTargetRenderFacts: true,则改为在每个 component 以及每个未声明二者的附件都已渲染之后再求值——这样,每个连接到其宿主的 component 以及其宿主所连接的每个 component 届时均已渲染——其输出落在原本应落的位置。
    • 插件管道(Wasm 步骤执行): 编译器读取 Recipe 的 pipeline 数组,并按声明顺序执行其步骤。它针对节点已渲染的文档分派每个步骤所指定的 Wasm 插件,将步骤返回的 RFC 6902 JSON Patch 操作应用到这些操作所指向的文档上,并随之输出该步骤的副作用——这正是注入 Envoy sidecar 或挂载 secret VolumeMount 等精细修改背后的机制。when: 门控渲染为假值的步骤会作为直通被跳过,文档集原样留给下一步。每个步骤的 plugin URI 在执行前解析为 lockfile 按摘要锁定的、经过验证的制品字节。FeatureRecipe 的 pipeline 步骤以相同方式执行,作用于该附件自身已渲染的文档,对于 component 作用域的附件,还一并作用于宿主 component 的文档。

Recipe 的三种输入类型都会到达编译器:source: + valuesMapping: 经由基础渲染,workload: 经由 Workload 解析与 Workload 合成,artifacts: 经由 artifacts 求值。某个 provider 可以接收其中哪些,并非逐个子阶段决定——而是在任何渲染分派之前,依据该 provider 自身声明的契约,按节点一次性确定,因此输入类型不被所绑定 provider 接受的 Recipe 会在那里被拒绝,而不是在渲染中途。关于三种输入类型的组合模型、Workload 类型和 Artifacts 机制,参见 16-recipe-input-composition.md;关于哪个 provider 接受哪种类型,参见语言现状。

GitOps 原生输出

为了在其输出如何被应用方面严格保持不预设立场,渲染插件将生成的制品输出到干净、按边界隔离的目录结构中(例如 dist/boundaries/aws-core-cluster/、dist/boundaries/gcp-data-cluster/)。这使外部 GitOps 控制器(如 ArgoCD 或 Flux)能够同步并应用基础设施,而 Aggrega 编译器无需任何实时集群 API 凭据。

graph TD
    subgraph CLI_Orchestrator ["The Aggrega Compiler Pipeline"]
        direction TB
        A["Resolution — The Resolver & Syntax Validator<br/>(Inheritance Merge + Parameter Interpolation + JSON Schema 2020-12 Validation)"] --> B["Topology construction — The Topology Builder<br/>(AST Expansion + governance label-transform)"]
        
        B -->|"Emits IR Graph"| C["Graph finalization<br/>(Normalization)"]
        
        C -->|"Flat IR Graph"| D["Static analysis — The Static Analyzer<br/>(Selectors + governance ir-verdict Gate)"]
        
        D -->|"Validated Topology"| E["Rendering<br/>Inject mapping: Pre-Render Interception (injectMapping)<br/>Base rendering (valuesMapping)<br/>The plugin pipeline: Wasm Mutation (pipeline)"]
    end
graph LR
    E["Rendering"]
    E -->|"Stringified Artifacts"| F["Helm Charts"]
    E -->|"Stringified Artifacts"| G["Docker Compose"]
    E -->|"Stringified Artifacts"| H["Kubernetes Manifests"]
    E -->|"Stringified Artifacts"| I["Terraform Configuration"]
    E -->|"Stringified Artifacts"| J["CloudFormation Templates"]

基础设施源映射

Aggrega 将约 30 行的 Aggregate.yaml 编译为数千行实际的 JSON 或 YAML 配置。如果无法将运行中的资源追溯到其源头,调试“main.tf.json 第 4,032 行”处的故障就迫使开发者手动重建映射。Aggrega 的渲染插件通过将追踪标识符合并到 provider 原生的元数据位置来解决这一问题——Kubernetes 用 metadata.labels 和 metadata.annotations,Terraform 用来源注释,其他 provider 用各自对应的约定——使每个渲染出的对象都带有指回其来源的指针。aggrega.ai/compiler-version 标签(见 governance-and-compliance §5)是这一系列中的一个追踪键;除它之外,该标记还携带 aggrega.ai/aggregate-name、aggrega.ai/component-id、aggrega.ai/boundary-path、aggrega.ai/recipe-uri 和 aggrega.ai/environment,helm、helm-chart、compose、terraform 和 cloudformation provider 都会生成该标记——helm-chart provider 将其写在 Recipe 添加到 chart 的模板文件上,因为它会原样复制 chart 自身的模板。

该标记不携带任何标识 feature 来源或目录类型的键。

编译器还附带另外两个调试面。aggrega build --trace 将每个节点的中间状态逐个阶段写入 .trace/(位于 dist/ 旁边),供 Recipe 作者检查每个阶段接收和产生了什么;而导致中止的诊断会携带其所属编写面的类别——DEVELOPER_ERROR、OPS_ERROR、CATALOG_ERROR 等——只要故障有所属类别,从而指向正确的作者。将失败的生成清单字段追溯到产生它的模板行的错误不属于编译器。

验证器管线

解析过程中的 schema 验证阶段建立在一条验证器管线之上:该管线把实体 spec 内容(紧凑形式、JSON Schema YAML 或二者混合)转换为一个带有逐叶来源信息的统一 JSON Schema 2020-12 文档,然后据此验证开发者编写的实例内容。五个阶段按顺序以纯变换的方式运行;每个阶段都是关于其声明输入的确定性函数。

阶段 1 — 紧凑形式编译。 编译器遍历 schema:、parameters: 和 SchemaLibrary 内容的 YAML 树;按节点分派(紧凑形式叶节点、JSON Schema YAML、$ref: 引用或组合);输出解析后的 JSON Schema 2020-12。紧凑形式与 JSON Schema YAML 可以通过 $jsonschema: 逃生舱口在任意节点边界上混用;编译器通过遍历树并按节点分派来处理混合情形。该变换是纯函数:相同的紧凑形式输入总是产生相同的 JSON Schema 输出。关键字词汇参见 language-reference/vocabulary/compact-form-authoring.md。

阶段 2 — spec.templates 与 $instantiate: 解析。 对于以模板引用形式编写的 SchemaLibrary 条目,编译器遍历每个通过 $args: 调用 $instantiate: 的库条目,以字面量标量替换的方式代入参数值,生成具体的 schema 条目。替换在每次加载库时运行一次;解析后的条目会被缓存。库实体的编写形式参见 language-reference/entities/schemalibrary.md。

阶段 3 — 跨文档 $ref: 展开。 对于通过 $ref:(标识形式 <Library>#/schemas/<entry>)进行的 SchemaLibrary 引用,编译器在编译期借助解析栈传递遍历引用链;被引用的内容内联到使用方的 schema 中。展开过程保留循环检测(循环会以指明引用链的错误中止构建)、“按标识而非位置”护栏(携带注册表主机的引用会中止构建,并提示改用标识形式——引用按标识而非物理位置定位库),以及单源组合($ref: 块只接受裸引用;使用方的覆盖通过 JSON Schema 的 allOf: 组合)。解析语义参见 language-reference/vocabulary/cross-document-ref.md。

阶段 4 — 为 featuresSchema: 合成桥接。 编译器按作者顺序遍历每个实体的 featuresSchema: 内容,输出一个 JSON Schema 片段,描述可绑定到每个附加槽位的填充值的形状;声明了 inject 允许列表的槽位会带有 x-aggrega-inject: 扩展关键字。该片段单独编译,并针对所编写的附加块单独检查,而不是合并进面向开发者的 schema: 内容;扩展关键字是 JSON Schema 验证会忽略的元数据,之后的阶段也不会从片段中读回它——需要槽位允许列表的检查直接读取槽位。usesSchema: 插座表不投影到任何片段:插座的 selector: 和 inject: 按 Architect 编写的类型化 YAML 读取,插座的逐边 valueSchema: / infraSchema: 则单独编译。该合成是关于其输入的纯函数。

阶段 5 — 带来源信息的自定义合并器。 对于声明了 extends: 的实体,编译器遍历父级链;父级解析后的 JSON Schema 作为基础,子级的覆盖叠加在其上。解析后 schema 中的每个叶节点都带有逐叶来源标记(文件路径、行号、来自父级还是子级)。合并器的输出即验证器引擎的输入;验证器引擎是未经修改的第三方 JSON Schema 2020-12 合规实现,外面包裹一个确定性遍历器,用于按顺序输出检查结果。

这五个阶段在验证器引擎看到 schema 之前运行。引擎接收单个解析后的 JSON Schema 2020-12 文档以及开发者的实例内容,生成验证报告。错误格式化器参考来源标记,输出清晰指明源位置的面向用户的诊断信息——包括某个 Feature 从其基础继承而非自行编写的约束所在的原始文件。

验证器流水线在每个载荷首次完整的地方运行——解析期间组件的 values 和 infra,拓扑构建引入子聚合时其中的组件,以及图最终化时附加项的载荷——因此 schema 发现的问题会在静态分析评估任何选择器之前、在断言求值之前中止构建,这使断言模板可以依赖已验证的载荷。

整个流水线中的确定性保持

编译流水线的每个阶段都保持确定性输出不变量(Deterministic Output Invariant):给定相同的源文件、相同的 lockfile 以及相同的编译器版本,构建产生逐字节相同的输出。该不变量是基础性的——lockfile 中的内容寻址需要稳定的制品摘要;可复现构建要求在开发者 A 的笔记本上编写的 release 在开发者 B 的笔记本上和 CI 上编译出相同的输出;差异可审查性要求源代码变更是编译输出中唯一出现的变更。

确定性由每个转换都遵守的少数几条准则来保持:

  • 固定的迭代顺序。 每次遍历映射形式的 YAML 都按固定顺序迭代,因为 Go 原生的 map 迭代是随机的。编译器在大多数阶段(紧凑形式编译器、合并器、spec.templates 解析器、错误格式化器、YAML 序列化器)先排序再迭代;而附着槽投影则沿用作者自己的顺序,因此槽表的属性顺序就是其编写时的顺序。
  • 不嵌入时间。 编译不会在输出中嵌入时间戳。下午 2:00 的构建与凌晨 2:00 的构建产生相同的制品。合并器的来源元数据使用 file:line,而不是 file:timestamp。
  • 相对于工作区的路径。 解析输出中的所有路径都是相对于工作区的;路径解析层在路径进入任何输出之前对其进行规范化。
  • 无随机源,无外部状态。 转换是基于其声明输入(实体内容、父链、lockfile)的纯函数。仅在解析期间(OCI 制品获取)才会查询外部状态,且解析后的内容按摘要进行内容寻址。
  • 规范的 YAML 序列化。 对同一输入,输出以同一种固定形式写出:每次运行在每一层级都使用相同的键顺序,数组和 enum: 数组保持输入顺序;2 空格缩进;Unix LF 换行符;在 YAML 允许的地方使用不加引号的字符串;布尔值采用 true/false 形式;缺失的字段省略 null。
  • $defs: 按字母顺序。 在解析后的 JSON Schema 中,Schema 的 $defs: 条目按字母键顺序输出。$defs: 在概念上是一个字典,而不是有序列表;字母顺序使得源代码重组时的差异可预测。
  • 并行不会体现在输出中。 编译器可以并行处理相互独立的单元(不同实体可以并发编译)。并行结果在序列化之前会被收集到一个确定性结构中(例如按实体名称排序)。

编译器的端到端测试在一次测试中将每个测试夹具编译多次,并断言每次运行都输出相同的文件,且内容逐字节相同。正是重复编译才能捕获 map 迭代顺序泄漏或对未排序集合的迭代——这类问题在大多数运行中输出稳定,偶尔才会出现差异。这些测试与编译器的其余测试套件一同运行。

确定性输出不变量适用于构建时:给定相同的源文件 + 相同的 lockfile + 相同的编译器版本,输出逐字节相同。锁定时的配套属性(给定相同的源文件 + 相同的注册表状态,得到相同的 lockfile)则较弱——注册表是可变的(可以发布新版本;可以添加 sidecar;每个 component 的元数据可能演变),因此在不同时间针对相同源文件执行两次锁定,可能产生不同的 lockfile。这正是 lockfile 的用途,与 npm、Cargo 和 Go 中的约定一致。基于一个新的 lockfile,构建会产生确定性输出。这种两个时刻的分离使注册表端的可变性变得可以接受:在时间 T2 发布的 sidecar 会改变下一次锁定调用的结果;它不会改变基于 T1 生成的 lockfile 的构建。