# Aggrega

> Aggrega ist ein Open-Source-Compiler für Infrastructure as Code: Aus einer einzigen YAML-Beschreibung Ihrer Anwendung werden Dateien für Kubernetes, Helm, Compose, Terraform oder CloudFormation, die Sie prüfen und die Ihnen gehören.

URL: https://aggrega.ai/de/

## Beschreiben Sie die Architektur einmal. Erhalten Sie den Infrastrukturcode für jede Plattform, die Sie betreiben.

Aggrega ist ein Open-Source-Compiler für Infrastructure as Code: Aus einer einzigen YAML-Beschreibung Ihrer Anwendung werden Dateien für **Kubernetes**, **Helm**, **Compose**, **Terraform** oder **CloudFormation**, die Sie prüfen und die Ihnen gehören.

Haben Sie schon einen Agenten mit **LangGraph**, **CrewAI**, **n8n**, **Dify** oder anderen gebaut? Importieren Sie ihn.

[Mit Ihrem KI-Assistenten einrichten](https://aggrega.ai/de/#ai-assistant)[Schnellstart](https://aggrega.ai/docs/de/getting-started/)[Ihr Projekt importieren](https://aggrega.ai/de/#import)

Linux und macOS

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

Windows, in PowerShell

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

Zwei Schnellstart-Beispiele, Schritt für Schritt aufgebaut: ein KI-Agent auf einem lokalen Modell und eine Webanwendung mit PostgreSQL. Jeder Schritt zeigt die Dateien, die er ändert, mit den Zeilen, die er hinzufügt, den Befehl aggrega build und die Dateien, die der Build schreibt.

### Funktioniert mit Ihrem KI-Assistenten

Fügen Sie diesen Prompt in einen Assistenten ein, der Befehle ausführen kann: Er installiert Aggrega, fügt sich selbst den Aggrega-Skill hinzu und verbindet sich mit dem Aggrega-MCP-Server. Der Prompt lässt ihn bei Ihnen nachfragen, bevor er etwas installiert.

Der Prompt

Richten Sie Aggrega für mich ein, Schritt für Schritt, und sagen Sie mir, was Sie bei jedem Schritt ausgeführt haben.

1. Führen Sie `aggrega version` aus. Wird der Befehl nicht gefunden, fragen Sie mich, bevor Sie Aggrega installieren, und installieren Sie es dann für meinen Benutzer mit dem offiziellen Installationsprogramm: unter Linux oder macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, unter Windows in PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Führen Sie `aggrega version` erneut aus. Wenn das Installationsprogramm eine Zeile ausgegeben hat, die zu meinem `PATH` hinzuzufügen ist, zeigen Sie sie mir.

2. Wenn `https://aggrega.ai/docs/ai-assistants/skill/` einen Weg angibt, das Aggrega-Plugin bei Ihnen zu installieren, fragen Sie mich, bevor Sie es installieren, und installieren Sie es dann auf diese Weise, oder sagen Sie mir, was zu tun ist, wo es sich um einen Schritt handelt, den ich in Ihrer Oberfläche ausführe. Das Plugin fügt den Aggrega-Skill hinzu und verbindet Sie mit dem MCP-Server von Aggrega. Andernfalls führen Sie `aggrega skills install --help` aus und suchen Sie Ihren eigenen Bezeichner in der Liste, die der Befehl ausgibt. Fragen Sie mich, ob ich den Skill in diesem Projekt oder in allen Projekten haben möchte, und führen Sie dann `aggrega skills install --agent <your identifier>` aus, mit `--global` für alle Projekte. Wenn Sie nicht in der Liste stehen, überspringen Sie die Installation des Skills und sagen Sie es mir.

3. Wenn Sie das Plugin installiert haben, sind Sie bereits mit dem MCP-Server von Aggrega verbunden. Andernfalls verbinden Sie sich mit dem MCP-Server von Aggrega, also dem Befehl `aggrega mcp`, so wie Sie einen MCP-Server hinzufügen, wie `https://aggrega.ai/docs/ai-assistants/mcp-server/` es für Sie beschreibt. Wenn Sie einen Neustart oder ein Neuladen brauchen, um das Plugin oder den Server zu laden, sagen Sie mir, was zu tun ist.

4. Sobald Sie verbunden sind, rufen Sie das Tool `describe-capabilities` ohne Argumente auf und fassen Sie zusammen, was es auflistet.

**Den ganzen Prompt anzeigen**

- **Der Skill** — Erklärt dem Assistenten, wie der Authoring-Zyklus abläuft, und dass er jede Antwort zu einem Schema oder einer Datei von der Binärdatei aggrega übernehmen soll.

- **Der MCP-Server** — aggrega mcp gibt dem Assistenten die Werkzeuge von Aggrega: scaffold, validate, build und die übrigen.

[Was sich von Assistent zu Assistent ändert](https://aggrega.ai/docs/de/ai-assistants/set-up/)

### So funktioniert es

Sie beschreiben die Anwendung, Aggrega schreibt die Dateien, und die Werkzeuge, die Sie bereits verwenden, stellen sie bereit. Aggrega greift nie auf einen laufenden Cluster oder ein Cloud-Konto zu.

Aggregate beschreibt Ihre Anwendung

Release Einstellungen einer Umgebung

Manifest wie jeder Teil gebaut wird

aggrega build gleiche Eingabe, gleiche Dateien

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

Dateien, die Sie prüfen und die Ihnen gehören

Außerhalb von Aggrega

ArgoCD · Flux · Terraform stellen das Geschriebene bereit

Aggrega endet bei den Dateien. Es greift nie auf einen laufenden Cluster oder ein Cloud-Konto zu; Ihre eigenen Werkzeuge stellen bereit, was es geschrieben hat.

#### Die Anwendung beschreiben

Ein **Aggregate** benennt seine **Komponenten** und wie sie verbunden sind.

#### Die Umgebung wählen

Ein **Release** liefert die Einstellungen dieser Umgebung.

#### Festlegen, wie jeder Teil gebaut wird

Ein **Manifest** ordnet jede Komponente einem **Recipe** für Ihre Plattform zu, etwa einem Helm-Chart, einem Terraform-Modul oder einem Container.

#### aggrega build ausführen

Der Befehl schreibt die Dateien für jede Plattform: bei gleicher Eingabe jedes Mal **dieselben Dateien**.

#### Mit Ihren Werkzeugen bereitstellen

Was der Befehl geschrieben hat, stellen **ArgoCD**, **Flux** oder **Terraform** bereit.

### Was Sie bauen können

Beginnen Sie mit einem lauffähigen Beispiel oder mit den Komponenten des Katalogs.

#### KI-Agenten und Gateways

Agenten, gebaut mit LangGraph, CrewAI, LlamaIndex, Dify, n8n und anderen, hinter Modell-Gateways mit Token-Budgets, semantischem Caching, Log-Maskierung und einem Schutz gegen Prompt-Injection.

[Ein Agent hinter einem Gateway mit Token-Budget](https://aggrega.ai/docs/de/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Klassische Arbeitslasten

Datenbanken, Caches, Message Broker und Identitätsverwaltung, zum Beispiel PostgreSQL, MariaDB, Redis, Kafka und Keycloak.

[Eine PostgreSQL-Datenbank, auf drei Arten bereitgestellt](https://aggrega.ai/docs/de/language-reference/examples/postgres-three-realizations/)

#### Features

Fähigkeiten, die Sie pro Umgebung anhängen, ohne die Anwendung anzufassen, zum Beispiel ein Schutz gegen Prompt-Injection, die Maskierung sensibler Daten, HTTPS-Ingress, Monitoring und Backups.

[Ein Gateway, das jede Anfrage auf Prompt-Injection prüft](https://aggrega.ai/docs/de/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Eine Anwendung, viele Plattformen

Dasselbe Aggregate wird für Docker Compose auf einem Laptop und für Kubernetes in der Produktion gebaut: Ein Wechsel des Ziels ändert ein Mapping, nicht Ihren Code.

[Ein Aggregate, gebaut für Compose und Kubernetes](https://aggrega.ai/docs/de/language-reference/examples/mariadb-adminer/)

aggregate.yaml einmal geschrieben

Auf einem Laptop

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

Auf einem Kubernetes-Cluster

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

Kubernetes-Manifeste

Jede Plattform wird aus ihrem eigenen Release und Manifest gebaut. Das Aggregate, das Ihre Anwendung beschreibt, bleibt gleich.

#### Governance und Richtlinien

Ihre Richtlinien werden in den Compiler eingesteckt und stoppen einen Build, der gegen sie verstößt, mit dem Hinweis, was zu beheben ist.

[Eine Richtlinie, auf vier Zielen geprüft](https://aggrega.ai/docs/de/language-reference/examples/policy-render-verdict/)

aggrega build

Ihre Richtlinie in den Compiler eingebunden

bestanden

Dateien geschrieben bereit zur Prüfung und Bereitstellung

nicht bestanden

Build gestoppt policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

Eine Richtlinie kann einen Build stoppen und sagen, was zu beheben ist. Sie ändert Ihre Dateien nie, damit sie bestehen.

#### Reproduzierbare Builds

Gleiche Eingabe, gleiche Ausgabe, und jede Abhängigkeit ist in einer Lockfile fixiert.

[Ein Beispiel und seine Lockfile bauen](https://aggrega.ai/docs/de/language-reference/examples/ai-agent-and-model-router/#building)

#### Der Katalog der Standardbibliothek

Components für Agenten, Modelle, Gateways, Datenspeicher, Messaging, Observability, Sicherheit und Speicherung, bereit zur Verwendung in einem Aggregate.

[Den Katalog durchsuchen](https://aggrega.ai/catalog/de/browse)

### Ihr Assistent, mit Aggrega

Was ein Assistent, der Ihren Infrastrukturcode schreibt, gewinnt, wenn er über Aggrega arbeitet.

- **Reproduzierbar** — Gleiche Eingabe, gleiche Dateien, und jede Abhängigkeit ist in einer Lockfile fixiert.

- **Eine Beschreibung** — Eine Beschreibung der Anwendung, gebaut für jede Plattform, auf der sie läuft.

- **Richtlinien zur Build-Zeit** — Ihre Richtlinien laufen im Compiler und stoppen einen Build, der gegen sie verstößt.

- **Ein signierter, versionierter Katalog** — Was ein Assistent aus dem Katalog abruft, ist versioniert und signiert, und der Abruf prüft jede Signatur.

- **Vom Compiler geprüft** — Der Assistent validiert und baut mit der Binärdatei aggrega und bezieht von ihr seine Antworten zu Schemas und Dateien.

### Ziele

Jede Plattform erhält die Dateien, die sie nativ liest. KI-Agenten laufen auf jedem Kubernetes-Cluster, viele auch auf Compose.

- **Kubernetes** — Kubernetes-Manifeste, eine Datei pro Ressource, die ArgoCD oder Flux anwenden.

- **Helm** — Helm-Charts, zu Kubernetes-Manifesten gerendert.

- **Compose** — Eine Docker-Compose-Datei, um die Anwendung auf einem Laptop auszuführen.

- **Terraform** — Konfiguration für verwaltete Cloud-Dienste. Aggrega führt Terraform nie aus.

- **CloudFormation** — Stack-Templates für AWS. Aggrega führt CloudFormation nie aus.

[Was jedes Ziel schreibt](https://aggrega.ai/docs/de/language-reference/providers/reference-matrix/)

### Import

aggrega import liest ein Projekt in einem dieser Formate und schreibt Entwürfe von Aggrega-Dateien, die Sie prüfen und bearbeiten.

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

aggrega import

Entwürfe von Aggrega-Dateien zum Prüfen und Bearbeiten

Ihr bestehendes Projekt hinein, Entwürfe von Aggrega-Dateien heraus. Nichts wird bereitgestellt; Sie prüfen zuerst die Entwürfe.

[Wie der Import funktioniert](https://aggrega.ai/docs/de/authoring/import/)

### Loslegen

#### Schnellstart

Installieren Sie Aggrega, bauen Sie ein lauffähiges Beispiel, führen Sie es auf Ihrem Rechner aus und erweitern Sie es dann Schritt für Schritt.

[Erste Schritte](https://aggrega.ai/docs/de/getting-started/)

#### Ein erstes Beispiel ausführen

Jedes lauffähige Beispiel ist ein vollständiger Workspace, den Sie mit der CLI aggrega bauen.

[Die Beispiele durchsuchen](https://aggrega.ai/docs/de/language-reference/examples/)

#### Installation

Ein einziger Befehl installiert die Binärdatei aggrega für Ihren Benutzer, ohne Administratorrechte.

[Die Binärdatei installieren](https://aggrega.ai/docs/de/install/#install-the-binary)

### Open Source

Der Aggrega-Compiler ist Open Source unter Apache-2.0 und bleibt es: Es wird keine geschlossene Edition des Compilers geben, kein Open-Core. Alle Funktionen des Compilers werden in der Open-Source-Version verfügbar sein.

#### Der Compiler

Die Binärdatei aggrega und ihre Befehlszeilenschnittstelle.

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

#### Visual Studio Code

Validierung, Navigation, Hover und Vervollständigung für Aggrega-YAML, gestützt auf die Binärdatei aggrega.

[Die Erweiterung auf GitHub](https://github.com/aggrega-ai/aggrega-vscode-extension)
