按实例覆盖 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 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example per-instance-recipe-override然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd per-instance-recipe-override构建
aggrega pull --release release.yaml # writes release.lock, which the build readsaggrega 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 实现的类型必须通过映射消除歧义;若未映射,构建会停止并列出候选项,而不会自行猜测。