コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

エコシステムの思想

エコシステムの思想

Aggrega のアーキテクチャは、柔軟性と予測可能性のバランスを取る中核的な設計原則に基づいています。明確な境界と標準化された契約を維持することで、本質的に汎用的なコンパイラが、標準的なクラウドネイティブ基盤から高度に専門化された AI インテリジェンスまで、あらゆるものをシームレスにオーケストレーションできます。

1. 中核メカニズム:アーキテクチャの物理法則

  • 関心の分離(コンウェイの法則):開発者は物理インフラのコードを書かず、Ops はアプリケーションロジックをハードコードしません。アーキテクチャの指針はオーサリングをドメイン駆動(Domain-Driven)の境界に分割しますが、コンパイラはこの分離を強制しません(不変条件 7 を参照)。
  • 遅延バインディング(依存性逆転):開発者が要求するのは抽象的なインターフェース(例:type: enterprise-agent)であり、具体的な実装(例:helm-chart-v2)ではありません。Manifest がコンパイル時にインターフェースを正しい実装に解決するため、単一のソースファイルから真のマルチターゲットデプロイが可能になります。
  • AOT の純粋性(ライブクラウドからの取得なし):コンパイラはライブクラウドに依存しません。コンパイル中にインフラストラクチャ API で認証したり、ライブ IP アドレスを取得したりすることはありません。完全に制御の反転に基づいて動作し、決定論的なポインタをマッピングし、抽象的なインジェクション契約を事前に渡すことで、ランタイム環境が最終的な物理接続を安全に解決できるようにします。

2. 開発者体験:意図と抽象化

  • セマンティックな開発者体験(5 キーワードのマップ標準):認知的な摩擦を防ぐため、開発者はマップベースの YAML トポロジーの中で、誰にでも理解できる 5 つのキーワードだけを使用します。
    1. parameters:グローバルな環境契約(例:動的なディスクサイズの受け渡し)。
    2. values:中核となる認知/ビジネスロジックのペイロード(開発者が所有)。
    3. uses:明示的に宣言されたネットワークエッジと依存関係(開発者が所有)。
    4. infra:物理的なフットプリントと機械的なサイジング(Ops が所有し、Aggregate では禁止)。
    5. inject:ローカル変数をターゲットの provides キー(env、file、arg)にマッピングする厳格な配信契約。この仕組みは拡張可能です。
  • ケイパビリティに依存しない用語:基盤となるインフラの実情(Kubernetes の用語 namespace など)が開発者体験に漏れ出さないよう、プラットフォームは boundaries のような普遍的な概念を使用します。
  • 明示的な意図と「声高なガードレール」(ゴーストインフラなし):コンパイラは、開発者が明示的に宣言していないコンピュートや機能を決して作り出してはなりません。ポリシーエンジンを使ってセキュリティプロキシを黙って注入すると「ゴーストインフラ」が生まれます。それが壊れたとき、開発者は結局、自分の YAML に存在しないプロキシをデバッグすることになります。Wasm ポリシープラグインは、アーキテクチャを黙って変更する代わりに、厳密に声高なガードレールとして機能します。トポロジーがセキュリティに違反した場合、コンパイラはビルドを停止し、非常に具体的なエラーを返します(例:「エラー:PII データが AI ゲートウェイ router を通ってモデルプロバイダーへ流れています。core/data-masking 機能を明示的にアタッチする必要があります」)。これにより、開発者は自らの単一の信頼できる情報源を修正せざるを得なくなります。

3. 主張を持たないコンパイラ:処理とオーケストレーション

  • プログラム可能なポリシー(主張を持たないコンパイラ):コアの Go コンパイラは、内容に対して中立な計算メカニズムです。YAML を解析し、グラフを走査し、ラベルの交差を評価します。実際の「インテリジェンス」(たとえば、制限付きデータを運ぶモデルトラフィックが、機密テキストをマスクする AI ゲートウェイを必ず通過するよう強制すること)は、企業がプラグイン可能な WebAssembly (Wasm) ソケットを使って動的にプログラムします。これらのソケットは、抽象構文木 (AST) の変更—解析済みのメモリ内の構成表現を変更すること—とポリシー検証に使われます。
  • スキーマ非依存性(オープンソースの辞書):コアコンパイラは物理的な実行レイヤーに依存しません。Helm、Terraform、Docker Compose 用のハードコードされたスキーマは持っていません。代わりに、Ops Recipe の source ブロックはオープンな辞書であり、そのキーはプロバイダーが定義し、Recipe のテンプレートに .source.* として渡されます。コアは取得される source を組み込みの { kind, url, version } 形式で解決します(kind:helm-oci-chart、helm-https-chart、compose-https-fragment、git-repository)。これにより、コンパイラは操作対象のクラウド言語からすでに切り離されています。取得モデルについては、Recipe の source リファレンスを参照してください。
  • 明示的な Plugin オーケストレーション:中核の Go コンパイラは厳密に中立的なグラフビルダーとして動作し、ノードの処理方法を推測することは決してありません。代わりに、すべてのドメインインテリジェンスは、専用の WebAssembly (Wasm) ソケットを通じて 2 つの異なるレベルで明示的にオーケストレーションされます。 1. グローバルソケット:企業のポリシーとフォーマットは、明示的に登録されたコンパイラソケットによって評価されます(例:メタデータの自動タグ付けのためのガバナンスロール label-transform、トポロジーのセキュリティのためのガバナンス判定ロール、最終的な成果物生成のためのレンダラーソケット)。 2. 実装パイプライン:Component 固有の変更ロジックは Manifest によってオーケストレーションされます。これが抽象インターフェースを具体的な Recipe に解決すると、その実装は実行する Wasm プラグインの順序付き pipeline 配列を明示的に宣言します。コンパイラは、ケイパビリティに依存しない中間表現(IR)グラフをこれらの定義済みソケットに渡すだけであり、これによってドメイン固有のロジックはすべてコンパイラのコアにハードコードされるのではなく、エコシステム内で厳密にバージョン管理されたままになります。
  • フラットなコンパイルと Feature のアトミック性:Aggrega は状態を管理せず、エンドポイントに ping を送らず、ロールアウトの完了を待つこともありません。コンパイラはネストされたモジュールを評価し、それらをフラットな 1 次元の中間表現(IR)グラフに解決してから、データを Wasm レンダリングプラグインに渡します。重要なのは、グラフがフラット化されても、コンパイラが Feature のアトミック性を保持することです。プロキシ機能が安全なボールトへのネットワークエッジを自律的に宣言した場合、コンパイラはそのエッジのセマンティックな起点を記録し、Wasm ポリシーエンジンが接続を親コンポーネントに誤って帰属させることなく $O(1)$ のルックアップを実行できるようにします。最後に、時間的な順序付けをサポートするため、Release 内の各境界は syncWave: <integer> の値を持ちます。各レンダリングプラグインは境界ごとのウェーブを、自らのターゲットが順序を表現する手段(下流の GitOps コントローラーが読む実行順序のアノテーション、またはレンダリングするファイル内のサービス間の依存関係)に変換します。一方、順序を表現する手段をまったく持たないターゲットは、ウェーブを記録するだけで、それに基づく順序付けは行いません。

4. セマンティックオントロジー:識別と分類

  • 運用的なクラウドネイティブオントロジー:オープンソースの Wasm プラグインと企業ポリシーが普遍的に相互運用できるよう、component.aggrega.ai/type ラベルは普遍的なクラウドプリミティブの閉じた集合(server、worker、task、function、stateful-server、resource)にのみ対応します。これは Aggrega 自身のキーです。公開されている Component スキーマが取りうる値を列挙しており、それ以外の値を持つドキュメントは読み込み時に拒否されます。この語彙を中央で固定することこそが、自律的なポリシーエンジンとコミュニティが作成した Wasm レンダリングプラグインが、どちらの作者も書いていない Component に出会ったときに、同じ形に対して同じ語を読み取ることを保証します。それでもコンパイラは文字列から何も推論しません。値をセレクターと照合するだけで、自らの判断では何もプロビジョニングしません。閉じた集合がもたらすのは、全員のセレクターが同じ語彙と照合しているという点です。
  • Aggrega が定義しない軸での分類:閉じた集合が対象とするのは、この 1 つの予約キーだけです。独自の分類(ティア、データゾーン、サービスクラス、プリミティブのより細かい分割など)を必要とするカタログは、予約キーの隣に独自のラベルキーを記述します。Component スキーマは文字列値を持つ任意の追加ラベルキーを受け付け、すべてのセレクターの箇所がそれを同じように読み取るためです。拡張は Aggrega のキーの内部ではなく自分のキーで行います。そのため、共有の語彙がずれることなく、企業の語彙を拡張できます。
  • ダックタイピング(ラベルによるセマンティックな特性):基本型が純粋にクラウドネイティブであるなら、認知・運用・コンプライアンスに関するインテリジェンスはすべて、セマンティックなダックタイピングによって重ねられます。Platform Architect が記述したラベル(例:model.aggrega.ai/capability: generative、compliance.aggrega.ai/data-class: restricted)が、ノードの真のアイデンティティとして機能します。Features は、これらのラベルセレクターに基づいて動的にコンポーネントにバインドされます。

5. エンタープライズガバナンス:スキーマと継承

  • 厳格な API の区分とエンタープライズでの発見可能性:Kubernetes の標準に従い、すべてのペイロード定義は一律に spec: ブロック内に置かれます。リソースのアイデンティティ、特性を表すラベル、コンパイラへの明示的な指示は、厳密に metadata: ブロック内に置かれます。厳格な解決を保証するため、共有可能なすべての YAML 成果物には、正規表現で検証される SemVer の version 文字列が厳密に義務付けられています。さらに、OCI レジストリでの発見可能性とライフサイクルガバナンスをサポートするため、metadata ブロックはオプションのエンタープライズメタデータスイートをサポートします。このスイートには、description、構造化された maintainers オブジェクト配列(name、email、url)、license、repository、home(ドキュメントの URL)、keywords(検索インデックス用)が含まれます。サポート終了はドキュメントの外で管理されます。aggrega deprecate は、公開済みの成果物に、その公開済みのバイトを変更することなく、署名付きの非推奨マーカー(重大度、理由、およびオプションの置き換え先)を付与します。

  • スキーマの拡張性(Kubernetes の CRD パターン):新しい AI 機能やインフラ機能のたびに中核コンパイラのスキーマを更新しなくて済むよう、プラットフォームは設定の検証に JSON Schema 2020-12 を使用します。Platform Architect は、厳格な型、検証ロジック、デフォルト値をカタログコンポーネントの schema: ブロックに直接記述します。通常はコンパクト形式で記述します。これはフィールドごとの制約を 1 行に収める YAML 風の短縮記法であり(port: { type: integer, min: 1, max: 65535, default: 8080 })、検証の実行前に JSON Schema 2020-12 にコンパイルされます。完全な語彙を必要とするスキーマ向けには、完全な JSON Schema の YAML も同等の記述方法として引き続き使えます。Component をまたいだスキーマの再利用が有益になるほど大きくなったカタログは、共通の形(プローブブロック、リソース制限、名前付きポートの形)を専用の SchemaLibrary エンティティにまとめ、JSON Schema の $ref: キーワードで参照します。

  • スキーマの継承(ペイロードのベースライン):ベースラインを一度だけ記述すれば済むよう、プラットフォームは継承を 2 つの異なる層に分けます。標準の YAML メタデータ(セマンティックラベルを含む)、Manifest のマッピング、Release の設定は、必要な環境ごとの上書きを可能にするため、従来のマージ戦略を使用します。ペイロードスキーマ(schema:)はそのようにはマージされず、2 種類のカタログはここで道を分かちます。Feature の schema: は JSON Schema 2020-12 の合成セマンティクスに従ってベースのスキーマと合成され、ワークスペースの読み込み時に、ソース位置による由来のタグ付けを行うマージャーによって走査されるため、マージ後のスキーマのすべてのリーフが元のファイルを保持します。一方、拡張する Component はペイロードの内容をまったく記述しません。リテラルのマーカー schema: inherited を書き、チェーンのどの深さでも、ベースが記述したとおりのブロックをそのまま受け取ります。したがって、Component のベースラインはポリシーではなく構造によって保証されます。子の契約はベースの契約そのものであり、子が緩めるものは何もありません。 そうした Component が代わりに合成するのは構造です(アタッチメントスロット、トポロジーソケット、自己注入の許可リスト、名前付きの assertions)。ベースが宣言するよりも厳しいルールを必要とする子は、それを追加の assertions: エントリとして表現し、ベースのルールは置き換えられることなくそれと並んで維持されます。より広範なトポロジーのセキュリティとラベルのガバナンスは、引き続き適切に Wasm ガバナンスソケットに委ねられます。

  • インターフェースの同等性と自動実装:アーキテクトがベースの Component を少し変えたバリエーションを生み出すたびに Ops が Recipe の YAML を複製しなくて済むよう、ベースに対して書かれた Recipe は、チェーンのどの深さであっても、それを拡張するすべての Component に対応します。拡張する Component は schema: inherited と書くため、ベースの Recipe が消費できないルートキーを values/infra/provides に追加することはありません。Manifest は拡張された型を独自のエントリーで引き続きマッピングし、マッピングのチェックは、マッピング先の Recipe の implements がその型またはそれが拡張するいずれかのベースを指定していれば、そのエントリーを受け入れます(ベースに対して書かれた Recipe は、それを拡張するすべてに対応するを参照)。ゴーストインフラトラッカー(バインドされた Recipe が宣言するどのテンプレートも作成されたキーを読まないときに警告を出し、「ゴーストインフラ」を防ぐもの)が、対応するレンダリング段階のガードレールです。

  • implements のバージョン照合:Recipes と FeatureRecipes の implements フィールドは、厳格さとエコシステムの柔軟性のバランスを取るため、3 つの形式をサポートします。

    1. 完全一致のバージョン:implements: "core/api-server:1.0.0" — 1.0.0 のみに一致します。特定のスキーマバージョンと密結合した Recipes 向けです。
    2. メジャー互換(SemVer の範囲):implements: "core/api-server:^1.0.0" — >=1.0.0, <2.0.0 に一致します。Component の SemVer 互換性保証に乗る Recipes 向けに設計されています。SemVer に従い、マイナーおよびパッチの更新は後方互換であるとみなされ、コンパイラは Component のバージョンがその範囲を満たすことを確認します。
    3. バージョンなし:implements: "core/api-server" — 任意のバージョンに一致します。本当にバージョンに依存しない Recipes 向けです(例:.context.inject.env だけを使い、バージョン固有の values フィールドを使わない汎用 worker の Recipe)。

    implements が Recipe を選択することはありません。Manifest が各コンポーネント型の Recipe を指定し、コンパイラはマッピング先の Recipe の implements が 3 つの形式のいずれかでその型を受け入れるかを確認し、一致しなければ停止します。コンポーネント型にマッピングがない場合にコンパイラが候補の Recipes を提案するのも、この同じ宣言に基づいています。

    この 3 形式のパターンにより、Recipes は Component のスキーマとの実際の結合度に合ったバージョン契約を宣言できます。特定のスキーマバージョンに密に結び付いた Recipes は完全一致で固定し、Component の SemVer 互換性保証に乗る Recipes はメジャー互換の範囲を使い、動作が Component のバージョンにまったく依存しない Recipes はバージョンなしのままにします。その結果、Component のマイナーバージョンの更新によって、Ops が Component のバージョンを固定したり、バージョンごとに並行した Recipes を保守したりすることを強いられなくなります。