본문으로 건너뛰기
Aggrega

이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

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

Aggrega는 코드형 인프라를 위한 오픈 소스 컴파일러입니다. 애플리케이션을 기술한 하나의 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

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

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

스킬
어시스턴트에게 작성 루프가 어떻게 진행되는지 알려 주고, 스키마나 파일에 관한 모든 답은 aggrega 바이너리에서 얻도록 합니다.
MCP 서버
aggrega mcp는 어시스턴트에게 scaffold, validate, build 등 Aggrega의 도구를 제공합니다.
어시스턴트마다 달라지는 점

작동 방식

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

Aggregate애플리케이션을 기술
Release한 환경의 설정
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 관리.

    하나의 PostgreSQL 데이터베이스, 세 가지 배포 방식
  • Features

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

    모든 요청을 프롬프트 인젝션 여부로 검사하는 게이트웨이
  • 하나의 애플리케이션, 여러 플랫폼

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

    Compose와 Kubernetes용으로 빌드한 하나의 Aggregate
    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는 그대로 유지됩니다.
  • 거버넌스와 정책

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

    하나의 정책, 네 가지 대상에서 검사
    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를 통해 작업하면 얻는 것.

재현 가능
같은 입력, 같은 파일. 모든 의존성은 잠금 파일에 고정됩니다.
하나의 설명
애플리케이션에 대한 하나의 설명을, 실행되는 모든 플랫폼에 맞게 빌드합니다.
빌드 시점의 정책
정책은 컴파일러 안에서 실행되며, 정책을 위반하는 빌드를 중단시킵니다.
서명되고 버전이 관리되는 카탈로그
어시스턴트가 카탈로그에서 가져오는 것은 버전이 관리되고 서명되어 있으며, 가져올 때 각 서명을 검증합니다.
컴파일러가 검사
어시스턴트는 aggrega 바이너리로 검증하고 빌드하며, 스키마와 파일에 관한 답을 바이너리에서 얻습니다.

대상

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

Kubernetes
Kubernetes 매니페스트. 리소스마다 파일 하나로, ArgoCD나 Flux가 적용합니다.
Helm
Kubernetes 매니페스트로 렌더링되는 Helm 차트.
Compose
노트북에서 애플리케이션을 실행하기 위한 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로 빌드하는 완전한 작업 공간입니다.

    예제 둘러보기
  • 설치

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

    바이너리 설치하기

오픈 소스

Aggrega 컴파일러는 Apache-2.0 라이선스의 오픈 소스이며 앞으로도 그렇습니다. 컴파일러의 비공개 에디션은 없을 것이며 open-core 방식도 채택하지 않습니다. 컴파일러의 모든 기능은 오픈 소스 버전에서 제공됩니다.