コンテンツへスキップ
Aggrega

このページは機械翻訳されました。英語の原文を読む。

アーキテクチャは一度記述するだけ。運用する各プラットフォーム向けのインフラストラクチャコードが得られます。

Aggrega は Infrastructure as Code のためのオープンソースのコンパイラです。アプリケーションを記述した 1 つの YAML が、レビューして自ら所有する Kubernetes、Helm、Compose、Terraform、または CloudFormation のファイルになります。

LangGraph、CrewAI、n8n、Dify などでエージェントを構築済みですか?インポートできます。

Linux と macOS

curl -fsSL https://aggrega.ai/install.sh | sh

Windows、PowerShell で

irm https://aggrega.ai/install.ps1 | iex

1 ステップずつ組み立てる 2 つのクイックスタート例:ローカルモデルで動く AI エージェントと、PostgreSQL を使う Web アプリです。各ステップでは、変更するファイルと追加する行、aggrega build コマンド、そしてビルドが書き出すファイルを示します。

aggregate.yaml

kind: Aggregatespec:  components:    chat:      type: core/compute/server    agent:      type: core/ai-agent/langgraph    llm:      type: core/ai-model/ollama    memory:      type: core/datastore/valkey

aggrega build --release release.yaml --auto-pull

  • dist/compose/docker-compose.yaml

AI アシスタントと連携

コマンドを実行できるアシスタントにこのプロンプトを貼り付けるだけで、アシスタントは Aggrega をインストールし、Aggrega のスキルを自身に追加して、Aggrega MCP サーバーに接続します。プロンプトは、何かをインストールする前に必ず確認を取るようアシスタントに指示します。

プロンプト

Aggrega のセットアップを一歩ずつ進め、各ステップで何を実行したかを教えてください。

1. `aggrega version` を実行してください。コマンドが見つからない場合は、Aggrega をインストールする前に私に確認し、そのうえで公式インストーラーを使って私のユーザー向けにインストールしてください。Linux または macOS では `curl -fsSL https://aggrega.ai/install.sh | sh`、Windows の PowerShell では `irm https://aggrega.ai/install.ps1 | iex` です。もう一度 `aggrega version` を実行してください。インストーラーが私の `PATH` に追加する行を出力した場合は、それを見せてください。

2. `https://aggrega.ai/docs/ai-assistants/skill/` に自分へ Aggrega プラグインをインストールする方法が示されている場合は、インストールする前に私に確認し、その方法でインストールするか、私がインターフェース上で行う手順であれば、何をすればよいかを教えてください。プラグインは Aggrega スキルを追加し、Aggrega MCP サーバーに接続します。そうでない場合は、`aggrega skills install --help` を実行し、出力される一覧から自分自身の識別子を見つけてください。スキルをこのプロジェクトに入れるか、すべてのプロジェクトに入れるかを私に尋ね、そのうえで `aggrega skills install --agent <your identifier>` を実行してください。すべてのプロジェクトの場合は `--global` を追加します。一覧に自分が含まれていない場合は、スキルのインストールをスキップし、その旨を伝えてください。

3. プラグインをインストールした場合は、すでに Aggrega MCP サーバーに接続されています。そうでない場合は、Aggrega MCP サーバー(コマンド `aggrega mcp`)に、MCP サーバーを追加する通常の方法で、`https://aggrega.ai/docs/ai-assistants/mcp-server/` にある自分向けの説明に従って接続してください。プラグインやサーバーを読み込むために再起動や再読み込みが必要な場合は、私が何をすればよいかを教えてください。

4. 接続できたら、引数なしで `describe-capabilities` ツールを呼び出し、その一覧の内容を要約してください。

スキル
オーサリングループの進め方をアシスタントに伝え、スキーマやファイルに関する答えはすべて aggrega バイナリから得るよう指示します。
MCP サーバー
aggrega mcp は、scaffold、validate、build などの Aggrega のツールをアシスタントに提供します。
アシスタントごとに異なる点

仕組み

アプリケーションを記述すると、Aggrega がファイルを書き出し、すでに使っているツールがそれをデプロイします。Aggrega が稼働中のクラスターやクラウドアカウントにアクセスすることはありません。

Aggregateアプリケーションを記述
Release1 つの環境の設定
Manifest各部分のビルド方法
aggrega build同じ入力から同じファイル
  • Kubernetes
  • Helm
  • Compose
  • Terraform
  • CloudFormation

自分でレビューし、所有するファイル

Aggrega の外側
ArgoCD · Flux · Terraform書き出されたものをデプロイ
Aggrega の処理はファイルで終わります。実行中のクラスターやクラウドアカウントにアクセスすることはありません。書き出されたものは、お使いのツールがデプロイします。
  1. アプリケーションを記述する

    Aggregate は、そのコンポーネントと、それらの接続方法を指定します。

  2. 環境を選択

    Release は、その環境の設定を埋めます。

  3. 各部分のビルド方法を選択

    Manifest は、各コンポーネントを、Helm チャート、Terraform モジュール、コンテナなど、使用するプラットフォーム向けの Recipe に対応付けます。

  4. aggrega build を実行する

    プラットフォームごとにファイルを書き出します。同じ入力からは、毎回同じファイルが得られます。

  5. 使い慣れたツールでデプロイする

    書き出されたものは ArgoCD、Flux、または Terraform がデプロイします。

構築できるもの

実行可能なサンプル、またはカタログのコンポーネントから始められます。

  • AI エージェントとゲートウェイ

    LangGraph、CrewAI、LlamaIndex、Dify、n8n などで構築したエージェントを、トークン予算、セマンティックキャッシュ、ログのマスキング、プロンプトインジェクション対策を備えたモデルゲートウェイの背後に配置します。

    トークン予算を持つゲートウェイの背後にあるエージェント
  • 従来型のワークロード

    PostgreSQL、MariaDB、Redis、Kafka、Keycloak などのデータベース、キャッシュ、メッセージブローカー、ID 管理。

    1 つの PostgreSQL データベースを 3 通りの方法でデプロイ
  • Features

    アプリケーションに手を加えずに環境ごとに付加する機能。たとえば、プロンプトインジェクション対策、機密データのマスキング、HTTPS イングレス、モニタリング、バックアップなどです。

    各リクエストのプロンプトインジェクションを検査するゲートウェイ
  • 1 つのアプリケーション、多数のプラットフォーム

    同じ Aggregate から、ノート PC 上の Docker Compose 向けにも、本番環境の Kubernetes 向けにもビルドできます。ターゲットを変えて変わるのはマッピングであり、コードではありません。

    1 つの Aggregate を Compose と Kubernetes 向けにビルド
    aggregate.yaml一度だけ記述

    ノート PC 上で

    release-compose.yaml
    manifest-compose.yaml
    aggrega build
    docker-compose.yaml

    Kubernetes クラスター上で

    release-helm-synth.yaml
    manifest-helm-synth.yaml
    aggrega build
    Kubernetes マニフェスト
    各プラットフォームは、それぞれの Release と Manifest からビルドされます。アプリケーションを記述する Aggregate は変わりません。
  • ガバナンスとポリシー

    ポリシーはコンパイラに組み込まれ、違反するビルドを停止し、何を修正すべきかを示します。

    1 つのポリシーを 4 つのターゲットでチェック
    aggrega build
    独自のポリシーコンパイラに組み込み
    合格
    書き出されたファイルレビューとデプロイの準備完了
    不合格
    ビルド停止policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted
    ポリシーはビルドを停止し、何を修正すべきかを示すことができます。合格させるためにファイルを変更することはありません。
  • 再現可能なビルド

    同じ入力から同じ出力。すべての依存関係はロックファイルで固定されます。

    サンプルとそのロックファイルをビルドする
  • 標準ライブラリカタログ

    エージェント、モデル、ゲートウェイ、データストア、メッセージング、可観測性、セキュリティ、ストレージのための Components で、Aggregate ですぐに使えます。

    カタログを見る

Aggrega を使うアシスタント

インフラストラクチャのコードを書くアシスタントが、Aggrega を通して作業することで得られるもの。

再現可能
同じ入力から同じファイル。すべての依存関係はロックファイルで固定されます。
1 つの記述
アプリケーションの 1 つの記述を、それが動作するすべてのプラットフォーム向けにビルドします。
ビルド時のポリシー
ポリシーはコンパイラ内で実行され、違反するビルドを停止します。
署名付きでバージョン管理されたカタログ
アシスタントがカタログから取得するものはバージョン管理され、署名されています。取得時には各署名が検証されます。
コンパイラによるチェック
アシスタントは aggrega バイナリで検証とビルドを行い、スキーマやファイルに関する答えをそこから得ます。

ターゲット

各プラットフォームには、それがネイティブに読み込むファイルが生成されます。AI エージェントはどの Kubernetes クラスターでも動作し、その多くは Compose でも動作します。

Kubernetes
Kubernetes マニフェスト。リソースごとに 1 ファイルで、ArgoCD や Flux が適用します。
Helm
Kubernetes マニフェストにレンダリングされる Helm チャート。
Compose
アプリケーションをノート PC 上で実行するための Docker Compose ファイル。
Terraform
マネージドクラウドサービスの設定です。Aggrega が Terraform を実行することはありません。
CloudFormation
AWS 向けのスタックテンプレートです。Aggrega が CloudFormation を実行することはありません。
各ターゲットが書き出すもの

インポート

aggrega import は、以下のいずれかの形式のプロジェクトを読み込み、レビューと編集のための Aggrega ファイルの下書きを書き出します。

  • LangGraph
  • CrewAI
  • n8n
  • Dify
  • Langflow
  • Flowise
  • Google ADK
  • Microsoft Agent Framework
  • MCP client configurations
  • Compose
aggrega import
Aggrega ファイルの下書きレビューと編集用
既存のプロジェクトを入力すると、Aggrega ファイルの下書きが出力されます。何もデプロイされません。まず下書きをレビューします。
インポートの仕組み

はじめる

  • クイックスタート

    Aggrega をインストールし、実行可能なサンプルをビルドしてお使いのマシンで実行し、そのあと一歩ずつ拡張していきます。

    はじめに
  • 最初のサンプルを実行する

    実行可能な各サンプルは、aggrega CLI でビルドする完全なワークスペースです。

    サンプルを見る
  • インストール

    1 つのコマンドで、管理者権限なしに aggrega バイナリを自分のユーザーにインストールできます。

    バイナリをインストールする

オープンソース

Aggrega コンパイラーは Apache-2.0 のオープンソースであり、今後もそうあり続けます。コンパイラーのクローズドなエディションが作られることはなく、open-core にもなりません。コンパイラーのすべての機能は、オープンソース版で提供されます。

  • コンパイラ

    aggrega バイナリとそのコマンドラインインターフェース。

    GitHub の aggrega-ai/aggrega-cli
  • Visual Studio Code

    aggrega バイナリに支えられた、Aggrega YAML の検証、ナビゲーション、ホバー、補完。

    GitHub の拡張機能