생태계 철학
생태계 철학
Aggrega 아키텍처는 유연성과 예측 가능성의 균형을 맞추는 핵심 설계 원칙을 따릅니다. 명확한 경계와 표준화된 계약을 유지함으로써, 근본적으로 범용적인 컴파일러가 표준 클라우드 네이티브 인프라부터 고도로 전문화된 AI 인텔리전스까지 모든 것을 매끄럽게 오케스트레이션할 수 있습니다.
1. 핵심 메커니즘: 아키텍처의 물리학
- 관심사의 분리(콘웨이의 법칙): 개발자는 물리적 인프라 코드를 작성하지 않고, Ops는 애플리케이션 로직을 하드코딩하지 않습니다. 아키텍처의 지침은 작성 작업을 도메인 주도(Domain-Driven) 경계로 나누며, 컴파일러는 이 분리를 강제하지 않습니다(불변 조건 7 참조).
- 지연 바인딩(의존성 역전): 개발자는 특정 구현(예:
helm-chart-v2)이 아니라 추상 인터페이스(예:type: enterprise-agent)를 요청합니다. Manifest 정의가 컴파일 시점에 인터페이스를 올바른 구현으로 해석하므로, 단일 소스 파일에서 진정한 멀티 타깃 배포가 가능합니다. - AOT 순수성(라이브 클라우드 조회 없음): 컴파일러는 라이브 클라우드에 구애받지 않습니다. 컴파일 중에 인프라 API에 인증하거나 라이브 IP 주소를 가져오지 않습니다. 완전히 제어 역전을 기반으로 동작하며, 결정론적 포인터를 매핑하고 추상적인 주입 계약을 사전에 전달하여 런타임 환경이 최종 물리적 연결을 안전하게 해석할 수 있도록 합니다.
2. 개발자 경험: 의도와 추상화
- 시맨틱 개발자 경험(5-키워드 맵 표준): 인지적 마찰을 막기 위해 개발자는 맵 기반 YAML 토폴로지 안에서 누구나 이해할 수 있는 키워드 정확히 다섯 개를 사용합니다.
parameters: 전역 환경 계약(예: 동적 디스크 크기 전달).values: 핵심 인지/비즈니스 로직 페이로드(개발자 소유).uses: 명시적으로 선언된 네트워크 엣지와 의존성(개발자 소유).infra: 물리적 풋프린트와 기계적 사이징(Ops 소유, Aggregate 안에서는 금지).inject: 로컬 변수를 대상의 provides 키(env,file,arg)에 매핑하는 엄격한 전달 계약입니다. 이 메커니즘은 확장 가능합니다.
- 역량에 구애받지 않는 용어: 기반 인프라의 현실(예: Kubernetes 용어
namespace)이 개발자 경험으로 스며드는 것을 막기 위해, 플랫폼은boundaries와 같은 보편적인 개념을 사용합니다. - 명시적 의도와 “시끄러운 가드레일”(유령 인프라 없음): 컴파일러는 개발자가 명시적으로 선언하지 않은 컴퓨트나 기능을 절대 만들어 내서는 안 됩니다. 정책 엔진을 사용해 보안 프록시를 조용히 주입하면 “유령 인프라”가 생깁니다. 그것이 고장 나면 개발자는 결국 자신의 YAML에 존재하지도 않는 프록시를 디버깅하게 됩니다. Wasm 정책 플러그인은 아키텍처를 조용히 변경하는 대신 엄격하게 시끄러운 가드레일로 동작합니다. 토폴로지가 보안을 위반하면 컴파일러는 빌드를 중단하고 매우 구체적인 오류를 반환하여(예: “오류: PII 데이터가 AI 게이트웨이
router를 통해 모델 제공자로 흐르고 있습니다. 여기에core/data-masking기능을 명시적으로 연결해야 합니다”), 개발자가 자신의 단일 진실 공급원을 직접 고치도록 강제합니다.
3. 주관이 없는 컴파일러: 처리와 오케스트레이션
- 프로그래밍 가능한 정책(주관이 없는 컴파일러): 핵심 Go 컴파일러는 내용에 중립적인 계산 메커니즘입니다. YAML을 파싱하고, 그래프를 순회하며, 레이블 교집합을 평가합니다. 실제 “지능”(예: 제한된 데이터를 전달하는 모델 트래픽이 민감한 텍스트를 마스킹하는 AI 게이트웨이를 반드시 통과하도록 강제하는 것)은 기업이 플러그 가능한 WebAssembly(Wasm) 소켓을 사용해 동적으로 프로그래밍하며, 이 소켓은 추상 구문 트리(AST) 변경—파싱된 메모리 내 구성 표현을 바꾸는 것—과 정책 검증에 사용됩니다.
- 스키마 비의존성(오픈 소스 사전): 핵심 컴파일러는 물리적 실행 계층에 구애받지 않습니다. Helm, Terraform, Docker Compose용 스키마를 하드코딩하고 있지 않습니다. 대신 Ops Recipe의
source블록은 열린 사전이며, 그 키는 프로바이더가 정의하고 Recipe의 템플릿에.source.*로 노출됩니다. 핵심은 가져오는 source를 기본 제공{ kind, url, version }형식으로 해석합니다(kind:helm-oci-chart,helm-https-chart,compose-https-fragment,git-repository). 이는 이미 컴파일러를 그것이 다루는 클라우드 언어로부터 분리합니다. 가져오기 모델은 Recipesource참조를 확인하십시오. - 명시적 Plugin 오케스트레이션: 핵심 Go 컴파일러는 엄격하게 중립적인 그래프 빌더로 동작하며 노드를 어떻게 처리할지 절대 추측하지 않습니다. 대신 모든 도메인 인텔리전스는 전용 WebAssembly (Wasm) 소켓을 통해 두 가지 다른 수준에서 명시적으로 오케스트레이션됩니다.
1. 전역 소켓: 기업 정책과 포매팅은 명시적으로 등록된 컴파일러 소켓이 평가합니다(예: 메타데이터 자동 태깅을 위한 거버넌스 역할
label-transform, 토폴로지 보안을 위한 거버넌스 판정 역할, 최종 아티팩트 생성을 위한 렌더러 소켓). 2. 구현 파이프라인: Component 단위의 변형 로직은Manifest가 오케스트레이션합니다. 추상 인터페이스가 구체적인Recipe로 해석되면, 해당 구현은 실행할 Wasm 플러그인의 순차적pipeline배열을 명시적으로 선언합니다. 컴파일러는 역량에 구애받지 않는 중간 표현(IR) 그래프를 이렇게 정의된 소켓에 공급할 뿐이며, 이를 통해 모든 도메인별 로직이 컴파일러 코어에 하드코딩되지 않고 생태계 안에서 엄격하게 버전 관리되도록 보장합니다. - 평면 컴파일과 Feature 원자성: Aggrega 시스템은 상태를 관리하지 않고, 엔드포인트에 핑을 보내지 않으며, 롤아웃이 끝나기를 기다리지도 않습니다. 컴파일러는 중첩된 모듈을 평가하여 평면적인 1차원 중간 표현(IR) 그래프로 해석한 다음, 데이터를 Wasm 렌더링 플러그인에 전달합니다. 결정적으로, 그래프가 평면화되더라도 컴파일러는 Feature 원자성을 보존합니다. 프록시 기능이 보안 볼트로 향하는 네트워크 엣지를 자율적으로 선언하면, 컴파일러는 그 엣지의 의미적 출처를 기록하여 Wasm 정책 엔진이 연결을 부모 컴포넌트에 잘못 귀속시키지 않고 $O(1)$ 조회를 실행할 수 있도록 합니다. 마지막으로, 시간적 순서 지정을 지원하기 위해 Release 정의 안의 각 경계는
syncWave: <integer>값을 가집니다. 각 렌더링 플러그인은 경계별 웨이브를 자신의 대상이 순서를 표현하는 수단(다운스트림 GitOps 컨트롤러가 읽는 실행 순서 어노테이션, 또는 렌더링하는 파일 내 서비스 간의 의존성)으로 변환하며, 순서를 표현할 수단이 전혀 없는 대상은 웨이브를 기록만 하고 그에 따른 순서 지정은 하지 않습니다.
4. 시맨틱 온톨로지: 식별과 분류 체계
- 운영적 클라우드 네이티브 온톨로지: 오픈 소스 Wasm 플러그인과 기업 정책이 보편적으로 상호 운용될 수 있도록,
component.aggrega.ai/type레이블은 보편적인 클라우드 프리미티브의 닫힌 집합(server,worker,task,function,stateful-server,resource)에만 매핑됩니다. 이것은 Aggrega 고유의 키입니다. 게시된 Component 스키마가 이 키가 가질 수 있는 값을 열거하며, 그 밖의 값을 담은 문서는 로드 시 거부됩니다. 이 어휘를 중앙에서 고정하는 것이야말로, 자율적인 정책 엔진과 커뮤니티가 만든 Wasm 렌더링 플러그인이 어느 쪽 작성자도 작성하지 않은 Component 항목을 만났을 때 같은 형태에 대해 같은 단어를 읽도록 보장하는 방법입니다. 그래도 컴파일러는 문자열에서 아무것도 추론하지 않습니다. 값을 셀렉터와 대조할 뿐이며 스스로 아무것도 프로비저닝하지 않습니다. 닫힌 집합이 주는 것은 모두의 셀렉터가 같은 어휘와 대조된다는 점입니다. - Aggrega 시스템이 정의하지 않는 축으로 분류하기: 닫힌 집합은 이 하나의 예약된 키에만 적용됩니다. 자체 분류(티어, 데이터 영역, 서비스 등급, 프리미티브의 더 세밀한 구분 등)가 필요한 카탈로그는 예약된 키 옆에 자체 레이블 키를 작성합니다. Component 스키마는 문자열 값을 가진 추가 레이블 키를 모두 허용하고, 모든 셀렉터 지점이 그 키를 같은 방식으로 읽기 때문입니다. 확장은 Aggrega 키 내부가 아니라 사용자 자신의 키에서 이루어지며, 그 덕분에 공유 어휘가 어긋나지 않으면서 기업 어휘가 확장될 수 있습니다.
- 덕 타이핑(레이블을 통한 의미적 특성): 기본 타입이 순수하게 클라우드 네이티브라면, 모든 인지, 운영, 컴플라이언스 인텔리전스는 전적으로 의미적 덕 타이핑을 통해 계층화됩니다. Platform Architect가 작성한 레이블(예:
model.aggrega.ai/capability: generative,compliance.aggrega.ai/data-class: restricted)이 노드의 실제 정체성 역할을 합니다. Features 항목은 이러한 레이블 셀렉터를 기반으로 컴포넌트에 동적으로 바인딩됩니다.
5. 엔터프라이즈 거버넌스: 스키마와 상속
-
엄격한 API 분할과 엔터프라이즈 검색 가능성: Kubernetes 표준에 따라 모든 페이로드 정의는 일관되게
spec:블록 안에 위치합니다. 리소스 식별 정보, 특성 레이블, 명시적인 컴파일러 지시는 엄격하게metadata:블록 안에 위치합니다. 엄격한 해석을 보장하기 위해, 공유 가능한 모든 YAML 아티팩트에는 정규식으로 검증되는 SemVerversion문자열이 엄격하게 의무화됩니다. 또한 OCI 레지스트리에서의 검색 가능성과 수명 주기 거버넌스를 지원하기 위해,metadata블록은 선택적인 엔터프라이즈 메타데이터 모음을 지원합니다. 이 모음에는description, 구조화된maintainers객체 배열(name, email, url),license,repository,home(문서 URL),keywords(검색 색인용)가 포함됩니다. 지원 종료는 문서 밖에서 관리됩니다.aggrega deprecate는 이미 게시된 아티팩트에, 게시된 바이트를 변경하지 않고 서명된 사용 중단 마커(심각도, 이유, 선택적 대체 항목)를 첨부합니다. -
스키마 확장성(Kubernetes CRD 패턴): 새로운 AI 또는 인프라 기능이 나올 때마다 핵심 컴파일러 스키마를 업데이트하지 않도록, 플랫폼은 구성을 검증하는 데 JSON Schema 2020-12를 사용합니다. Platform Architect는 엄격한 타입, 검증 로직, 기본값을 카탈로그 컴포넌트의
schema:블록에 직접 작성합니다. 보통은 필드별 제약을 한 줄에 담는 YAML 형태의 축약 표기인 컴팩트 형식(port: { type: integer, min: 1, max: 65535, default: 8080 })으로 작성하며, 이는 검증이 실행되기 전에 JSON Schema 2020-12로 컴파일됩니다. 전체 어휘가 필요한 스키마에는 완전한 JSON Schema YAML도 동등한 작성 방식으로 계속 사용할 수 있습니다. Component 간 스키마 재사용의 이점을 얻을 만큼 커진 카탈로그는 공통 형태(프로브 블록, 리소스 한도, 이름 있는 포트 형태)를 전용 SchemaLibrary 엔터티로 옮기고 JSON Schema$ref:키워드로 참조합니다. -
스키마 상속(페이로드 기준선): 기준선을 한 번만 작성하도록, 플랫폼은 상속을 두 개의 서로 다른 계층으로 나눕니다. 표준 YAML 메타데이터(시맨틱 레이블 포함),
Manifest매핑,Release구성은 필요한 환경별 재정의를 허용하기 위해 전통적인 병합 전략을 사용합니다. 페이로드 스키마(schema:)는 그런 방식으로 병합되지 않으며, 두 카탈로그 종류는 여기서 갈라집니다. Feature 정의의schema:는 JSON Schema 2020-12 합성 의미론에 따라 기반 스키마와 합성되며, 워크스페이스 로드 시 소스 위치 출처 태깅을 수행하는 병합기가 이를 순회하므로 병합된 스키마의 모든 리프가 원래 파일 정보를 지닙니다. 반면 확장하는 Component 정의는 페이로드 내용을 전혀 작성하지 않습니다. 리터럴 마커schema: inherited를 쓰고, 체인의 어느 깊이에서든 기반이 작성한 블록을 그대로 받습니다. 따라서 Component 기준선은 정책이 아니라 구조 자체로 보장됩니다. 자식의 계약은 그냥 기반의 계약이므로, 자식이 완화할 것이 아무것도 없습니다. 그런 Component 정의가 대신 합성하는 것은 구조(연결 슬롯, 토폴로지 소켓, 자기 주입 허용 목록, 이름 있는assertions)이며, 기반이 선언한 것보다 더 엄격한 규칙이 필요한 자식은 이를 추가assertions:항목으로 표현합니다. 이 항목은 기반의 규칙을 대체하지 않고 그 옆에 함께 유지됩니다. 더 넓은 범위의 토폴로지 보안과 레이블 거버넌스는 여전히 Wasm 거버넌스 소켓에 적절히 위임됩니다. -
인터페이스 동등성과 자동 구현: 아키텍트가 기본 Component의 약간 변형된 버전을 만들 때 Ops가 Recipe YAML을 복제하지 않도록, 기본을 대상으로 작성된 Recipe는 체인의 어느 깊이에서든 이를 확장하는 모든 Component를 처리합니다. 확장하는 Component는
schema: inherited를 작성하므로, 기본의 Recipe가 소비할 수 없는 루트 키를values/infra/provides에 추가하지 않습니다. Manifest는 여전히 확장된 타입을 자체 항목으로 매핑하며, 매핑 검사는 매핑된 Recipe의implements가 해당 타입이나 그것이 확장하는 어떤 기본을 지정하면 그 항목을 받아들입니다(기본을 대상으로 작성된 Recipe는 이를 확장하는 모든 것을 처리합니다 참조). 유령 인프라 추적기(바인딩된 Recipe가 선언한 어떤 템플릿도 작성된 키를 읽지 않을 때 경고를 내보내 “유령 인프라”를 방지함)가 이에 대응하는 렌더링 단계의 가드레일입니다. -
implements버전 매칭: Recipes 및 FeatureRecipes 정의의implements필드는 엄격성과 생태계 유연성의 균형을 맞추기 위해 세 가지 형식을 지원합니다.- 정확한 버전:
implements: "core/api-server:1.0.0"—1.0.0에만 일치합니다. 특정 스키마 버전과 긴밀하게 결합된 Recipes 정의를 위한 형식입니다. - 메이저 호환(SemVer 범위):
implements: "core/api-server:^1.0.0"—>=1.0.0, <2.0.0에 일치합니다. Component 버전의 SemVer 호환성 보장에 의존하는 Recipes 정의를 위해 설계되었습니다. SemVer에 따라 마이너 및 패치 증가는 하위 호환된다고 가정하며, 컴파일러는 Component의 버전이 해당 범위를 충족하는지 확인합니다. - 버전 없음:
implements: "core/api-server"— 모든 버전에 일치합니다. 진정으로 버전과 무관한 Recipes 정의를 위한 형식입니다(예:.context.inject.env만 사용하고 버전별values필드는 사용하지 않는 범용 worker Recipe 정의).
implements는 Recipe를 선택하지 않습니다. Manifest가 각 컴포넌트 타입의 Recipe를 지정하고, 컴파일러는 매핑된 Recipe의implements가 세 가지 형식 중 하나로 해당 타입을 받아들이는지 확인하며, 일치하지 않으면 중단합니다. 컴포넌트 타입에 매핑이 없을 때 컴파일러가 후보 Recipes를 제안하는 것도 같은 선언을 통해서입니다.이 세 가지 형식의 패턴을 통해 Recipes 정의는 Component 스키마와의 실제 결합 정도에 맞는 버전 계약을 선언할 수 있습니다. 특정 스키마 버전에 긴밀하게 묶인 Recipes 정의는 정확하게 고정하고, Component 버전의 SemVer 호환성 보장에 의존하는 Recipes 정의는 메이저 호환 범위를 사용하며, 동작이 Component 버전에 전혀 의존하지 않는 Recipes 정의는 버전 없이 유지합니다. 그 결과, Component 버전의 마이너 증가 때문에 Ops가 Component 버전을 고정하거나 버전별로 병렬 Recipes 정의를 유지해야 하는 일이 없어집니다.
- 정확한 버전: