# Aggrega

> Aggrega는 코드형 인프라를 위한 오픈 소스 컴파일러입니다. 애플리케이션을 기술한 하나의 YAML이 직접 검토하고 소유하는 Kubernetes, Helm, Compose, Terraform 또는 CloudFormation 파일이 됩니다.

URL: https://aggrega.ai/ko/

## 아키텍처는 한 번만 기술하세요. 운영하는 각 플랫폼의 인프라 코드를 얻으세요.

Aggrega는 코드형 인프라를 위한 오픈 소스 컴파일러입니다. 애플리케이션을 기술한 하나의 YAML이 직접 검토하고 소유하는 **Kubernetes**, **Helm**, **Compose**, **Terraform** 또는 **CloudFormation** 파일이 됩니다.

이미 **LangGraph**, **CrewAI**, **n8n**, **Dify** 등으로 에이전트를 만드셨나요? 가져오세요.

[AI 어시스턴트로 설정하기](https://aggrega.ai/ko/#ai-assistant)[빠른 시작](https://aggrega.ai/docs/ko/getting-started/)[프로젝트 가져오기](https://aggrega.ai/ko/#import)

Linux 및 macOS

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

Windows, PowerShell에서

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

한 단계씩 만들어 가는 두 가지 빠른 시작 예제: 로컬 모델로 동작하는 AI 에이전트와 PostgreSQL을 쓰는 웹 앱입니다. 각 단계는 변경하는 파일과 추가하는 줄, 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 서버에 연결되어 있습니다. 그렇지 않으면 MCP 서버를 추가하는 방식대로, `https://aggrega.ai/docs/ai-assistants/mcp-server/`에서 자신에 대해 설명하는 대로 Aggrega MCP 서버(명령 `aggrega mcp`)에 자신을 연결하세요. 플러그인이나 서버를 불러오는 데 재시작이나 다시 로드가 필요하면 제가 무엇을 해야 하는지 알려 주세요.

4. 연결되면 인수 없이 `describe-capabilities` 도구를 호출하고, 그 도구가 나열하는 내용을 요약하세요.

**프롬프트 전체 보기**

- **스킬** — 어시스턴트에게 작성 루프가 어떻게 진행되는지 알려 주고, 스키마나 파일에 관한 모든 답은 aggrega 바이너리에서 얻도록 합니다.

- **MCP 서버** — aggrega mcp는 어시스턴트에게 scaffold, validate, build 등 Aggrega의 도구를 제공합니다.

[어시스턴트마다 달라지는 점](https://aggrega.ai/docs/ko/ai-assistants/set-up/)

### 작동 방식

애플리케이션을 기술하면 Aggrega가 파일을 작성하고, 이미 사용하는 도구가 그 파일을 배포합니다. Aggrega는 실행 중인 클러스터나 클라우드 계정에 접근하지 않습니다.

Aggregate 애플리케이션을 기술

Release 한 환경의 설정

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/ko/language-reference/examples/envoy-ai-gateway-token-budget/)

#### 기존 워크로드

PostgreSQL, MariaDB, Redis, Kafka, Keycloak 같은 데이터베이스, 캐시, 메시지 브로커, ID 관리.

[하나의 PostgreSQL 데이터베이스, 세 가지 배포 방식](https://aggrega.ai/docs/ko/language-reference/examples/postgres-three-realizations/)

#### Features

애플리케이션을 건드리지 않고 환경별로 연결하는 기능. 예를 들어 프롬프트 인젝션 방어, 민감한 데이터 마스킹, HTTPS 인그레스, 모니터링, 백업이 있습니다.

[모든 요청을 프롬프트 인젝션 여부로 검사하는 게이트웨이](https://aggrega.ai/docs/ko/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### 하나의 애플리케이션, 여러 플랫폼

같은 Aggregate로 노트북의 Docker Compose용과 프로덕션의 Kubernetes용을 모두 빌드합니다. 대상을 바꾸면 코드가 아니라 매핑이 바뀝니다.

[Compose와 Kubernetes용으로 빌드한 하나의 Aggregate](https://aggrega.ai/docs/ko/language-reference/examples/mariadb-adminer/)

aggregate.yaml 한 번만 작성

노트북에서

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는 그대로 유지됩니다.

#### 거버넌스와 정책

정책을 컴파일러에 연결하면, 정책을 위반하는 빌드를 중단하고 무엇을 고쳐야 하는지 알려 줍니다.

[하나의 정책, 네 가지 대상에서 검사](https://aggrega.ai/docs/ko/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/ko/language-reference/examples/ai-agent-and-model-router/#building)

#### 표준 라이브러리 카탈로그

에이전트, 모델, 게이트웨이, 데이터 저장소, 메시징, 관측성, 보안, 스토리지를 위한 Components로, Aggregate에서 바로 사용할 수 있습니다.

[카탈로그 둘러보기](https://aggrega.ai/catalog/ko/browse)

### Aggrega와 함께하는 어시스턴트

인프라 코드를 작성하는 어시스턴트가 Aggrega를 통해 작업하면 얻는 것.

- **재현 가능** — 같은 입력, 같은 파일. 모든 의존성은 잠금 파일에 고정됩니다.

- **하나의 설명** — 애플리케이션에 대한 하나의 설명을, 실행되는 모든 플랫폼에 맞게 빌드합니다.

- **빌드 시점의 정책** — 정책은 컴파일러 안에서 실행되며, 정책을 위반하는 빌드를 중단시킵니다.

- **서명되고 버전이 관리되는 카탈로그** — 어시스턴트가 카탈로그에서 가져오는 것은 버전이 관리되고 서명되어 있으며, 가져올 때 각 서명을 검증합니다.

- **컴파일러가 검사** — 어시스턴트는 aggrega 바이너리로 검증하고 빌드하며, 스키마와 파일에 관한 답을 바이너리에서 얻습니다.

### 대상

각 플랫폼은 기본적으로 읽는 형식의 파일을 받습니다. AI 에이전트는 모든 Kubernetes 클러스터에서 실행되며, 상당수는 Compose에서도 실행됩니다.

- **Kubernetes** — Kubernetes 매니페스트. 리소스마다 파일 하나로, ArgoCD나 Flux가 적용합니다.

- **Helm** — Kubernetes 매니페스트로 렌더링되는 Helm 차트.

- **Compose** — 노트북에서 애플리케이션을 실행하기 위한 Docker Compose 파일.

- **Terraform** — 관리형 클라우드 서비스를 위한 구성입니다. Aggrega는 Terraform을 실행하지 않습니다.

- **CloudFormation** — AWS용 스택 템플릿입니다. Aggrega는 CloudFormation을 실행하지 않습니다.

[각 대상이 작성하는 파일](https://aggrega.ai/docs/ko/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/ko/authoring/import/)

### 시작하기

#### 빠른 시작

Aggrega를 설치하고, 실행 가능한 예제를 빌드하고 내 컴퓨터에서 실행한 다음, 한 단계씩 확장해 나갑니다.

[시작하기](https://aggrega.ai/docs/ko/getting-started/)

#### 첫 예제 실행하기

실행 가능한 각 예제는 aggrega CLI로 빌드하는 완전한 작업 공간입니다.

[예제 둘러보기](https://aggrega.ai/docs/ko/language-reference/examples/)

#### 설치

명령 하나로 관리자 권한 없이 aggrega 바이너리를 사용자 계정에 설치합니다.

[바이너리 설치하기](https://aggrega.ai/docs/ko/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)
