콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

언어 참조

Aggrega의 “무엇”과 “사용 방법”을 다룹니다. 구문, CLI 호출, 오류 목록, 실습 예제를 담고 있습니다.

처음 이해하려면 아래 장을 순서대로 읽으십시오. 참조 하위 디렉터리는 해당 장 아래에 나열되어 있으므로, 특정 엔티티, 키워드, 프로바이더, CLI 명령 또는 오류를 찾을 때는 바로 이동하면 됩니다.

장을 순서대로 읽기 전에 언어의 현황에서 현재 준비 상태를 확인하십시오. 어떤 언어 요소를 지금 사용할 수 있는지, 어떤 요소가 허용되지만 아직 컴파일러가 처리하지 않는지, 어떤 요소가 향후 반복에서 계획되어 있는지를 설명합니다. 호환성은 릴리스가 스키마, 명령줄, 어시스턴트 도구, 오류 코드, 플러그인 키트에 대해 무엇을 약속하는지 설명합니다.

엔티티 티어 모델

Aggrega의 작성용 엔티티 종류는 도입 단계를 반영하는 세 개의 티어로 구성됩니다(아래 참조). 이와 함께 플랫폼이 소유하는 Workload가 있는데, 이는 독립된 작성용 종류가 아니라 Recipe의 합성된 입력이 취하는 형태로, form: 어휘(stateless, stateful, daemon, scheduled, task, reference)를 통해 컴퓨팅 형태를 표현합니다. 티어 구분은 문서화 및 온보딩을 위한 장치이며 런타임 제약이 아닙니다: 모든 엔티티 종류는 언어의 일급 구성 요소이고, 컴파일러는 이를 동일하게 취급하며, 오픈 소스 Aggrega는 라이선스나 기능 제한 없이 모든 티어를 지원합니다. 티어 표시는 기능이 아니라 탐색을 위해 “고급 항목이므로 필요 없으면 건너뛰어도 됨”을 나타냅니다.

티어엔티티 종류도입 시점
티어 1 — 최소 실행 가능 표면Aggregate, Component, Recipe, Manifest, Release1일 차 — 1인 창업자와 소규모 팀은 티어 1만으로 동작하는 소프트웨어를 출시합니다. 멘탈 모델: “앱이 있고, 이를 배포하고 싶다. 방법은 이렇다.”
티어 2 — 역할 분리Feature, FeatureRecipe, Plugin30일 차 — 역할이 나뉘는 소규모 팀(개발자 + Ops + 때로는 Security). 티어 2는 프로바이더 렌더링 Plugins(Ops가 Helm, helm-chart, Compose, Terraform, CloudFormation 중 선택), Features(Security가 자격 증명을 앱 구성과 별도로 관리), FeatureRecipes(프로바이더별 바인딩 시점 사용자 지정)를 통해 도입됩니다.
티어 3 — Component 간 재사용SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary365일 차 — 공통 형태가 여러 엔티티에 걸쳐 반복되는 성숙한 카탈로그. 기준은 비공식적입니다: 어떤 형태(예: PodResources)가 5개 이상의 Components에 나타나고 업데이트 조율이 부담이 될 때, SchemaLibrary 항목을 둘 가치가 생깁니다.

각 단계는 선택적으로 도입합니다. 1인 창업자가 티어 3을 살펴보도록 강요받는 일은 없으며, 엔터프라이즈 카탈로그는 필요에 따라 티어 3 전체를 사용할 수 있습니다. 티어 1은 1인 창업자 사용 사례에 대해 완전합니다. 개발자는 티어 1 엔티티만으로 동작하는 애플리케이션을 출시할 수 있습니다. 이는 강력한 설계 속성입니다: 티어 1은 “컴파일되는 부분 집합”이 아니라 “소프트웨어를 출시하는 부분 집합”입니다.

다섯 엔티티로 이루어진 티어 1 표면에는 진입 비용이 따릅니다. Aggregate + Component + Recipe + Manifest + Release는 “YAML 파일 하나를 넣으면 실행 중인 서비스가 생긴다”보다 절차가 많습니다. 이 비용은 Aggrega를 순수 Helm이나 순수 Terraform과 구별 짓는 네 영역 작성 분리(Developer Intent / Platform Catalog / Platform Ops / Routing)의 대가입니다. 티어 1 튜토리얼은 다섯 엔티티 설정을 명시적으로 안내합니다.

티어 3 안에서 spec.templates / $instantiate: 메커니즘(SchemaLibrary의 매개변수화된 헬퍼)은 한층 더 고급인 하위 기능으로 문서화되어 있습니다. 대부분의 티어 3 도입자는 처음에는 spec.templates를 사용하지 않으며, 기준은 “라이브러리에 매개변수화된 구조를 공유하는 스키마가 6개 이상일 때”입니다.

읽는 순서

  1. 이 참조 문서 사용 방법
  2. 명명 관례
  3. 엔티티 레퍼런스 개요
  4. 어휘 개요
  5. 템플릿 개요
  6. Providers 개요
  7. CLI 개요
  8. 오류 개요
  9. 예제 개요

Plugin 작성 레퍼런스

Wasm 플러그인 인터페이스는 장(章) 순서 안이 아니라 그 옆에 놓여 있습니다. 플러그인 작성자는 엔터티 작성 경로와 별개로 이를 읽습니다. plugin 엔터티 페이지는 카탈로그 작성 인터페이스를 다루고, 아래 페이지들은 소켓, 페이로드, 작성자 워크플로를 다룹니다.

  • plugin-contract — 플러그인이 연결되는 소켓, 파이프라인에서의 위치, 각 소켓의 입력 및 출력 형태.
  • plugin-developer-guide — 처음부터 끝까지의 작성자 워크플로: describe(), 기능 선언, 런타임 제한, publish/pull/build 수명 주기, 서명, 버전 관리.
  • policy-socket — 거버넌스 소켓 심층 설명: 네 가지 역할, 판정 심각도, 운영자 입력 채널, 컴파일러에 포함된 두 엔진 중 어느 쪽으로든 정책을 작성하는 방법.
  • governance-attachment-facts — 거버넌스 정책이 빌드 그래프에서 읽는 연결별 사실. 민감도 표시의 세 가지 단위와 표시가 없다고 해서 허가를 의미하지 않는 이유를 포함합니다.
  • when-to-use-a-pipeline-step — 파이프라인 단계와 템플릿 기반 FeatureRecipe 중에서 선택하는 방법.
  • embedded-plugins — 컴파일러 바이너리에 포함되어 제공되는 플러그인.
  • tagging-plugins — 정책 없이 레이블을 기록하는 두 가지 기본 제공 거버넌스 플러그인인 governance/label-injector와 governance/selector-tagger의 설정과 각각이 기록하는 내용입니다.
  • core-importers — Langflow, Flowise, n8n부터 Compose, MCP, 에이전트 프레임워크까지 컴파일러의 10가지 임포터: 각 임포터가 읽고 초안으로 작성하는 내용, 설정, 그리고 컴파일러 릴리스마다 함께 게시되는 방식.
  • authoring-a-provider-walkthrough — 빈 디렉터리에서 시작하여 provider가 렌더링한 파일을 기록하는 빌드까지, provider 게스트 작성 과정을 예제로 안내합니다.
  • writing-a-governance-plugin — 플러그인 키트의 어댑터 골격으로 자신만의 거버넌스 플러그인을 작성합니다. 규칙 하나, 각 역할의 export를 직접 실행하기, 워크스페이스 카탈로그의 Plugin 엔티티, 그리고 그 플러그인이 거부하는 빌드를 다룹니다.
  • compatibility — 플러그인 키트의 버전 관리 방식: 키트의 패치 릴리스와 마이너 릴리스가 무엇을 바꿀 수 있는지, 그리고 이미 빌드된 플러그인이 계속 로드되게 하는 것은 무엇인지.