数据模型
本页讲解一个概念,即谁编写关于组件的哪些数据,它不是一个可运行的工作区。一个契约,三种实现在一个由你构建的工作区中展示了这一点;用以下命令将其写入你自己的文件夹:
aggrega scaffold --example postgres-three-realizations然后它会打印接下来要运行的命令:
cd postgres-three-realizationsaggrega build --release release-selfhosted.yaml --auto-pullaggrega build --release release-managed.yaml --auto-pullaggrega build --release release-managed-dns.yaml --auto-pullaggrega build --release release-external.yaml --auto-pullvalues 与 infra:两个命名空间,两位作者
一个 Component 声明两组独立的设置。它的 values 属于开发者,写在 Aggregate 中:应用所需的内容,在每个环境中都相同。它的 infra 属于运维人员,写在 Release 中:规格和放置位置,因环境而异。schema 将两者分开——Aggregate schema 在组件上没有 infra,Release schema 没有 values——因此任何一位作者都无法设置另一位的字段。Recipe 以两个独立对象 .values 和 .infra 接收两者。
在示例中,开发者命名了数据库及其登录角色,取自 aggregate.yaml:
spec: components: db: type: core/datastore/postgres values: database: appdb user: appuser而构建托管实例的 Release 为其设定规格,取自 release-managed.yaml,省略了注释:
spec: boundaries: stack: directory: stack components: db: infra: engine_version: "16" storage: size: 100Gi type: gp3 ha: enabled: true read_replicas: 0示例中的另外两个 Releases 分别在集群中、以及针对一个已存在的服务器构建同一个 Aggregate,各自带有自己的 infra;Aggregate 不变。
仍应随环境变化的值会被提升:Aggregate 声明一个参数,将其写入值中,再由每个 Release 满足该参数(参见构建的文件)。
基于另一个 Release 构建的 Release
Release 可以用 extends: 将另一个 Release 指定为其基础,并只修改不同之处。子项继承基础的边界、放置位置和参数,而在 extends: 旁声明 aggregate: 会被 Release schema 拒绝,因为子项必须构建与其基础相同的 Aggregate。它可以指定自己的 Manifest,也可以省略 manifest: 并继承基础的 Manifest。
# release-prod.yaml: the base gives every other settingspec: extends: ./release-base.yaml boundaries: stack: components: db: infra: storage: size: 500Gi边界的 directory: 与其他任何设置一样被继承,因此继承了字面目录的子项会渲染到与其基础相同的位置。将目录写成依赖某个参数,才能让每个 Release 的输出各自去往不同的位置;参见组合 Release 与 extends 继承。
基于另一个 Manifest 构建的 Manifest
Manifest 可以用同样的方式扩展另一个 Manifest,其条目会替换基础中相同键的条目。开发用的 Manifest 可以保留生产用 Manifest 的所有绑定,并改变凭据的实现方式:这里,core/referenced-secret 附件在生产环境中从密钥存储中获取,而在开发环境中根据作者提供的值写入一个 Secret。
spec: mappings: components: type: core/datastore/postgres:1.0.0: helm/postgres:1.0.0 features: type: core/referenced-secret:1.0.0: helm/k8s-external-secret:1.0.0---# manifest-dev.yamlspec: extends: ./manifest-prod.yaml mappings: features: type: core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.0两种实现以相同方式发布 Secret 的名称,因此读取该凭据的组件在任一 Manifest 下都会渲染出相同的引用;一种开发者意图,两种凭据交付形式构建两者并进行比较。
两个标签:类型与类别
每个 Component 在保留标签 component.aggrega.ai/type 上携带一个来自封闭集合的值:server,长期运行的端点;worker,后台消费者;stateful-server,保存自身持久数据的组件;task,运行至完成;function,事件驱动的函数;以及 resource,不运行自身计算的托管云资源。该值位于目录实体上,绝不在 Aggregate 中的实例上。
类型说明的是基础设施必须如何对待一个组件,而不是该组件的用途。持有自身磁盘的消息代理是 stateful-server,与数据库完全一样:core/messaging/kafka 和 core/datastore/postgres 带有相同的类型。读者浏览所依据的是另一个标签 component.aggrega.ai/category——代理为 messaging,数据库为 datastore——它同时也是该实体在目录中所在的文件夹。针对一个标签编写的选择器永远不会匹配另一个标签。