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

治理与合规

本章定义平台团队如何在每次构建中实施企业合规——通过治理插槽、目录的基线和 schema,以及目录作者遵循的约定——而无需将策略硬编码进编译器。Day-2 生命周期事件是 Day-2 生命周期的主题。

企业治理与合规模式

平台工程中的一个核心挑战,是在不污染开源目录的前提下实施企业治理(例如 SOC 2 合规、FinOps 成本中心跟踪以及严格的归属映射)。

如果 Aggrega 将特定领域的逻辑硬编码到其官方组件中,它将不再是一个不预设立场的编译器,而沦为一个预设立场的框架。反之,如果合规完全交给开发者,关键标签就会被拼错、遗忘或绕过。

为解决这一问题,Aggrega 为合规提供 Wasm 插槽机制,而由企业决定策略。企业通过在其生态系统中采用两种不同的社会契约来实现零信任治理。

1. “自带基线”(BYOB)+ Wasm 验证关卡

对于由开发者提供的静态数据(例如团队归属或数据分级),企业绝不应直接依赖原始的开源目录。相反,平台架构师编写一个企业基线——每个内部组件都必须携带的字段,在一个 SchemaLibrary 条目中一次性声明——并使用一个治理裁决角色来强制使用该基线。

目录契约: 企业创建一个基线,它要求特定标签,但不配置任何基础设施。

apiVersion: aggrega.ai/v1beta1
kind: SchemaLibrary
metadata:
name: CorporateBaseline
version: 1.0.0
spec:
schemas:
Ownership:
type: object
properties:
owner: { type: string }
cost_center: { type: string }
# The developer MUST provide these, or the schema validator halts the build
required: [owner, cost_center]

每个内部组件(例如 acme/datastore/postgres)从自己的 schema: 引用该条目,并添加属于它自己的值,从而共享字段与组件自身的字段一同接受验证:

apiVersion: aggrega.ai/v1beta1
kind: Component
metadata:
name: acme/datastore/postgres
version: 1.0.0
labels:
component.aggrega.ai/type: stateful-server
spec:
schema:
values:
$ref: "CorporateBaseline#/schemas/Ownership"
properties:
database: { type: string }
required: [database]

基线是一个库条目而不是一个基础 Component,因为写了 extends: 的 Component 会完整接收其基础的 schema:,且不声明任何自己的值(参见继承与发布纪律)。

Wasm 验证保险机制: 为防止开发者绕过内部目录、直接从公共仓库拉取一个裸的 core/postgres 组件,企业会注册一个拓扑验证插件。它在静态分析期间求值——在图组装完成之后、任何制品渲染之前——因此它看到的是整个拓扑,而不是一次一个组件。

# Evaluated by the governance ir-verdict role over the assembled graph
package acme.governance
import rego.v1
deny contains msg if {
some id, _ in input.graph.spec.nodes
not input.graph.spec.values_mapping[id].owner
msg := sprintf("node %v declares no owner; use a component whose schema references 'CorporateBaseline#/schemas/Ownership'.", [id])
}

策略在其 deny 键下收集的决定即为拒绝,构建会因此中止。

禁止自由形式的连接: 开发者可以通过目录未声明的插槽连接一条边——即临时插槽(参见 dependency-resolution)。这种开放性是有意为之的,编译器对此不持任何立场同样是有意为之:如果一个组织希望每个连接都经过其架构师声明的插槽,就应将其表达为策略,而不是依赖编译器。图中的每条边都带有 socket_declaration,其值为 declared 或 ad-hoc,因此该规则只需一行:

# Evaluated by the governance ir-verdict role over the assembled graph
package acme.governance
import rego.v1
deny contains msg if {
some e in input.graph.spec.edges
e.socket_declaration == "ad-hoc"
msg := sprintf("%v connects to %v through the free-form socket %v; declare the socket in the component type's usesSchema.",
[e.source, e.target, e.socket])
}

无论边以何种方式编写,每条边上都始终存在该值,因此策略永远不必把缺失的字段解读为“declared”。而且它是一个独立的维度:它说明的是插槽从何而来,而不是谁画了这条边,因此它与 origin_feature 和 origin_release 组合使用而不会重叠——策略可以禁止自由形式的连接,同时仍允许 Release 连接已声明的连接。

**集中式企业治理(对完整现实求值):**带外机制(例如 git 仓库上的 CODEOWNERS)审查的是发生变更的文件,而不是这些文件编译成的架构。治理裁决角色评判的是架构本身。由于 AOT 编译器通过将开发者的 Aggregate 和平台运维人员的 Release 一并扁平化来构建 IR 图,ir-verdict 角色上的策略会在生成物理制品之前对完整现实求值,而 render-verdict 角色上的策略则对制品本身求值。如果开发者请求了未经批准的 Component,或者——通过读取每个渲染对象上标记的 aggrega.ai/recipe-uri 来源信息——如果 Manifest 将某个组件映射到未经批准的 Recipe,策略都可以致命地中止构建。

2. Wasm 变更器关卡(动态合规)

不应强迫开发者在其 Aggregate 中手动输入环境相关的合规标签(例如 environment: production 或 soc2_in_scope: true),因为这些标签会随 GitOps 目标而变化。

对于动态元数据,企业使用变更关卡——治理插槽的 label-transform 角色,它在拓扑构建期间运行。在图展开之后、静态分析对其求值之前,编译器会执行企业附加的 Wasm 插件。该插件读取 Release 的环境、节点已声明的标签以及每个节点的实例所声明的值,并指出构建中的节点应携带哪些标签——从而使所需元数据无需开发者输入即可到达组件(例如,根据 Release 的环境决定的标签 compliance.aggrega.ai/data-class: restricted,或根据数据库声明的扩展决定的 datastore.aggrega.ai/engine: vector)。这些值是只读的:插件只决定标签,不做其他任何事。

该角色上的策略指出标签——节点、键及其取值——而不是编写构建所应用的编辑指令。这一原因对编写此类策略的人很重要:编辑指令按路径定位标签,而 Aggrega 的标签键通常包含 /,即路径分隔符,因此手写的路径会定位到一个嵌套位置,而不是某一个标签。构建会定位决定中指出的标签,并且该角色接收的节点投影使这些节点比针对整个图的裁决浅一层。

# Evaluated by the governance label-transform role, during topology construction
package acme.tagging
import rego.v1
labels contains {"node": id, "key": "acme.com/soc2-scope", "value": "true"} if {
input.compilation_context.environment == "production"
some id, node in input.graph.nodes
node.labels["component.aggrega.ai/type"] == "stateful-server"
}

由于这些标签在渲染开始前就已在内存中注入标准元数据字典,Wasm 渲染插件可以在渲染制品时读取它们,以有条件地生成特定的物理配置——例如加固的 AWS 或 Kubernetes 资源。

规则只需声明一次:治理附加的作用域是工作区。 上述两种模式按组件、按 Feature 编写,但实施它们的治理附加并非如此。治理插件附加在工作区配置的 plugins.governance 键上,该附加约束工作区中的每一次构建。因此,企业规则恰好只在一个地方声明:平台团队附加一次插件,任何组件、Aggregate 或 Release 都无需选择加入、提及它或为其生效而修改。正因如此,模式 1 中的验证保险机制才是一个完整的答案,而不是按项目的约定——绕过内部目录、请求裸 core/postgres 的开发者,与其他所有人一样由同一个已附加的策略求值,因为策略是工作区的属性,而不是他们所选组件的属性。

工作区规则只会拒绝,不会改写开发者的契约。 作用域是全局的,而效果被有意限制为裁决。适用于所有地方的规则会中止违反它的构建,并指出需要修复的内容,它不能转而修改违规组件使其合规。正是这一边界使该机制在整个资产规模上仍可调试:构建要么符合工作区声明的规则,要么停止并给出指向所编写代码行的消息,渲染输出中绝不会包含任何未经编写文件要求的约束或资源。如果企业确实希望改变图而不是对其作出裁决,它会附加一个变换角色——即上文的模式 2——该变更的作用域限于运维人员附加它所要做的事,因此它是平台团队的显式行为,而不是不可见的改写。

对于要闭合合规闭环的平台团队,其实际结论是:将载荷必须具备的形状表达为企业基线上的 schema 约束,将资产所需的跨实体规则表达为附加的裁决角色,将开发者永远不应输入的派生元数据表达为附加的变换角色。这三者都只声明一次并适用于每一次构建,而且都不要求开发者知道它们的存在。

3. 保留领域智能(配置与安全)

由于 Aggrega 编译器不预设立场,它对 AI 框架、token 预算或内存分区没有任何硬编码的知识。通用的云原生 schema 只是一个空容器。高度专业化的领域智能并不硬编码在编译器核心中,而是分布在整个可扩展的 Aggrega 生态系统中。它通过专门的 components、features 和 recipes 封装在平台目录(Platform Catalog)中。开发者在其 values 和 uses 块中保留具体的应用意图——这些块严格受架构师的 schema: 声明(紧凑形式或完整的 JSON Schema 2020-12)和 usesSchema 插槽约束——而这些智能的物理转换则由特定于目标的 WebAssembly 插件执行。

A. 对领域特定的实现建模(通过拆分 Schema 验证)

平台架构师可以利用拆分 Schema 流水线对任何复杂架构建模,完全独立于核心编译器:

  • 不透明的执行逻辑(values): 如果企业部署了 AI 网关,开发者配置的是网关自身的行为——在标准库的 AI 网关上,即 models 映射,它发布调用方可以请求的每个别名以及每个别名解析到的上游。核心编译器不解析这些概念。它们安全地存放在不透明的 values 载荷中,并由该组件的 schema: 声明严格验证。编译器只是将该载荷传递给 Wasm 插件以生成网关的配置。多个网关产品共有的控制项,例如回退链、重试次数或在发布同一别名的多个条目之间的选择,是附加到网关上的 Features,而不是网关上的值,每一项都以该网关自己的方式为该网关实现。
  • 拓扑依赖映射(uses): 当某个 AI 框架将智能体连接到其工具或向量数据存储时,这种连接决定了谁与谁通信,因此要在 uses 支柱中声明;保存在 values 中的名称列表(例如标准库的 tools_allowed)只是一种约定,不会绘制任何边。编译器将这些显式边原样绘制到 IR 图中。这使下游的 Wasm 渲染插件能够以编程方式生成保护这些连接所需的网络策略和物理边界,而编译器无需理解底层的 AI 框架。
  • 复杂数据结构(例如 CoALA): 架构师不必局限于一个扁平的目标列表,而是可以根据结构的需要在 usesSchema 中声明任意多个插槽,每个插槽都有自己的选择器和自己的逐边 valueSchema。例如,为实现 CoALA 框架,架构师可以将 semantic_memory、episodic_memory 和 working_memory 声明为不同的插槽,使每个记忆存储都是一个独立的拓扑目标。通用策略引擎会评估这些结构化的边,为每个不同的认知脑叶强制实施细粒度的访问控制护栏。

B. 核心安全与间接机制

虽然载荷不预设立场,但通用 schema 会强制实施支持安全生成制品的严格结构机制:

  • 附件而非值模式: 标准库的约定是,凭据作为附件来请求,绝不写入 values 块——在那里它会成为编译器原样携带的内联字面量。凭据附件指定一个凭据 Feature type(带有标签 feature.aggrega.ai/kind: secret 的类型),并使用其自身的 values 来描述对密钥存储的查询。这样,凭据路由就是与能力无关的延迟绑定,核心编译器从不解析或暴露凭据内容——它只传递 Ops Recipe 提供的指针。这是目录和 schema 所鼓励的约定,而不是编译器检查:编译器不解释 values 叶子节点的含义,因此内联凭据内容的作者就会把它内联进去。schema 确实保证的是,附件这一接口存在且带有类型。
  • 抽象信任验证: 由于 values 块具有广泛的可扩展性,架构师可以规定诸如 tls_pinning 或 required_signatures: 2(用于 Quorum 共识)之类的抽象指令。核心编译器将这些经过 schema 验证的对象原样传入扁平的 IR 图。随后,自定义的 Wasm 渲染插件可以读取这些值,为硬件级的人机协同(HITL)审批关卡生成制品。如果应用试图绕过共识规则,物理部署的代理会阻止执行,直到收到 webhook 审批。

C. 高级运维安全(spec.interoperability)

为了保护脆弱的工作负载免受相互冲突的基础设施变更影响,通用 Feature schema 定义了一个互操作性控制项:

  • spec.interoperability.conflictsWith——一个列表,列出不能与本 Feature 同时作用于同一组件的 Features。当一个组件最终获得的附件——从作用于它的每个范围收集而来:组件本身、包含它的子系统或边界、它在 Release 中的组件条目,以及注解驱动的展开——同时包含本 Feature 和它所列出的某个 Feature 时,编译器会在渲染前中止构建。这只是将该 Feature 作者声明的名称与组件所携带的 Features 进行比较,不对任何一方赋予含义:不兼容性是作者的判断,编译器让构建遵守它。声明一次即可,名称匹配与版本无关,而附加到不共享任何组件的兄弟边界上的两个 Features 永远不会相遇。

4. 网络边界治理(默认拒绝约定)

开发者不直接编写网络策略;所需的网络边界由编译器的中间表示(IR)图映射,该图承载 Aggregate 中声明的组件之间的每一条拓扑边。

  • 内部边界。 编译器绘制扁平的 IR 图,自身不做任何限制:没有策略时,集群网络允许的每个连接都保持可达。约定是:为某个组件编写的策略,除该策略自身的附加项所指定的内容外,仅在 Aggregate 为某个连接声明了边时才允许该连接,并在该策略所管辖的方向上拒绝其他所有连接。
  • 标准库的实现。 标准库目录将该约定实现为两个 Features,由运维人员在 Release 中附加到组件上,分别对应连接的一个方向:core/caller-allowlist 只接受来自那些 uses 边指向该组件的组件的连接,core/egress-allowlist 只允许该组件连接到其自身的边所指向的组件以及集群的 DNS。在 helm 目标上,每一个都由一个 FeatureRecipe 实现,它根据编译器交给它的边写出一个 Kubernetes NetworkPolicy,并依据每个组件自身渲染所生成的内容来指定该组件的 pod——其工作负载携带的选择器和标签、它们被生成到的命名空间以及其容器声明的端口——因此无需手动重复任何标签或端口。每一个还会放行该组件自身的 pod 以及 Release 在附加项上指定的内容:入站一侧是 Aggregate 之外的来源,出站一侧是集群并未运行的目标的地址范围,这类目标不渲染可供选择的 pod,只按范围放行,且不限端口。编译器无法检查集群,因此在 Release 确认集群的网络插件会执行网络策略之前,每一个都会使构建中止;compose 没有网络策略,在其上附加任一项的构建都会中止。
  • 公共入口(与具体内容无关的边界控制)。 公共入口由企业在治理裁决角色上的自定义规则管辖。企业安全团队可以编写一个策略,评估节点的云原生本体类型,并在开发者试图将 public-ingress feature 附加到 worker 或 task 节点时拒绝构建。编译器不解释“public”的含义;它执行的是 Wasm 校验关卡的布尔输出。

5. 编译时来源标记

编译器在编译过程中构建一条来源记录,记录编译器版本以及它所编译的 Aggregate、Manifest 和 Release 的版本——不含时间戳,因此该记录绝不会破坏逐字节相同的输出。helm 渲染器将编译器版本作为 aggrega.ai/compiler-version 标签写入生成的 Kubernetes 清单,helm-chart 渲染器则将其写在 Recipe 添加到 chart 的模板文件上,因为它会原样复制 chart 自身的模板;企业安全团队借此识别哪些渲染制品由哪个编译器版本构建——当某个特定编译器版本被发现存在漏洞、需要审计受影响的制品时,这一点很重要。

compose provider 将相同的来源键作为服务标签写入,terraform provider 将其作为来源文件写入它组装的每个模块,cloudformation provider 则将其写在每个资源的 Metadata 下;每次编译都会产生内存中的来源记录。

6. 元数据与注解作为扩展面

Go 编译器与领域特定概念无关——AI 框架、数据库引擎、Kubernetes 惯用法——只针对 IR 执行扁平的图级操作。为了在不把领域特定逻辑硬编码进 Go 二进制文件的前提下驱动生态系统,平台使用标准的元数据标签和注解作为领域智能的扩展面。

编译器不读取任何领域特定的注解。它将开发者提供的所有注解和鸭子类型标签打包进扁平的 IR 图,并将这些元数据原样传递给治理插件和渲染插件。WebAssembly 生态系统解释这些元数据并执行所需逻辑——评估合规策略、向云原生制品注入标签或触发 feature 展开——与核心编译器相互独立。

这样既保持了宽广的扩展面(任何人都可以编写读取新注解前缀的 Wasm 插件),又保持了核心编译器的稳定:生态系统添加新的领域特定注解无需发布新的核心版本。

策略能读取到附加项的哪些信息

评估 IR 图的裁决角色会收到完整的图(作者声明为敏感的每个值都会被隐去,详见下文),其中包括每个节点携带的每个附加项,以作者为其指定的名称为键;对于写在节点某个连接上的附加项,则以该连接的别名和槽位用点号连接作为键。之所以携带附加项的详细信息而非摘要,是因为 Aggrega 没有可供概括的立场:编译器路由附加项时不评判其内容,因此策略评判它们所需的事实,正是策略被提供的事实。

对每个附加项,图中携带:

  • 它请求的 Feature 类型,以及为其解析出的目录版本。 类型即作者所写的字符串,原样保留:固定版本的引用与不带版本的引用指向同一对象,却是不同的字符串,因此比较类型的策略应预期两种写法都可能出现。
  • 所附加 Feature 的目录标签,原样保留。 不过滤、不规范化,按目录实体声明的顺序排列。策略读取到的正是目录作者所写的内容,包括作者自创、Aggrega 并不知晓的标签。
  • 所附加 Feature 的目录注解,原样保留。 即该 Feature 实体自身的 metadata.annotations,携带方式与其标签完全相同:不过滤、不规范化,按实体声明的顺序排列,因此作者自有命名空间中的注解键会按原样到达。这与最初促成某个注解展开附加项产生的那个注解是两回事:图会单独报告该来源,而写在 features: 块中的附加项携带实体的注解,但完全不报告展开来源。
  • 它填充了哪个已声明的附加槽位。 featuresSchema 槽位通过以槽位名称附加 Feature 来填充,因此命名了其 Component 所声明槽位的附加项会报告该槽位的名称,未填充任何槽位的附加项则报告 free。写在连接上的附加项填充该连接的 socket 所声明的槽位,并报告该槽位的名称;由于 socket 不接受其他名称,它永远不会报告 free。该值是槽位名称而非一个标志,因为填充了哪个绑定点通常是答案中更有用的那一半。
  • 它写在哪个连接上(如有)。 写在组件某个连接上的附加项携带该连接的 socket 和别名,它们指明附加项所呈现于的图边,并通过这条边指明它所呈现给的组件。组件自身块中的附加项则不携带这些信息。连接以数据形式携带,而不是留待从附加项名称中读出,因为名称中包含的是别名而非 socket。
  • 它是否处理作者声明为敏感的材料,以及其哪些交付键携带该材料。两者都由声明推导而来:Feature schema 上的 sensitive 叶节点,或消费方 Component 上的 sensitive 槽位(无论是它为自身附加项声明的槽位,还是连接所经由的 socket 上的槽位),而从不通过检查值得出。
  • 它的 values、infra 及其交付映射,以及该附加项是写在 features: 块中,还是由注解驱动的展开所贡献;其中作者声明为敏感的每个值都会被隐去,如下一段所述。

策略会被告知声明为敏感的材料在哪里,但永远不会拿到材料本身。 图中标记为声明敏感的每个叶节点(无论位于任何附加项的 values 或 infra 中、写在何种作用域或连接上,还是位于边界附加项的 infra 中、节点自身的 values 和 infra 中,或连接自身的 values 和 infra 中)都会以单键标记 {"aggrega_withheld": "declared"} 代替其值到达策略。键得以保留,因此策略仍能看到负载携带哪些叶节点;标记这些叶节点的声明也得以保留,因此策略仍能看到其中哪些携带声明材料;上面列出的每项事实照常到达,未被任何声明标记的每个值也一样。策略据以推理的事实(附加项是什么、填充什么、呈现给谁、其目录实体对它的描述,以及其机密材料流向何处)都不是作者能声明为敏感的值,而材料本身恰恰是策略评判其去向时唯一不需要的东西。这与命令行打印图、守护进程响应编辑器的图请求时所做的隐去相同。那些界面会在有人明确要求时把值交还给这个人;策略的副本不提供这种请求。隐去只作用于策略的副本:构建据以渲染的图不受影响,因此渲染出的字节不会有任何变化。

附加项的标签只在一处约束编译器,而且那并非策略决策:槽位可以声明 selector,标签不满足它的填充会使构建停止。过了这道关,标签不再左右任何事情:无论 Feature 携带哪些标签,值的路由和交付方式都相同。因此,读取标签的策略读取的是编译器未加解释而携带的元数据,而不是在事后揣测编译器内部的某个分支。

Feature 的目录注解在任何地方都不约束编译器:编译器的任何行为都不依据它们分支,槽位也不像对标签那样对它们声明约束。它们只是被携带,仅此而已。

由此可以编写的规则(编译器不会替你制定其中任何一条):

  • 禁止自由形式的附加。 要求每个附加项都填充已声明绑定点的环境,可拒绝任何报告 free 的附加项。这是附加界面保持开放的对应面:组合默认是自由的,不希望它自由的运维人员需明确表态。
  • 拒绝按值交付敏感材料。 当声明为敏感的数据以字面量形式经由交付键传递时,Aggrega 会发出警告,但从不停止构建:按值传递的凭据系列是有意设计的。希望把该警告变为拒绝的运维人员可在此表达。
  • 自行决定什么算作凭据。 标准库用一个系列标签标记其凭据 Features,读取该标签是推理它们的一种方式。更宽或更窄的判定条件(内部标签、命名规则、一组获批类型)同样可用,因为到达的是标签本身,而不是对标签的裁决。
  • 依据你的目录在自身元数据中记录的任何内容设置关卡。 将评审状态、数据驻留地或归属作为注解记录在其 Feature 实体上的环境,可以要求每个附加项都具备这些注解。以 Aggrega 从未听说过的注解为键的规则,与以其自带键为键的规则效果完全相同,因为注解按原样到达;这也意味着 Feature 和 Component 以同等标准接受评判,各自依据其自身实体声明的目录元数据。
  • 管控组件向谁呈现什么。 写在连接上的凭据指明该连接,而连接的边指明其目标,因此环境可以拒绝向其以自有标签标记的信任区域之外的组件呈现的凭据;这种判断需要连接的两端,仅凭消费方组件上的任何事实都无法提供。

裁决角色只接受或拒绝,从不改写。构建要么原样继续,要么以裁决的消息停止,因此策略无法悄悄地把不合规的图变为合规。

附加项详细信息会到达评估 IR 图的策略。评估渲染产物的策略收到的是这些产物而没有图,这是该输入本身的性质,而不是施加于它的限制:两个阶段回答不同的问题,而附加项拓扑不在渲染输出能回答的问题之列。

用策略语言表达整个体系的规则

上述模式描述了治理挂载的作用;本节讨论企业为此需要编写什么。 一个要陈述五十条规则的平台团队并不想要五十个插件。 它希望规则以内容的形式存在——像其他任何制品一样经过评审、版本化和发布的文件——并由一个挂载的引擎来求值。

这正是挂载到该插座上的策略语言引擎所提供的,编译器内置了两个专为此用途而设的引擎: Rego 引擎和 CEL 引擎。运维人员挂载其中一个,声明它应加载的策略文件,规则即可运行: 无需外部工具链,构建时不获取任何内容,编译器中也没有策略逻辑。 求值在 WebAssembly guest 内进行,所有领域智能都位于那里。

同一个引擎服务于每一种治理角色,因此一个体系只需一个挂载的插件及其若干次挂载, 即可覆盖其全部范围:

  • 评判架构。 挂载在构建图上时,策略会读取编译器持有的每个节点、边和挂载, 以及随之枚举的路由路径,并报告必须终止构建的情况。拓扑不变量、跨边界授权规则 或凭据流规则就位于这里。
  • 评判输出。 挂载在渲染产物上时,策略会读取构建生成的文件——以文本形式, 并在格式已于策略之前解析的情况下以解析后的文档形式——并针对具体结果进行报告。
  • 提供派生元数据。 挂载用于塑造标签时,策略根据 Release 的环境以及节点已声明的内容, 决定构建中的节点携带哪些标签。这就是上文模式 2 所描述的机制,只是规则以策略内容 而非专门构建的插件来表达。
  • 添加开发者未曾输入的能力。 挂载用于注入注解时,策略会向构建中的组件添加注解;若注解的键在 Manifest 中注册了绑定,它就会展开为一个 Feature 挂载,因此企业规则可以为组件提供其所需的包装,而不仅仅是拒绝其缺失。决定可以写入运维人员能在该注解上写入的任何值——一个字符串,或者对于路由多个值的绑定,一个由子键构成的对象——构建读取它的方式与读取写在 Release 中的相同值完全一样。它只能添加:会移除或退出某个注解的值会被拒绝;构建无法路由或所绑定的 Feature 不接受的注入值也会被拒绝,并指出注入它的插件。

规则读取载荷所携带的内容,并在一个命名键下报告其决定:

# Evaluated by a governance verdict role over the assembled graph
package acme.security
import rego.v1
deny contains msg if {
some id, node in input.graph.spec.nodes
node.labels["compliance.aggrega.ai/data-class"] == "restricted"
not node.labels["acme.com/owner"]
msg := sprintf("node %v holds restricted data and declares no owner.", [id])
}

沿图追踪数据的规则会读取载荷枚举的路由。language-reference/examples/policy-data-class-route/ 就是一个端到端的示例:当持有某一类数据的组件沿一条未挂载任何去密级 Feature 的路由到达另一类别的组件时,它会终止构建;而当 Release 将该流量路由经过携带 core/data-masking 的网关时,同一个 Aggregate 会顺利完成。编译器将类别标签作为字符串携带,不做任何排序——类别、它们的顺序以及哪些 Features 算作去密级,都是挂载的设置。该规则为三个引擎各写了一次——编译进 CLI 的两个引擎,以及参考适配器 guest 背后的 OPA——每份副本各自独立,因此两个引擎意见不一的构建会显示出这一分歧。

策略自身的词汇得以保留。 插座所处理的严重级别是一个封闭集合, 但策略用来归集其决定的名称属于策略本身。默认名称是 Rego 语料库已在使用的约定名称, 若运维人员的策略以不同方式命名其决定,可在挂载的设置中声明映射——因此已维护 策略库的体系无需重写即可采用该插座。该映射由插件为其设置声明的 schema 进行类型约束, 因此格式错误的映射会在任何策略运行之前终止构建,而不会错误路由某个裁决。

整个策略库作为一次挂载传递。 策略集可以逐个文件挂载,也可以作为一个同时携带 策略文件和数据文档的单一归档挂载,由 guest 打开。无法读取的归档会如实报告, 并指明该文件——绝不会被报告为未得出任何决定的策略集,因为“库无法读取” 绝不能与“库允许了构建”无法区分。

无法求值的策略会终止构建。 当策略无法求值时,挂载失败,构建以指明该插件的故障终止, 这有意区别于终止构建的裁决。两种情况不得混淆,且两者都不是放行。

完整的编写接口——每种角色暴露的载荷、决定键、到严重级别的映射,以及如何挂载归档——见 language-reference/plugins/policy-socket.md。

继承与发布纪律

通过 extends: 实现的继承是一种目录机制,让平台架构师能够在共享基线之上构建专门化的子实体。两种目录类型在数据支柱上各行其道。Feature 的父 schema 与子 schema 在工作区加载时组合,生成带有逐叶来源信息的统一 schema。进行扩展的 Component 不编写任何支柱内容:它写入字面标记 schema: inherited,并在继承链的每一层都原样接收其基础实体所编写的 schema: 块。

这正解决了共享基线所引出的治理问题:子实体相对于其基础实体可以声明哪些约束。对 Component 而言,答案是结构性的,而非靠监管:子实体声明的契约本身就是基础实体的契约,因此子实体无法放宽、删除或更改基础实体约束的类型,也无需发布时检查来保持基线完整。确有需要比基础实体声明更严格规则的子实体,可在其 assertions: 块中添加条目来表达,这些条目与基础实体的规则并列组合,而不是替换它们。

子 Component 确实会组合的是结构:其挂接槽(featuresSchema)、拓扑插座(usesSchema)、自注入允许列表(inject)和具名 assertions 都沿继承链合并,重新声明的条目会直接替换基础实体的条目。

规则放置:哪些规则放在策略插件中,哪些放在各 Component 的 schema 中

发布纪律插件承载适用于整个目录的横切规则:供应链规则(例如,“每个 Recipe 都必须 implements: 目录中存在的一个 Component”)、企业合规规则(例如,“每个带有 compliance.aggrega.ai/scope: pci-dss 的 Component 都必须 extends: 企业 pci 基线”)。这些规则跨越多个实体,将工作区作为一个整体进行评估,或在发布时而非构建时强制执行约定。

各 Component / 各 Feature 的 schema: 声明承载逐实体约束:逐字段的类型、范围、模式、枚举;以及在专用的 assertions: 块中表达的跨字段规则。这些约束局限于单个实体,并随实体在目录中流转。

这种划分并非随意。像“每个必填字段都必须存在”这样的规则是逐实体约束,应放在 required: 数组中。像“每个扩展 pci-dss 父实体的子实体都必须声明一个工作区级治理标签”这样的规则是跨实体规则,由策略插件强制执行。这两类规则从不重叠,因为它们回答的是不同的问题:schema 验证“此实例是否符合其契约”;策略插件验证“此目录是否满足工作区要求的横切规则”。

编写新的治理规则时,放置问题在于:该规则是否仅依赖单个实体的内容(→ schema 或 assertions 块),还是依赖多个实体之间的关系或工作区级配置(→ 策略插件)。Wasm 检查器模式是处理横切情形的标准机制;企业目录可以分发自定义策略插件,这些插件使用与标准发布纪律插件相同的插件契约接口。

注解前缀规范

注解命名空间承载来源语义——不同的前缀表示不同的受众和不同的治理权限。目录作者、企业平台团队以及 Aggrega 平台本身都向同一个扁平字典中编写注解;正是前缀使这些受众保持区分。

前缀来源受众可变性
aggrega.ai/(裸前缀)保留:仅由 Aggrega 编译器生成内部工具、来源标记用户不可编写;在用户内容中声明的裸前缀注解会在发布时被拒绝
<sub-domain>.aggrega.ai/(例如 component.aggrega.ai/、feature.aggrega.ai/、compliance.aggrega.ai/)目录约定编写目录实体的架构师;使用这些标签的 Wasm 策略插件目录发布者编写;使用者读取
<enterprise-domain>/(例如 acme.com/、my-org.io/)企业覆盖层企业平台团队;企业 Wasm 插件企业作者编写;平台编译器将其视为不透明元数据而忽略
<community-domain>/(例如 cncf.io/、kubernetes.io/)外部生态系统读取知名标签的跨生态系统工具由社区治理

裸 aggrega.ai/ 前缀承载最严格的规范:它仅保留给平台生成的注解。编译器会在渲染输出上生成 aggrega.ai/compiler-version、aggrega.ai/component-id、aggrega.ai/recipe-uri、aggrega.ai/boundary-path 以及相关的来源键;直接声明 aggrega.ai/<key> 注解的用户内容会在发布时被拒绝。该规范防止用户编写的注解与平台生成的来源信息发生冲突。

<sub-domain>.aggrega.ai/ 下的子域前缀是目录约定空间。标准库使用 component.aggrega.ai/type(云原生本体标签)、feature.aggrega.ai/kind(运维类与凭据类 Feature 的划分)、compliance.aggrega.ai/*(合规维度标签)以及类似的限定子命名空间。每个子域由特定的目录受众治理:component.aggrega.ai/* 由 Component 实体作者治理,feature.aggrega.ai/* 由 Feature 实体作者治理,compliance.aggrega.ai/* 由合规策略受众治理。跨子域读取(一个 Wasm 插件从多个子命名空间读取)是允许的,但很少见;每个插件通常只限定于一个子命名空间。

企业域前缀(acme.com/...、my-org.io/...)是平台扩展面。Aggrega 编译器将其视为不透明元数据;由企业 Wasm 插件使用。企业可以编写任何适合其治理的前缀结构——扁平式(acme.com/owner: team-payments)、子域式(security.acme.com/scope: pii)或层级式(org.acme.com/billing-center: finance)。平台不限制企业前缀的布局;唯一的规则是企业前缀不得与 aggrega.ai/ 或其子域冲突。

这一规范之所以重要,是因为注解会级联——在 Aggregate 的子系统上编写的注解会传播到该子系统中的每个组件,组件实例自身的注解会覆盖其子系统的注解,模块的注解会到达该模块自身的组件;Release 边界上的注解会传播到该边界中的每个组件。提供程序注解可从任一侧到达渲染输出,若两侧写入同一个键,则采用 Release 的值。没有前缀规范,Aggregate 一侧的注解可能会悄无声息地覆盖平台生成的来源键,企业注解也可能与目录约定键发生冲突。前缀表使受众明确,并使防冲突规则可以在发布时强制执行。

有关按实体列举的注解面以及三桶级联语义(.context.annotations.release / .context.annotations.catalog / .context.annotations.aggregate),参见 language-reference/vocabulary/labels-and-annotations.md。