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

按实例覆盖 recipe

本示例讲解 Manifest 的一项功能:name 映射层级,它为单个组件实例覆盖 Recipe,而同一类型的其他所有实例仍使用批量的 type 层级 Recipe。

示例内容

该 Aggregate 声明了同一组件类型(example/compute/greeter)的两个实例:

components:
greeter-default:
type: example/compute/greeter
greeter-special:
type: example/compute/greeter

目录提供两个都实现 example/compute/greeter 的 Recipes:greeter-blue(默认构建)和 greeter-green(替代构建)。该 Manifest 按类型批量映射,并按名称覆盖其中一个实例:

mappings:
components:
type:
example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 # every greeter instance...
name:
greeter-special: compose/greeter-green:1.0.0 # ...except this one

名称优先于类型,因此 greeter-special 通过 greeter-green 部署,而 greeter-default 通过 greeter-blue 部署。

生成示例

你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。

将示例写入一个以其命名的新文件夹:

Terminal window
aggrega scaffold --example per-instance-recipe-override

然后它会打印接下来要运行的命令。第一条命令进入新文件夹:

Terminal window
cd per-instance-recipe-override

构建

Terminal window
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

本示例使用标准库提供其 provider:compose provider 随标准目录提供。这一覆盖示例自身的演示内容,即 example/compute/greeter 演示组件及其两个 recipe(greeter-blue / greeter-green),仅用于让按实例覆盖的效果可见,它们与标准库实体一起位于共享目录中的 example/ 发布者下。.aggrega-config.yaml 将 hub.aggrega.ai 声明为默认注册表,因此这些实体从 hub 解析,构建命令无需 --catalog 标志。

渲染出的 dist/app/compose/docker-compose.yaml 显示覆盖已生效:greeter-default 运行 image: greeter:blue,greeter-special 运行 image: greeter:green,每个服务的 aggrega.ai/recipe-uri 来源标签都指明了它所解析到的不同 Recipe。

借助 AI 助手

已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。

只使用 Aggrega 工具,不要自己创建任何文件夹。如果 Workspace 文件夹中还没有 `per-instance-recipe-override` 文件夹,就调用一次 `scaffold` 工具,将 `example` 设为 `per-instance-recipe-override`,不设 `dir`:它会把示例写入新的 `per-instance-recipe-override` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `per-instance-recipe-override`,`release` 设为 `release.yaml`,`auto_pull` 设为 true,`write` 设为 true。告诉我这次构建写入了哪些文件;它们位于 `per-instance-recipe-override/dist/` 下。

为什么这很有用

同一组件类型的两个实例有时需要不同的物理实现,例如主数据库使用托管云 Recipe,而其副本使用集群内 Recipe。name 层级在 Manifest 中按实例表达这一点,无需分叉组件类型,也无需复制 Aggregate。由多个 Recipe 实现的类型必须通过映射消除歧义;若未映射,构建会停止并列出候选项,而不会自行猜测。