# Aggrega

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

URL: https://aggrega.ai/ja/

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

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

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

[AI アシスタントでセットアップ](https://aggrega.ai/ja/#ai-assistant)[クイックスタート](https://aggrega.ai/docs/ja/getting-started/)[プロジェクトをインポート](https://aggrega.ai/ja/#import)

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 コマンド、そしてビルドが書き出すファイルを示します。

### 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 のツールをアシスタントに提供します。

[アシスタントごとに異なる点](https://aggrega.ai/docs/ja/ai-assistants/set-up/)

### 仕組み

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

Aggregate アプリケーションを記述

Release 1 つの環境の設定

Manifest 各部分のビルド方法

aggrega build 同じ入力から同じファイル

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

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

Aggrega の外側

ArgoCD · Flux · Terraform 書き出されたものをデプロイ

Aggrega の処理はファイルで終わります。実行中のクラスターやクラウドアカウントにアクセスすることはありません。書き出されたものは、お使いのツールがデプロイします。

#### アプリケーションを記述する

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

#### 環境を選択

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

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

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

#### aggrega build を実行する

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

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

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

### 構築できるもの

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

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

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

[トークン予算を持つゲートウェイの背後にあるエージェント](https://aggrega.ai/docs/ja/language-reference/examples/envoy-ai-gateway-token-budget/)

#### 従来型のワークロード

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

[1 つの PostgreSQL データベースを 3 通りの方法でデプロイ](https://aggrega.ai/docs/ja/language-reference/examples/postgres-three-realizations/)

#### Features

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

[各リクエストのプロンプトインジェクションを検査するゲートウェイ](https://aggrega.ai/docs/ja/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### 1 つのアプリケーション、多数のプラットフォーム

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

[1 つの Aggregate を Compose と Kubernetes 向けにビルド](https://aggrega.ai/docs/ja/language-reference/examples/mariadb-adminer/)

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 つのターゲットでチェック](https://aggrega.ai/docs/ja/language-reference/examples/policy-render-verdict/)

aggrega build

独自のポリシー コンパイラに組み込み

合格

書き出されたファイル レビューとデプロイの準備完了

不合格

ビルド停止 policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

ポリシーはビルドを停止し、何を修正すべきかを示すことができます。合格させるためにファイルを変更することはありません。

#### 再現可能なビルド

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

[サンプルとそのロックファイルをビルドする](https://aggrega.ai/docs/ja/language-reference/examples/ai-agent-and-model-router/#building)

#### 標準ライブラリカタログ

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

[カタログを見る](https://aggrega.ai/catalog/ja/browse)

### 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 を実行することはありません。

[各ターゲットが書き出すもの](https://aggrega.ai/docs/ja/language-reference/providers/reference-matrix/)

### インポート

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

- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose

aggrega import

Aggrega ファイルの下書き レビューと編集用

既存のプロジェクトを入力すると、Aggrega ファイルの下書きが出力されます。何もデプロイされません。まず下書きをレビューします。

[インポートの仕組み](https://aggrega.ai/docs/ja/authoring/import/)

### はじめる

#### クイックスタート

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

[はじめに](https://aggrega.ai/docs/ja/getting-started/)

#### 最初のサンプルを実行する

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

[サンプルを見る](https://aggrega.ai/docs/ja/language-reference/examples/)

#### インストール

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

[バイナリをインストールする](https://aggrega.ai/docs/ja/install/#install-the-binary)

### オープンソース

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

#### コンパイラ

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

[GitHub の aggrega-ai/aggrega-cli](https://github.com/aggrega-ai/aggrega-cli)

#### Visual Studio Code

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

[GitHub の拡張機能](https://github.com/aggrega-ai/aggrega-vscode-extension)
