本页面由机器翻译。阅读英文原文。
Providers 概述
提供程序(provider)将 Recipe 的输入种类渲染为提供程序原生的清单文件。Provider 渲染由 pluginType: provider 的 Plugin 提供:该 Plugin 在 spec.provider.capabilities 中列出它所渲染的提供程序名称,并在同一个 spec.provider 块中携带其提供程序插槽元数据。Aggrega 的标准库附带五个提供程序——helm、helm-chart、compose、terraform、cloudformation——每个提供程序都声明了自己的契约:它接受哪些输入种类、输出哪些文件、使用哪些边界注解,以及在使用合成输入种类时 Workload 种类如何转换为其原生形态。本组章节从 Recipe 作者的角度介绍这些契约。
本章分为两组。架构与共享契约介绍所有 provider 的共同之处——将 Go 编译器与 Wasm provider 插件绑定的插件插槽架构、每个 provider 读取以配置部署位置和网络的边界注解,以及引导你找到相应 provider 页面的索引。各 provider 参考介绍具体细节:各 provider 的编写特性、各 provider 的输出目录布局,以及各 provider 对 Workload 和 artifacts 机制的转换语义。哪个 provider 接受哪种输入类型,由 ../architecture/16-recipe-input-composition.md 中的能力矩阵给出,它是权威对照表。
架构与共享契约
- Provider 架构——插件插槽架构、负责 provider 渲染的 Plugin 在编译流水线中的作用,以及按 provider 的分派。
- 常用注解——平台保留的
aggrega.ai/边界注解,provider 读取它们以获取部署位置、镜像仓库前缀、网络、安全和打包元数据。 - Provider 参考索引——每个标准库 provider 生成什么,以及哪个页面回答哪个问题。关于 provider 接受哪些输入类型,请阅读 ../architecture/16-recipe-input-composition.md 中的能力矩阵。
各 provider 参考
helm——核心 Kubernetes provider。以 sourced 模式使用 Helm SDK 渲染。helm-chart——umbrella chart 组合 provider。将多个组件打包为每个边界一个 Helm chart。compose——Docker Compose provider。按边界输出docker-compose.yaml。terraform——Terraform provider。每个边界一个根配置,其中每个组件是一个 module 块,引用该组件自己的子目录。cloudformation——CloudFormation provider。每个边界一个 stack 模板,以纯 JSON 输出。