このページは機械翻訳されています。英語の原文を読む。
Aggrega ロードマップ
Aggrega がどこから来て、どこへ向かうのかを大きな段階で示します。マイルストーン 0 から 3 は、コンパイラとそのカタログが現在できることを説明し、マイルストーン 4 とそれ以降の方向性は今後の作業を説明します。このページには日付は記載していません。現在動作するものは、サーフェスごとに言語のステータスにまとめています。
マイルストーン 0 — プロトタイプ
最初のプロトタイプは、YAML ドキュメントを中間グラフを経由して Helm 出力へとコンパイルし、このアプローチが成り立つことを示しました。その後に続いたコンパイラは、以下のエンティティモデルを中心に書かれました。
マイルストーン 1 — コンパイラのコア
- エンティティモデル。 開発者はアプリケーションを Aggregate に記述します。プラットフォームチームは、それが使用する Components と Features、およびそれらをターゲット上で実現する Recipes と FeatureRecipes を提供します。Manifest は各型をその Recipe に対応付け、Release は Aggregate を 1 つの環境に配置します。
- コンパイルパイプライン。 解決、トポロジー構築、グラフの確定、静的解析、レンダリングによって、ドキュメントはコンポーネントとその間の
uses接続からなる中間グラフに変換され、さらにファイルに変換されます。 - 注入コントラクト。 コンポーネントは
providesを通じて接続値を公開し、コンパイラはそれをinjectを通じて、名前空間をまたいで各コンシューマーへ受け渡します。開発者がホスト名を書く必要はありません。 - 環境ごとのパラメーター。 Aggregate はパラメーターを公開し、各 Release はその環境に合わせてそれらを埋めます。
- Kubernetes マニフェストと Helm チャート、境界ごとに書き出され、
aggrega buildとaggrega inspectで利用できます。
マイルストーン 2 — 完全なパイプライン
- リソースをレンダリングする Features と、Features としての認証情報。 アタッチされた Feature は独自のリソースをレンダリングでき、認証情報も他と同じく 1 つの Feature であり、環境変数またはファイルとしてそのコンポーネントに渡されます。
- Docker Compose、Compose ネットワーク間で接続を中継するブリッジを備えます。
- Recipe の書き方は 3 通りあり、組み合わせることができます: 既存のチャート、モジュール、ファイルをラップする(
source:)、コンテナを Workload として一度だけ記述してターゲットに合成させる(workload:)、または独自のファイルを出力する(artifacts:)。 - 決定論的な出力。 作成者の順序はあらゆる箇所で保持されるため、同一の入力からはバイト単位で同一の出力が得られます。
- 単一のスキーマ言語。 JSON Schema 2020-12 に、コンパクトな YAML 省略記法、再利用可能なスキーマライブラリとマッピングライブラリ、型付きのパラメーターコントラクト、フィールド間のアサーションを備えています。
- アノテーションによってアタッチされる Features。 Release または Aggregate は、Manifest がバインドするアノテーションを書くことで Feature をアタッチします。出力は明示的にアタッチした場合と同じです。
aggrega build --trace、デバッグのために各コンポーネントの中間状態を書き出します。
マイルストーン 3 — 0.9.0 リリース
0.9.0 で追加されるもの:
- 5 つのターゲットをプラグインでレンダリング。 Kubernetes マニフェスト、Helm チャート、Docker Compose、Terraform、CloudFormation はそれぞれ、バイナリに組み込まれた WebAssembly のプロバイダープラグインによって書き出されるため、インストール直後からオフラインでレンダリングできます。コンパイラはファイルを書き出すだけで、ツールを実行することはありません。Workload の
formは、それがどのコントローラーになるかを選択します。ステートレス、ステートフル、デーモン、スケジュール実行、または 1 回限りのタスクです。 - ドメイン固有のものはすべて Plugins で。 Providers、ポリシー、インポーター、パイプラインステップ、コマンドライン拡張はすべて WebAssembly プラグインであり、Go、Rust、TypeScript 向けのプラグインキットで書かれます。ホストとプラグインは、CBOR でエンコードされた 1 つのバージョン付きインターフェースを通じてデータを交換し、このインターフェースは 3 言語すべてに対して単一のスキーマから生成されます。
- ガバナンス。 ワークスペースにアタッチされたポリシープラグインは、すべてのビルドをチェックします。ルールに違反するグラフやレンダリング済みファイルを、修正すべき点を示して拒否するか、開発者が入力することのないラベルやアノテーションを付与します。
- レジストリ、ロックファイル、署名。 カタログエンティティは、Aggregates も含め、名前とバージョンによって OCI レジストリに公開され、そこからプルされます。
aggrega pullはすべての依存関係をロックファイルに固定し、アーティファクトは公開時に署名され、プル時に検証されます。 - 標準ライブラリカタログとその公開ハブ。 エージェント、モデル、ゲートウェイ、データストア、メッセージング、オブザーバビリティ、セキュリティ、ストレージ向けの Components を、タイプ、カテゴリ、機能のラベルで整理し、
hub.aggrega.aiから提供します。 aggrega import。 インポータープラグインは、Langflow、Flowise、n8n、Dify、CrewAI、LangGraph、Google ADK、Microsoft Agent Framework、MCP、Docker Compose のプロジェクトから Aggrega ファイルの下書きを作成し、各マッピングをカタログに照らしてスコア付けします。--syncは下書きをソースと同期させ続けます。- 無理のない始め方。 単一のスコープを持つ Release または Aggregate には境界もサブシステムも不要で、
aggrega scaffold、aggrega edit-document、aggrega validate、aggrega lint、aggrega explainが作成のループを支援します。 - エディターとアシスタント。 Visual Studio Code 拡張機能は、
aggrega serveを通じて Aggrega YAML に検証、ナビゲーション、ホバー、補完、トポロジーグラフを提供します。aggrega mcpと Aggrega スキルは、AI アシスタントに同じツールを提供します。 - インストールは、Linux、macOS、Windows で 1 つのコマンドで行えるほか、Homebrew、Scoop、winget からも行えます。
マイルストーン 4 — ユーザーによる採用、より多くのクラウド、より大きなカタログ
- ユーザーによる採用。 ユーザーから寄せられる声が作業の順序を決めます。導入を容易にするものが最優先です。
- Azure と Google Cloud のプロバイダー。
- より大きなカタログ。 より多くのコンポーネントと、すべてのターゲットに対応する Recipes。基本コンポーネントの Terraform および CloudFormation による実現も含みます。
- 形式検証されたコア。 コンパイラのコア特性を Lean の定理として証明します。同一の入力からは同一の出力が得られること、宣言されていないものは何も出力されないこと、そしてすべての接続値が、その
uses接続が指定するコンシューマーにのみ正確に届くことです。組み込みプラグインはプロパティベーステストでカバーします。
その他の方向性
- アーキテクチャのライブビュー。 エディターのトポロジーグラフと
--ir-graphは、コンパイラが解決したグラフをすでに表示します。ストリーミングモードでは、そのグラフが変更されるたびに送信されるため、フロントエンドは各編集にリアルタイムで追従できます。 - マネージドコンテナサービス上の Workloads。一度記述した Workload を、Amazon ECS と Fargate、Google Cloud Run、Azure Container Apps など、クラウドターゲットのマネージドコンテナサービス向けに合成します。
- インポートできる形式の追加。アプリケーションが呼び出す、または提供する API のための OpenAPI 仕様と、Score のワークロードファイルです。
- Component から下書きされる Recipe。Component の値をすでに読み取り、その接続値を提供するスターター Recipe を、プラットフォームチームが完成させます。
- 環境ごとにドキュメントの形を変えるテンプレート。ドキュメントを解析する前にテンプレートを評価することで、ある環境には存在し、別の環境には存在しないキーを実現します。
- エディターでのポリシー検出結果。ガバナンスプラグインの検出結果を、ファイルの変更に合わせて、現在表示している検証結果と並べてエディターに表示します。