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

生态系统理念

生态系统理念

Aggrega 的架构遵循在灵活性与可预测性之间取得平衡的核心设计原则。通过保持清晰的边界和标准化的契约,一个本质上通用的编译器可以无缝编排从标准云原生基础设施到高度专业化的 AI 智能的一切。

1. 核心机制:架构的物理学

  • 关注点分离(康威定律):开发人员不编写物理基础设施代码,运维(Ops)也不硬编码应用逻辑。架构的指导原则把编写工作划分为领域驱动(Domain-Driven)的边界,而编译器并不强制这种分离(参见不变量 7)。
  • 延迟绑定(依赖倒置):开发人员请求的是抽象接口(例如 type: enterprise-agent),而不是具体实现(例如 helm-chart-v2)。Manifest 在编译时将接口解析为正确的实现,从而支持从单一源文件进行真正的多目标部署。
  • AOT 纯粹性(不实时获取云端数据):编译器与实时云环境无关。它在编译期间从不向基础设施 API 进行身份验证,也从不获取实时 IP 地址。它完全基于控制反转运行:映射确定性指针,并提前传递抽象的注入契约,使运行时环境能够安全地解析最终的物理连接。

2. 开发者体验:意图与抽象

  • 语义化的开发者体验(5 关键字映射标准):为避免认知摩擦,开发人员在基于映射的 YAML 拓扑中恰好使用五个普遍易懂的关键字:
    1. parameters:全局环境契约(例如传递动态磁盘大小)。
    2. values:核心的认知/业务逻辑载荷(归开发人员所有)。
    3. uses:显式声明的网络边和依赖(归开发人员所有)。
    4. infra:物理占用和机械规格(归运维所有,禁止出现在 Aggregate 中)。
    5. inject:严格的交付契约,将本地变量映射到目标的 provides 键(env、file、arg)。该机制是可扩展的。
  • 与能力无关的术语:为防止底层基础设施的现实(例如 Kubernetes 术语 namespace)渗入开发者体验,平台使用 boundaries 等通用概念。
  • 显式意图与“响亮的护栏”(没有幽灵基础设施):编译器绝不能凭空创造开发人员未显式声明的计算资源或功能。使用策略引擎静默注入安全代理会产生“幽灵基础设施”——一旦出故障,开发人员最终要去调试一个在其 YAML 中根本不存在的代理。Wasm 策略插件不会静默改变架构,而是严格充当响亮的护栏。如果某个拓扑违反安全要求,编译器会中止构建并返回一个非常具体的错误(例如 “错误:PII 数据正通过 AI 网关 router 流向模型提供方。你必须显式为其附加 core/data-masking 功能”),迫使开发人员修正自己的单一事实来源。

3. 不预设立场的编译器:处理与编排

  • 可编程策略(不预设立场的编译器):核心 Go 编译器是一种对内容保持中立的计算机制。它解析 YAML、遍历图并计算标签交集。真正的“智能”(例如,强制要求携带受限数据的模型流量必须经过一个会屏蔽敏感文本的 AI 网关)由企业通过可插拔的 WebAssembly (Wasm) 套接字动态编程实现,这些套接字用于抽象语法树 (AST) 变更——即修改解析后在内存中的配置表示——以及策略验证。
  • 模式无关性(开源字典):核心编译器与物理执行层无关。它没有为 Helm、Terraform 或 Docker Compose 硬编码任何模式。相反,Ops Recipe 的 source 块是一个开放字典,其键由 provider 定义,并以 .source.* 的形式提供给该 Recipe 的模板。核心通过内置的 { kind, url, version } 形式解析获取的 source(kind:helm-oci-chart、helm-https-chart、compose-https-fragment、git-repository),这已经使编译器与其所操作的云语言解耦。有关获取模型,请参阅 Recipe 的 source 参考。
  • 显式的 Plugin 编排:核心 Go 编译器严格充当中立的图构建器,从不猜测如何处理节点。所有领域智能都通过专用的 WebAssembly (Wasm) 套接字在两个不同层级上进行显式编排。 1. 全局套接字:企业策略和格式化由显式注册的编译器套接字进行评估(例如用于元数据自动打标签的治理角色 label-transform、用于拓扑安全的治理裁决角色,以及用于最终制品生成的渲染器套接字)。 2. 实现管道:特定于 Component 的变换逻辑由 Manifest 编排;当它将抽象接口解析为具体的 Recipe 时,该实现会显式声明一个按顺序执行的 Wasm 插件 pipeline 数组。编译器只是将与能力无关的中间表示(IR)图送入这些已定义的套接字,确保所有领域特定逻辑都严格地在生态系统中进行版本管理,而不是硬编码在编译器核心中。
  • 扁平编译与 Feature 原子性:Aggrega 不管理状态,不探测端点,也不会等待发布完成。编译器会求值嵌套模块,并将其解析为扁平的一维中间表示(IR)图,然后再把数据交给 Wasm 渲染插件。关键在于,虽然图被扁平化,编译器仍保留 Feature 原子性。如果某个代理功能自主声明了一条通往安全保险库的网络边,编译器会记录该边的语义来源,确保 Wasm 策略引擎能够执行 $O(1)$ 查找,而不会把该连接错误地归属于父组件。最后,为支持时间上的排序,Release 中的每个边界都带有一个 syncWave: <integer> 值;每个渲染插件会将每个边界的波次转换为其目标表达顺序的方式——下游 GitOps 控制器读取的执行顺序注解,或其渲染文件中各服务之间的依赖——而完全没有排序手段的目标只记录该波次,不据此排序。

4. 语义本体:识别与分类

  • 可运维的云原生本体:为确保开源 Wasm 插件与企业策略能够普遍互操作,component.aggrega.ai/type 标签只映射到一个封闭的通用云原语集合(server、worker、task、function、stateful-server、resource)。这是 Aggrega 自有的键:已发布的 Component 模式枚举了它可取的值,带有任何其他值的文档在加载时会被拒绝。集中固定这一词汇,正是为了保证自主策略引擎和社区构建的 Wasm 渲染插件在遇到一个双方作者都没有编写过的 Component 时,对同一形态读到的是同一个词。编译器仍然不会从该字符串推断任何东西:它只是将值与选择器进行匹配,不会自行配置任何资源;封闭集合带来的是:每个人的选择器匹配的都是同一套词汇。
  • 按 Aggrega 未定义的维度分类:封闭集合只涵盖这一个保留键。需要自有分类的目录(如层级、数据区域、服务类别,或对原语更细的划分)会在保留键旁边编写自己的标签键,因为 Component 模式接受任何值为字符串的额外标签键,而所有选择器入口都以相同方式读取它。扩展发生在你自己的键上,而不是在 Aggrega 的键内部,这正是企业词汇得以增长而共享词汇不会漂移的原因。
  • 鸭子类型(通过标签实现语义特征):如果基础类型是纯云原生的,那么所有认知、运维和合规方面的智能都完全通过语义鸭子类型来叠加。由平台架构师(Platform Architect)编写的标签(例如 model.aggrega.ai/capability: generative、compliance.aggrega.ai/data-class: restricted)才是节点的真正身份。Features 会基于这些标签选择器动态绑定到组件。

5. 企业治理:模式与继承

  • 严格的 API 分区与企业可发现性:遵循 Kubernetes 标准,所有载荷定义统一位于 spec: 块中。资源标识、特征标签和显式的编译器指令严格位于 metadata: 块中。为保证严格的解析,每个可共享的 YAML 制品都严格要求一个经正则表达式校验的 SemVer version 字符串。此外,为支持 OCI 注册表中的可发现性和生命周期治理,metadata 块支持一个可选的企业元数据套件。该套件包括 description、结构化的 maintainers 对象数组(name、email、url)、license、repository、home(文档 URL)和 keywords(用于搜索索引)。生命周期结束在文档之外管理:aggrega deprecate 会为已发布的制品附加一个签名的弃用标记——包括严重程度、原因和可选的替代项——而不改变其已发布的字节。

  • 模式可扩展性(Kubernetes CRD 模式):为避免每出现一个新的 AI 或基础设施功能就更新核心编译器的模式,平台使用 JSON Schema 2020-12 来校验配置。平台架构师直接在目录组件的 schema: 块中编写严格的类型、校验逻辑和默认值——通常采用紧凑形式,这是一种 YAML 风格的简写,可将每个字段的约束写在一行中(port: { type: integer, min: 1, max: 65535, default: 8080 }),并在校验运行前编译为 JSON Schema 2020-12。对于需要完整词汇的模式,完整的 JSON Schema YAML 仍是同等地位的编写选项。规模大到足以受益于跨 Component 模式复用的目录,会把常见形态(探针块、资源限制、命名端口形态)提取到专门的 SchemaLibrary 实体中,并通过 JSON Schema 的 $ref: 关键字引用它们。

  • 模式继承(载荷基线):为使基线只需编写一次,平台将继承分为两个不同的层级。标准 YAML 元数据(包括语义标签)、Manifest 映射和 Release 配置采用传统的合并策略,以允许必要的环境覆盖。载荷模式(schema:)不以这种方式合并,两种目录类型在此分道扬镳:Feature 的 schema: 按照 JSON Schema 2020-12 的组合语义与其基础的模式组合,并在工作区加载时由一个带有源位置溯源标记的合并器遍历,使合并后模式中的每个叶节点都带有其来源文件;而一个扩展型 Component 完全不编写载荷内容——它写下字面标记 schema: inherited,并在继承链的任意深度上原样接收其基础所编写的块。因此,Component 的基线是由构造本身而非策略来保证的:子级的契约就是基础的契约,子级没有任何可以放宽的东西。 这样的 Component 所组合的是结构——它的挂接槽、拓扑套接字、自注入允许列表和具名 assertions——而需要比其基础声明的规则更严格规则的子级,会将其表达为一个新增的 assertions: 条目,基础的规则与之并存,而不是被替换。更广泛的拓扑安全和标签治理仍然适当地委托给 Wasm 治理套接字。

  • 接口一致性与自动实现:为避免架构师派生出基础 Component 的略微变体时 Ops 重复编写 Recipe YAML,针对某个基础编写的 Recipe 可服务于扩展它的每个 Component,无论处于继承链的哪一层。扩展的 Component 写入 schema: inherited,因此它不会向 values/infra/provides 添加任何基础的 Recipe 无法消费的根键。Manifest 仍需用一个自己的条目来映射该扩展类型,当被映射的 Recipe 的 implements 指明该类型或其扩展的任一基础时,映射检查即接受该条目(参见针对基础编写的 Recipe 服务于扩展它的一切)。幽灵基础设施追踪器(当所绑定 Recipe 声明的模板都不读取某个已编写的键时发出警告,以防止“幽灵基础设施”)是渲染阶段对应的护栏。

  • implements 版本匹配:Recipes 和 FeatureRecipes 上的 implements 字段支持三种形式,以在严格性与生态系统灵活性之间取得平衡:

    1. 精确版本:implements: "core/api-server:1.0.0"——只匹配 1.0.0。适用于与特定模式版本紧密耦合的 Recipes。
    2. 主版本兼容(SemVer 范围):implements: "core/api-server:^1.0.0"——匹配 >=1.0.0, <2.0.0。专为依赖 Component 的 SemVer 兼容性保证的 Recipes 设计:按照 SemVer,次版本和补丁版本的升级被假定为向后兼容,编译器会检查 Component 的版本是否满足该范围。
    3. 无版本:implements: "core/api-server"——匹配任意版本。适用于真正与版本无关的 Recipes(例如一个只使用 .context.inject.env、不使用任何特定版本 values 字段的通用 worker Recipe)。

    implements 从不选择 Recipe:Manifest 为每种组件类型指定 Recipe,编译器检查被映射的 Recipe 的 implements 是否以三种形式之一接受该类型,不匹配时中止。当某个组件类型没有映射时,编译器也正是根据同一声明来推荐候选 Recipes。

    这种三种形式的模式让 Recipes 能够声明与其对 Component 模式的实际耦合程度相符的版本契约。紧密绑定到特定模式版本的 Recipes 精确固定版本;依赖 Component 的 SemVer 兼容性保证的 Recipes 使用主版本兼容范围;行为完全不依赖 Component 版本的 Recipes 保持无版本。其结果是,Component 的次版本升级不会迫使运维固定 Component 版本,也不会迫使其为每个版本维护并行的 Recipes。