组合
本页解释一个概念,即用比单个组件更大的部分构建应用,它不是一个可运行的工作区。模块边界路由——将整个子模块放入边界在一个由你构建的工作区中展示了这一点;用以下命令将其写入你自己的文件夹:
aggrega scaffold --example module-boundary-routing然后它会打印接下来要运行的命令:
cd module-boundary-routingaggrega build --release release.yaml --auto-pull模块:由另一个 Aggregate 导入的 Aggregate
一个 Aggregate 可以在 aggregates: 下将另一个 Aggregate 作为模块导入。模块组合自己的组件并连接自己的边,因此它的任何内部细节都不会出现在导入它的 Aggregate 中。该示例从标准库目录导入两个模块,摘自 aggregate.yaml:
spec: aggregates: metrics: type: core/thanos documents: type: core/ferretdb模块的 exportedComponents 块是它的公共接口:模块外部的事物可以连接的组件,每个组件以其导出名称出现。core/ferretdb 将其 proxy 组件导出为 mongo,因此导入方 Aggregate 的组件通过点分路径 documents.mongo 访问它:
uses: database: main: target: documents.mongo模块可以声明自己的参数,由导入方 Aggregate 在导入的 parameters: 中提供。
放置模块
Release 通过一个以模块名称为键的 aggregates: 条目将整个模块放入一个边界,模块包含的每个组件都随之一起放置。它还可以配置模块的组件,每个组件使用它在模块内部的名称。摘自 release.yaml,省略了注释:
spec: boundaries: observability: directory: observability annotations: aggrega.ai/namespace: observability aggregates: metrics: components: query: infra: compute: cpu: 500m memory: 1Gi data: directory: data annotations: aggrega.ai/namespace: data aggregates: documents: {}模块自身的注解到达其自身组件的方式,与 Aggregate 的注解到达其自身组件的方式完全相同,因此模块可以将其组件放入它声明的命名空间中。导入方 Aggregate 不声明任何能深入该模块的内容;Release 可以,并且在同一个键上以它的值为准。
构建不预配的服务
一个已经存在的服务器仍然是图中的一个节点:它参与连接、参与策略,也参与其消费方所接收的内容,且不会为它预配任何东西。它的 Manifest 绑定一个不预配任何东西的 Recipe,由 Release 提供地址。在 一份契约,三种实现 中,manifest-external.yaml 这个 Manifest 将 core/datastore/postgres 绑定到 helm/postgres-external,后者只输出一个 ExternalName Service,而 Release 提供地址,摘自 release-external.yaml:
db: infra: overrides: host: postgres.data.example.net地址是一个指针字符串:构建会原样传递它而不解析它,应用运行时在该名称上应答的任何东西,就是应用所访问到的。对于该示例的全部三个 Releases,Aggregate 都是同一个文件。
子系统:在一个 Aggregate 内分组
子系统在 Aggregate 内对组件进行分组。在它上面声明的注解会到达它所包含的每个组件,附加到它的 Feature 也会附加到其中每个组件:
spec: subsystems: billing: annotations: team.aggrega.ai/owner: billing-squad aggrega.ai/namespace: billing features: metrics: type: core/prometheus-exporter components: invoice-api: type: core/compute/server payment-worker: type: core/compute/worker构建会将子系统树展平:invoice-api 和 payment-worker 各自带有 metrics 附加项和两个注解,Recipe 以 {{ index .context.annotations.aggregate "team.aggrega.ai/owner" }} 读取这些注解。aggrega.ai/namespace 是一个提供方注解,因此它还会把这两个组件放入 billing 命名空间。Release 在每个组件的条目下,按子系统为该附加项指定的名称配置其 infra,而 Release 设置的命名空间会对其覆盖的组件覆盖子系统的命名空间。
自行连接到某个目标的附加项
附加项可以带有自己的 uses: 块,从附加项而不是从它所在的组件引出一条边。在 在每个目标上都有备份的数据存储 中,运维人员将 core/backup 附加到数据库,并将该附加项连接到存放备份的存储桶,摘自 release-helm-velero.yaml:
spec: components: db: features: backup: type: core/backup infra: schedule: "30 2 * * *" retention_days: 14 uses: store: bucket: target: backups数据库自身的连接保持不变:指向 backups 的边属于该附加项,被记录为由它引出,并像其他任何边一样接受策略检查。运维类 Feature 和凭据类 Feature 以同样方式附加,二者都可以带有 uses: 块。