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

组合

本页解释一个概念,即用比单个组件更大的部分构建应用,它不是一个可运行的工作区。模块边界路由——将整个子模块放入边界在一个由你构建的工作区中展示了这一点;用以下命令将其写入你自己的文件夹:

Terminal window
aggrega scaffold --example module-boundary-routing

然后它会打印接下来要运行的命令:

Terminal window
cd module-boundary-routing
aggrega 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: 块。