角色
Aggrega 的编写面划分为四个相互协作的角色。每个角色有各自的关注点、各自的变更节奏,以及各自通常编写的一组实体类型。弄清楚你当前扮演的是哪个角色,就能知道该打开哪个文件、该填写哪些支柱。
这种划分是指导,而非编译器强制执行的规则。核心编译器在数学意义上不预设立场:它接受任何通过 schema 校验的编写模式。你可以自由地合并角色——独立作者通常身兼四职——也可以在情况需要时跨越边界。这些角色的存在是为了降低认知负担、厘清关注点,而不是为了筑起一座牢笼。关于这种分离的架构论述,请参阅团队拓扑与四个领域。
四个角色
开发者
应用意图
Aggregate
平台架构师
目录契约
Components
Features
平台运维
基础设施配方
Recipes
FeatureRecipes
Plugins
用于按提供方渲染
平台操作员
按环境的连接
Manifests
Releases
通常由谁编写哪些文件。这种分工是指导,而不是编译器强制执行的规则:在小团队或个人项目中,一个人编写全部文件。
开发者——应用意图
开发者编写 Aggregate:以意图的形式表达应用是什么、需要什么。开发者说的是“我需要一个这种规模的数据库,以及一个使用它的服务”,而不是“在这个子网中预配一个 AWS RDS 实例”。物理基础设施被有意留给目录和运维,因此 Aggregate 保持与能力无关——同一份意图可以针对笔记本电脑、云或企业集群进行编译,而开发者的文件无需改动。
开发者负责的内容:Aggregate 声明的组件、它提供的 values、其行为属于应用意图的 Features(及其 values)、它为按环境变化而暴露的 parameters,以及将组件连接在一起的 uses 边。
平台架构师——目录契约
架构师编写 Components 和 Features:供开发者使用的可复用、带版本的契约。一个 Component 声明开发者可以提供的值(以 JSON Schema 形式)、它向使用方提供的输出,以及它为连接而暴露的插槽。一个 Feature 声明一种可附加的能力。架构师铺设“铺好的路”——开发者从中下单的自动售货机——并保证它所提供的东西结构良好。
架构师负责的内容:校验开发者值的 schema:、provides 输出、usesSchema 插槽,以及承载语义标识的标签。架构师不编写物理基础设施;他们定义通往物理基础设施的接口。
平台运维——基础设施配方
运维编写 Recipes、FeatureRecipes 以及用于 provider 渲染的 Plugins:这些特定于 provider 的转换将目录契约变为渲染后的基础设施。一个 Recipe 将 Component 声明的值映射到具体的 provider——Helm、Docker Compose、Terraform——而不改变该 Component 声明的面向开发者的值。一个 FeatureRecipe 在绑定时对 Feature 做同样的事。
运维负责的内容:根据开发者的 values 和操作员的 infra 规格渲染 provider 原生输出的模板,以及 Recipe 传递给使用方的 provides 值。运维工程师通过将现有基础设施代码打包为 Recipes 来复用它们;他们从不需要学习某种目录专用的策略语言。
平台操作员——部署连接
操作员编写 Manifests 和 Releases:路由层以及按环境的编译输入。一个 Manifest 告诉编译器对于给定目标由哪个 Recipe 实现每个 Component,从而同一个 Aggregate 可以在不同环境中命中不同的实现。一个 Release 是唯一的编译输入——它指向 Aggregate 和 Manifest,满足开发者暴露的参数,附加其输入属于运维层面的 Features,用 infra 为开发者附加的那些 Features 设定规格,并在架构师声明的插槽范围内连接它自己的边。
操作员负责的内容:Manifest 的路由映射、Release 的参数满足、每个组件获得的 infra 规格、其输入属于运维层面的 Features 的附加,以及 Release 在连接上编写的按边 infra。操作员满足开发者暴露的变化点;Release 不能引入新的应用值或新的计算资源——这些只能来自 Aggregate。
角色是帽子,而非人头
在大型企业中,这四个角色是不同的部门,拥有不同的专长和不同的变更频率——目录在平台团队发布新能力时演进,Recipes 在基础设施变更时演进,Releases 随每次部署而变化。在小团队或个人项目中,一个人戴着所有的帽子。由于 Components 和 Recipes 是可共享、带版本的制品,作者往往可以完全停留在开发者角色中,其余一切都使用预先构建好的目录。
接下来请阅读按角色划分的实体,了解完整的类型到角色映射,包括支持全部四个角色的库类型和插件类型。