Workload 库导入——通过 `$import` 共享 Workload 主体
一个无状态 Web 服务,其 Recipe 从共享库条目而不是内联主体合成其 Kubernetes Workload。
这是 Recipe 上 spec.workload 的第三种编写模式:
- **模式 1(内联):**直接写在 Recipe 中的 Go 模板 Workload。
- 模式 2(文件导入):
$import: ./relative/path.yaml——一个本地文件。 - 模式 3(库导入):
$import: <Library>#/workloads/<Entry>—— 一个通过裸名称标识引用的WorkloadLibrary条目。
这里的 web-service Recipe 使用模式 3:
spec: capability: helm implements: example/compute/web-service workload: $import: BaseWorkloads#/workloads/StatelessService将引用写成一个连续的标记:从库名称到片段,其中任何位置都不能有空格或换行。
带有空白字符的引用会被拒绝而不是被裁剪,构建随即中止——参见
errors/fatal-halts.md “A reference to a library
entry carries whitespace(对库条目的引用带有空白字符)”。
BaseWorkloads 是发布在 hub 目录中的一个 WorkloadLibrary
(workloadlibrary/base-workloads)。其 StatelessService 条目是一个 Go 模板,
在此 Recipe 的渲染上下文中求值,因此 .values.image(来自
Component/Aggregate)和 .infra.*(副本数、端口、计算资源——来自 Release)
会像流入内联主体一样流入其中。将 Workload 提取到库中不会改变部署的内容:渲染输出与等效的内联 Workload 逐字节相同。
库的版本由每个 Release 的锁文件提供——引用中不出现任何注册表主机。
执行 aggrega pull 时,BaseWorkloads 被固定在锁文件的 workload_libraries 部分;执行 aggrega build 时,解析已固定的库并渲染其条目。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example workload-library-import然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd workload-library-import构建
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yaml目录解析自 .aggrega-config.yaml 中指定的 hub 注册表(提供 BaseWorkloads 和 helm provider),以及本示例的本地 catalog/(web-service Component 和 Recipe)。Manifests 输出到 dist/app/helm/ 下——即边界的 directory: 后跟 provider 能力。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
仅使用 Aggrega 工具,不要自行创建任何文件夹。如果工作区文件夹中还没有 `workload-library-import` 文件夹,请调用一次 `scaffold` 工具,将 `example` 设为 `workload-library-import`,且不设 `dir`:它会把示例写入新的 `workload-library-import` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `workload-library-import`,`release` 设为 `release.yaml`,`auto_pull` 设为 true,`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `workload-library-import/dist/` 下。验证逐字节相同的说法
将 Recipe 的 workload: { $import: … } 替换为逐字包含 StatelessService 主体的 workload: | 块,
重新构建,并对比两个 dist/ 目录树。两者完全一致:库引用解析为相同的模板文本,
并在相同的渲染上下文中求值,因此导入只是对编写层面的重构,不会影响渲染出的字节。