Providers の概要
プロバイダは、Recipe の入力種別をプロバイダネイティブのマニフェストファイルにレンダリングします。Provider レンダリングは pluginType: provider を持つ Plugin が担います。この Plugin は、レンダリングするプロバイダ名を spec.provider.capabilities に列挙し、プロバイダソケットのメタデータを同じ spec.provider ブロックに保持します。Aggrega の標準ライブラリは 5 つのプロバイダ(helm、helm-chart、compose、terraform、cloudformation)を同梱しており、それぞれが独自の契約を宣言します。すなわち、どの入力種別を受け付けるか、どの出力ファイルを生成するか、どの境界アノテーションを読み取るか、そして合成された入力種別が使われる場合に Workload 種別がそのネイティブな形にどう変換されるか、です。この章群では、これらの契約を Recipe 作成者の視点から扱います。
この章は 2 つのグループで構成されています。アーキテクチャと共通の契約では、すべてのプロバイダーに共通する内容を扱います。Go コンパイラと Wasm プロバイダープラグインを結び付けるプラグインソケットアーキテクチャ、配置とネットワークを設定するためにすべてのプロバイダーが読み取る境界アノテーション、そして適切なプロバイダー別ページへ案内する索引です。プロバイダー別リファレンスでは個別の内容を扱います。プロバイダーごとの作成上の特性、出力ディレクトリの構成、Workload と成果物の仕組みに関する変換のセマンティクスです。どのプロバイダーがどの入力種別を受け付けるかは、../architecture/16-recipe-input-composition.md の機能マトリクスに記載されており、これが正式な一覧表です。
アーキテクチャと共通の契約
- Provider アーキテクチャ — プラグインソケットアーキテクチャ、コンパイルパイプラインにおけるプロバイダレンダリング用 Plugin の役割、およびプロバイダごとのディスパッチ。
- 既知のアノテーション — プラットフォームで予約された
aggrega.ai/境界アノテーション。プロバイダーはこれを配置、レジストリのプレフィックス、ネットワーク、セキュリティ、パッケージングのメタデータに使用します。 - Provider リファレンス索引 — 標準ライブラリの各プロバイダが何を生成するか、またどのページがどの疑問に答えるか。プロバイダがどの入力種別を受け付けるかについては、../architecture/16-recipe-input-composition.md の機能マトリクスを参照してください。
プロバイダー別リファレンス
helm— 中核となる Kubernetes プロバイダー。sourced モードでの Helm SDK によるレンダリング。helm-chart— アンブレラチャートを構成するプロバイダー。複数のコンポーネントを境界ごとに 1 つの Helm チャートにパッケージ化します。compose— Docker Compose プロバイダー。境界ごとにdocker-compose.yamlを出力します。terraform— Terraform プロバイダー。境界ごとに 1 つのルート設定を生成し、各コンポーネントはそのコンポーネント自身のサブディレクトリを参照する module ブロックになります。cloudformation— CloudFormation プロバイダー。境界ごとに 1 つのスタックテンプレートを純粋な JSON として出力します。