本页面由机器翻译。阅读英文原文。
Provider 参考索引
Aggrega 的标准库 provider 各自接受三种 Recipe 输入类型(sourced、synthesized、artifacts)的不同子集。权威的能力矩阵位于 ../../architecture/16-recipe-input-composition.md 的“Provider Capability Matrix”一节。请阅读该节以查看权威表格,并阅读其下针对各 provider 的说明,了解每个 provider 接受哪些输入类型的组合:表格只能单独说明每种类型,无法表达其中两种可以同时声明。
本页是一个指引。它说明每个标准库 provider 产出什么,并引导你前往介绍它的页面;provider 接受哪些输入类型以及以何种组合接受,由上面链接的章节解答。
标准库 provider
helm— 产出扁平的 Kubernetes manifest。参见 helm.md。helm-chart— 将一个边界的 component 打包为单个伞形 Helm chart。参见 helm-chart.md。compose— 产出 Docker Compose 服务,每个边界合并为一个 compose 文件。参见 compose.md。terraform— 产出 Terraform 配置。它只输出配置,从不运行 Terraform。参见 terraform.md。cloudformation— 产出 CloudFormation 栈模板,每个边界一个。它只输出配置,从不运行 CloudFormation。参见 cloudformation.md。
边界的 syncWave 在各 provider 上的作用
每个标准库 provider 都会读取 Release 边界的 syncWave: 值,而它排序的对象及其含义因 provider 而异;在 helm-chart 上,它只对带有其注解的资源排序:
| Provider | wave 的作用 |
|---|---|
helm | 对 GitOps 控制器或 Helm 应用的资源进行排序。当 wave 不为 0 时,每个渲染出的资源都带有 argocd.argoproj.io/sync-wave,由 chart 模板生成的 hook 资源还额外带有 helm.sh/hook-weight。 |
helm-chart | 对带有该注解的资源进行排序。源 chart 的模板按其作者编写的样子复制,因此只有在 chart 写入 argocd.argoproj.io/sync-wave 的地方才带有它;provider 添加的、经 $import: 加载的 artifact 带有它,但不带 helm.sh/hook-weight——参见 helm-chart.md。 |
compose | 通过服务之间的 depends_on,对边界渲染到的 compose 文件内部的服务进行排序,并额外将该值作为 aggrega.ai/sync-wave 标签记录在每个输出的服务上。无法表达跨两个 compose 文件的排序,参见 compose.md。 |
terraform | 通过 boundary 所组装进的根配置中各 module 块之间的 depends_on,对这些块进行排序。这是 Terraform 执行其操作的顺序,而非就绪状态——配置中没有资源可用的概念——并且不承诺任何销毁顺序。跨两个根配置的排序无法表达,该值还会随节点的构建来源一并记录——参见 terraform.md。 |
cloudformation | 通过资源之间的 DependsOn,对边界组装到的栈的预配进行排序。这是创建顺序(反向即删除顺序),而非就绪状态:栈模板中没有资源可用的概念。无法表达跨两个栈的排序,参见 cloudformation.md。 |
如何为每个边界编写 syncWave:,见 Release 实体页面;各 provider 输出的确切标签和注解见 well-known-annotations.md。
查找指南
| 如果你想了解…… | 请查看 |
|---|---|
| 哪个 provider 支持哪种输入类型 | ../../architecture/16-recipe-input-composition.md 的 Provider Capability Matrix 一节 |
| provider 接受哪些输入类型的组合,以及拒绝时输出什么 | ../../architecture/16-recipe-input-composition.md 的“What each provider accepts, in full” |
| provider 的插件插槽如何接收输入并返回输出 | architecture.md |
| 各 provider 的编写结构(chart 结构、compose 顶层键、Terraform 主体、CloudFormation 片段) | 对应的各 provider 页面(helm.md、helm-chart.md、compose.md、terraform.md、cloudformation.md) |
| 每个 provider 读取哪些边界注解及其默认值 | well-known-annotations.md |
边界的 syncWave 在各 provider 上的作用 | 上表 |
| provider 是否报告它为所渲染资源指定的名称,以及不报告时应查看什么 | ../templates/rendered-resource-names.md |
| Workload 类型的编写接口 | ../entities/workload.md |
| 三种输入类型组合模型的概念 | ../../architecture/16-recipe-input-composition.md |