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

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 助手替你构建。

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

Terminal window
aggrega scaffold --example workload-library-import

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

Terminal window
cd workload-library-import

构建

Terminal window
aggrega pull --release release.yaml # pins BaseWorkloads in release.lock
aggrega 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/ 目录树。两者完全一致:库引用解析为相同的模板文本, 并在相同的渲染上下文中求值,因此导入只是对编写层面的重构,不会影响渲染出的字节。