# Aggrega

> Aggrega est un compilateur open source pour l’infrastructure en tant que code : une seule description YAML de votre application devient des fichiers Kubernetes, Helm, Compose, Terraform ou CloudFormation que vous relisez et qui vous appartiennent.

URL: https://aggrega.ai/fr/

## Décrivez l’architecture une seule fois. Obtenez le code d’infrastructure de chaque plateforme que vous exploitez.

Aggrega est un compilateur open source pour l’infrastructure en tant que code : une seule description YAML de votre application devient des fichiers **Kubernetes**, **Helm**, **Compose**, **Terraform** ou **CloudFormation** que vous relisez et qui vous appartiennent.

Vous avez déjà construit un agent avec **LangGraph**, **CrewAI**, **n8n**, **Dify** ou d’autres ? Importez-le.

[Configurer avec votre assistant IA](https://aggrega.ai/fr/#ai-assistant)[Démarrage rapide](https://aggrega.ai/docs/fr/getting-started/)[Importer votre projet](https://aggrega.ai/fr/#import)

Linux et macOS

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

Windows, dans PowerShell

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

Deux exemples de démarrage rapide, construits une étape à la fois : un agent IA sur un modèle local, et une application web avec PostgreSQL. Chaque étape montre les fichiers qu’elle modifie avec les lignes qu’elle ajoute, la commande aggrega build et les fichiers que le build écrit.

### Fonctionne avec votre assistant IA

Collez ce prompt dans un assistant capable d’exécuter des commandes : il installe Aggrega, s’ajoute la compétence Aggrega et se connecte au serveur MCP d’Aggrega. Le prompt lui fait vous demander votre accord avant d’installer quoi que ce soit.

Le prompt

Configurez Aggrega pour moi, une étape à la fois, et dites-moi ce que vous avez exécuté à chaque étape.

1. Exécutez `aggrega version`. Si la commande est introuvable, demandez-moi avant d’installer Aggrega, puis installez-le pour mon utilisateur avec le programme d’installation officiel : sous Linux ou macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, sous Windows dans PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Exécutez de nouveau `aggrega version`. Si le programme d’installation a affiché une ligne à ajouter à mon `PATH`, montrez-la-moi.

2. Si `https://aggrega.ai/docs/ai-assistants/skill/` indique un moyen d’installer le plugin Aggrega en vous, demandez-moi avant de l’installer, puis installez-le de cette manière, ou dites-moi quoi faire lorsqu’il s’agit d’une étape que j’effectue dans votre interface. Le plugin ajoute la skill Aggrega et vous connecte au serveur MCP d’Aggrega. Sinon, exécutez `aggrega skills install --help` et trouvez votre propre identifiant dans la liste qu’il affiche. Demandez-moi si je veux la skill dans ce projet ou dans tous les projets, puis exécutez `aggrega skills install --agent <your identifier>`, en ajoutant `--global` pour tous les projets. Si vous n’êtes pas dans la liste, n’installez pas la skill et dites-le-moi.

3. Si vous avez installé le plugin, vous êtes déjà connecté au serveur MCP d’Aggrega. Sinon, connectez-vous au serveur MCP d’Aggrega, qui est la commande `aggrega mcp`, de la manière dont vous ajoutez un serveur MCP, comme `https://aggrega.ai/docs/ai-assistants/mcp-server/` le décrit pour vous. Si vous avez besoin d’un redémarrage ou d’un rechargement pour charger le plugin ou le serveur, dites-moi quoi faire.

4. Une fois connecté, appelez l’outil `describe-capabilities` sans argument et résumez ce qu’il liste.

**Afficher le prompt complet**

- **La compétence** — Indique à l’assistant comment se déroule la boucle de rédaction, et lui demande de tirer chaque réponse sur un schéma ou un fichier du binaire aggrega.

- **Le serveur MCP** — aggrega mcp donne à l’assistant les outils d’Aggrega : scaffold, validate, build et les autres.

[Ce qui change d’un assistant à l’autre](https://aggrega.ai/docs/fr/ai-assistants/set-up/)

### Comment ça fonctionne

Vous décrivez l’application, Aggrega écrit les fichiers, et les outils que vous utilisez déjà les déploient. Aggrega n’accède jamais à un cluster en cours d’exécution ni à un compte cloud.

Aggregate décrit votre application

Release les paramètres d’un environnement

Manifest comment chaque partie est construite

aggrega build mêmes entrées, mêmes fichiers

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

des fichiers que vous relisez et qui vous appartiennent

En dehors d’Aggrega

ArgoCD · Flux · Terraform déploient ce qu’il a écrit

Aggrega s’arrête aux fichiers. Il n’accède jamais à un cluster en cours d’exécution ni à un compte cloud ; vos propres outils déploient ce qu’il a écrit.

#### Décrire l’application

Un **Aggregate** nomme ses **composants** et la façon dont ils se connectent.

#### Choisir l’environnement

Une **Release** fournit les paramètres de cet environnement.

#### Choisir comment chaque partie est construite

Un **Manifest** associe chaque composant à une **Recipe** pour votre plateforme, comme un chart Helm, un module Terraform ou un conteneur.

#### Exécuter aggrega build

La commande écrit les fichiers de chaque plateforme : les **mêmes fichiers** pour la même entrée, à chaque fois.

#### Déployer avec vos outils

Ce qu’elle a écrit est déployé par **ArgoCD**, **Flux** ou **Terraform**.

### Ce que vous pouvez construire

Partez d’un exemple exécutable, ou des composants du catalogue.

#### Agents IA et passerelles

Des agents construits avec LangGraph, CrewAI, LlamaIndex, Dify, n8n et d’autres, derrière des passerelles de modèles avec budgets de jetons, cache sémantique, masquage des journaux et un bouclier contre l’injection de prompt.

[Un agent derrière une passerelle avec un budget de jetons](https://aggrega.ai/docs/fr/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Charges de travail traditionnelles

Bases de données, caches, brokers de messages et gestion des identités, par exemple PostgreSQL, MariaDB, Redis, Kafka et Keycloak.

[Une base de données PostgreSQL, déployée de trois façons](https://aggrega.ai/docs/fr/language-reference/examples/postgres-three-realizations/)

#### Features

Des capacités que vous attachez par environnement sans toucher à l’application, par exemple un bouclier contre l’injection de prompt, le masquage des données sensibles, un ingress HTTPS, la supervision et les sauvegardes.

[Une passerelle qui contrôle chaque requête pour détecter l’injection de prompt](https://aggrega.ai/docs/fr/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Une application, de nombreuses plateformes

Le même Aggregate se construit pour Docker Compose sur un ordinateur portable et pour Kubernetes en production : changer de cible change une correspondance, pas votre code.

[Un Aggregate, construit pour Compose et Kubernetes](https://aggrega.ai/docs/fr/language-reference/examples/mariadb-adminer/)

aggregate.yaml écrit une seule fois

Sur un ordinateur portable

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

Sur un cluster Kubernetes

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

manifestes Kubernetes

Chaque plateforme est construite à partir de sa propre Release et de son propre Manifest. L’Aggregate, qui décrit votre application, reste le même.

#### Gouvernance et politiques

Vos politiques se branchent sur le compilateur et arrêtent un build qui les enfreint, en indiquant quoi corriger.

[Une politique, vérifiée sur quatre cibles](https://aggrega.ai/docs/fr/language-reference/examples/policy-render-verdict/)

aggrega build

votre politique branchée sur le compilateur

réussite

fichiers écrits prêts à relire et à déployer

échec

build arrêté policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

Une politique peut arrêter un build et indiquer quoi corriger. Elle ne modifie jamais vos fichiers pour les faire passer.

#### Builds reproductibles

Même entrée, même sortie, avec chaque dépendance figée dans un fichier de verrouillage.

[Construire un exemple et son fichier de verrouillage](https://aggrega.ai/docs/fr/language-reference/examples/ai-agent-and-model-router/#building)

#### Le catalogue de la bibliothèque standard

Components pour les agents, les modèles, les passerelles, les magasins de données, la messagerie, l’observabilité, la sécurité et le stockage, prêts à l’emploi dans un Aggregate.

[Parcourir le catalogue](https://aggrega.ai/catalog/fr/browse)

### Votre assistant, avec Aggrega

Ce que gagne un assistant qui écrit votre code d’infrastructure en passant par Aggrega.

- **Reproductible** — Même entrée, mêmes fichiers, avec chaque dépendance figée dans un fichier de verrouillage.

- **Une seule description** — Une seule description de l’application, construite pour chaque plateforme sur laquelle elle s’exécute.

- **Des politiques au moment du build** — Vos politiques s’exécutent dans le compilateur et arrêtent un build qui les enfreint.

- **Un catalogue signé et versionné** — Ce qu’un assistant récupère du catalogue est versionné et signé, et la récupération vérifie chaque signature.

- **Vérifié par le compilateur** — L’assistant valide et construit avec le binaire aggrega, et tire de lui ses réponses sur les schémas et les fichiers.

### Cibles

Chaque plateforme reçoit les fichiers qu’elle lit nativement. Les agents IA s’exécutent sur n’importe quel cluster Kubernetes, et beaucoup aussi sur Compose.

- **Kubernetes** — Des manifestes Kubernetes, un fichier par ressource, qu’ArgoCD ou Flux appliquent.

- **Helm** — Des charts Helm, rendus en manifestes Kubernetes.

- **Compose** — Un fichier Docker Compose, pour exécuter l’application sur un ordinateur portable.

- **Terraform** — Une configuration pour des services cloud managés. Aggrega n’exécute jamais Terraform.

- **CloudFormation** — Des modèles de stack pour AWS. Aggrega n’exécute jamais CloudFormation.

[Ce que chaque cible écrit](https://aggrega.ai/docs/fr/language-reference/providers/reference-matrix/)

### Import

aggrega import lit un projet dans l’un de ces formats et écrit des brouillons de fichiers Aggrega que vous relisez et modifiez.

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

aggrega import

brouillons de fichiers Aggrega à relire et à modifier

Votre projet existant en entrée, des brouillons de fichiers Aggrega en sortie. Rien n’est déployé ; vous relisez d’abord les brouillons.

[Fonctionnement de l’import](https://aggrega.ai/docs/fr/authoring/import/)

### Commencer

#### Démarrage rapide

Installez Aggrega, construisez un exemple exécutable, lancez-le sur votre machine, puis faites-le évoluer une étape à la fois.

[Premiers pas](https://aggrega.ai/docs/fr/getting-started/)

#### Exécuter un premier exemple

Chaque exemple exécutable est un espace de travail complet que vous construisez avec la CLI aggrega.

[Parcourir les exemples](https://aggrega.ai/docs/fr/language-reference/examples/)

#### Installer

Une seule commande installe le binaire aggrega pour votre utilisateur, sans droits d’administrateur.

[Installer le binaire](https://aggrega.ai/docs/fr/install/#install-the-binary)

### Open source

Le compilateur Aggrega est open source sous licence Apache-2.0, et le restera : il n’y aura pas d’édition fermée du compilateur, pas d’open-core. Toutes les fonctionnalités du compilateur seront disponibles dans la version open source.

#### Le compilateur

Le binaire aggrega et son interface en ligne de commande.

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

#### Visual Studio Code

Validation, navigation, survol et complétion pour le YAML d’Aggrega, fondés sur le binaire aggrega.

[L’extension sur GitHub](https://github.com/aggrega-ai/aggrega-vscode-extension)
