Aggrega 기능 비종속 그래프(IR) 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 id: https://aggrega.ai/schemas/ir-v1beta1.schema.json
Topology Builder가 출력하는, 평탄화되고 완전히 해석된 1차원 그래프입니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 예 | 상수: "aggrega.ai/v1beta1" |
kind | const “IR” | 예 | 상수: "IR" |
metadata | IRMetadata | 예 | 그래프의 식별 정보: 그래프를 빌드한 원본 Aggregate입니다. |
spec | IRSpec | 예 | 그래프 자체: 노드, 에지, 그리고 노드별로 키가 지정된 페이로드입니다. |
추가 속성은 허용되지 않습니다.
정의
Maintainer
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 메인테이너의 이름입니다. |
email | string | 아니요 | 메인테이너의 이메일 주소입니다. |
url | string | 아니요 | 메인테이너의 웹 주소입니다. |
FieldProvenance
어태치먼트의 values 또는 infra 페이로드에 있는 리프 하나의 출처입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
origin | string | 예 | 리프가 명시적으로 작성되었는지, 아니면 어노테이션 기반 확장 패스가 기여했는지를 나타냅니다. |
side | string | 아니요 | 어노테이션이 선언된 작성 표면입니다. 명시적 리프의 경우 없습니다. |
annotation_key | string | 아니요 | 이 리프를 기여한 어노테이션 이름입니다. 명시적 리프의 경우 없습니다. |
annotation_source | string | 아니요 | |
overridden_annotation | FieldProvenance | 아니요 | 이 리프를 명시적 리프에 내준 어노테이션 기여입니다. 명시적 리프가 어노테이션이 기여한 리프를 덮어쓴 경우, 그것이 대체한 억제된 출처입니다. 단수형입니다. 억제된 기여는 항상 정확히 하나만 보존됩니다. |
추가 속성은 허용되지 않습니다.
AttachmentConnection
어태치먼트가 속한 연결로, component 자체의 어태치먼트 블록이 아니라 component가 그리는 연결에 작성된 어태치먼트에 해당합니다. 연결이 배선되는 소켓과 연결이 작성된 별칭으로 구성됩니다. 이 쌍은 그래프의 엣지 하나를 가리킵니다. 즉, 소스가 어태치먼트를 지닌 노드이고 소켓과 별칭이 이 값인 엣지입니다. 따라서 소비자는 어태치먼트를 그 엣지에 결합하고, 그 엣지를 통해 어태치먼트가 제시되는 대상에 결합합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
socket | string | 예 | 연결이 배선되는 소켓, 즉 어태치먼트가 속한 엣지의 소켓입니다. |
alias | string | 예 | 연결이 작성된 별칭, 즉 어태치먼트가 속한 엣지의 별칭입니다. |
추가 속성은 허용되지 않습니다.
IRFeatureEntry
노드에 대해 해석된 어태치먼트 하나로, feature_values_mapping에 담깁니다. 운영 Feature, 자격 증명 Feature, ID Feature 등 모든 어태치먼트 계열이 이 형태를 공유하므로, 어떤 계열도 다른 계열보다 손실이 큰 투영을 받지 않습니다. 자격 증명 어태치먼트의 values에 무엇을 담을지는 작성자의 선택입니다. 참조 방식 자격 증명은 시크릿 저장소를 가리키는 포인터를, 값 방식 자격 증명은 자료 자체를 담으며, 컴파일러는 어느 쪽이든 작성된 그대로 담고 어느 쪽도 해석하지 않습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
type | string | 예 | 이 어태치먼트가 요청하는 Catalog Feature의 URI입니다. |
resolved_version | string | 예 | 컴파일 중에 해석된 정확한 시맨틱 버전입니다. |
labels | string 맵 | 아니요 | 어태치된 Feature의 카탈로그 레이블로, 카탈로그 엔티티가 선언한 순서대로 그대로 담깁니다. 필터링, 정규화, 접두사 제거를 전혀 하지 않으므로 소비자는 카탈로그 작성자가 작성한 내용을 정확히 읽습니다. 컴파일러는 이 중 어느 것도 읽지 않습니다. Feature가 레이블을 선언하지 않은 경우와 그 타입이 어떤 카탈로그 엔티티로도 해석되지 않는 경우에는 없습니다. |
catalog_annotations | string 맵 | 아니요 | 어태치된 Feature의 카탈로그 어노테이션, 즉 이 어태치먼트가 가리키는 Feature 엔티티의 metadata.annotations로, 그 엔티티가 선언한 순서대로 그대로 담깁니다. 필터링, 정규화, 접두사 제거를 전혀 하지 않으므로 소비자는 작성자 고유 네임스페이스의 키를 포함해 카탈로그 작성자가 작성한 내용을 정확히 읽습니다. 컴파일러는 이 중 어느 것도 읽지 않습니다. 이 어태치먼트를 애초에 존재하게 만든 어노테이션의 이름과 위치를 나타내는 annotation_key 및 annotation_source와는 다릅니다. 그 두 필드는 어태치먼트가 어떻게 생겨났는지를 보고하고, 이 필드는 어태치먼트가 가리키는 엔티티의 메타데이터를 보고합니다. features: 블록에 작성된 어태치먼트는 그 두 필드 중 어느 것도 담지 않지만 이 어노테이션은 담습니다. Feature가 어노테이션을 선언하지 않은 경우와 그 타입이 어떤 카탈로그 엔티티로도 해석되지 않는 경우에는 없습니다. |
binding | string | 아니요 | 이 어태치먼트가 채우는 어태치먼트 슬롯의 이름이며, 선언된 슬롯을 채우지 않으면 “free”입니다. 슬롯은 두 곳 중 한 곳에 선언되며, 어태치먼트가 작성된 위치에 따라 어느 쪽인지가 정해집니다. 노드 자체의 어태치먼트 블록에 있는 어태치먼트는 호스트 Component가 featuresSchema에 선언한 슬롯을 채우고, 연결에 작성된 어태치먼트는 호스트 Component에서 연결의 소켓이 그 소켓의 featuresSchema에 선언한 슬롯을 채웁니다. 두 경우 모두 이름으로 짝을 짓습니다. component의 블록에서든 연결에서든 Feature가 슬롯의 이름으로 어태치되면 어태치먼트가 그 슬롯을 채웁니다. 따라서 값은 선언된 슬롯 집합의 정확한 키이며, 어태치먼트의 키에서 읽어낸 것이 아닙니다. 소켓의 슬롯 집합은 닫혀 있습니다. 소켓이 선언하지 않은 이름으로 연결에 작성된 어태치먼트는 빌드를 중단시키므로, 연결을 지닌 어태치먼트는 free를 보고하지 않습니다. 단순한 불리언 대신 슬롯 이름을 담는 이유는 어떤 슬롯이 채워졌는지가 답의 더 유용한 절반이기 때문입니다. 호스트 Component의 선언된 슬롯 집합을 해석할 수 없는 경우 비어 있으며, 이는 “free”와 다릅니다. free는 이 이름을 지닌 선언된 슬롯이 없다는 긍정적 판정입니다. |
values | object | 아니요 | 어태치먼트의 운영 구성 페이로드입니다. 자격 증명의 경우 작성자가 선언한 형식, 즉 시크릿 저장소를 가리키는 포인터 또는 자료 자체입니다. |
infra | object | 아니요 | 이 어태치먼트의 인스턴스별 물리적 크기 지정입니다. |
inject | object | 아니요 | 구애받지 않는 주입 라우팅입니다. 로컬 변수를 Target의 provides 키에 매핑합니다. |
origin | string (enum) | 아니요 | features: 블록에 작성된 어태치먼트(explicit)와 어노테이션 기반 확장 패스가 생성한 합성 어태치먼트(annotation)를 구분하며, 어태치먼트의 value/infra 리프에 두 가지가 섞여 있으면 mixed입니다(이때 리프별 세부 정보는 provenance 맵에 있습니다). 허용 값: "explicit", "annotation", "mixed" |
annotation_key | string | 아니요 | 합성 어태치먼트를 트리거한 어노테이션 이름입니다. origin이 explicit이면 없습니다. |
annotation_source | string | 아니요 | |
values_provenance | FieldProvenance 맵 | 아니요 | values 페이로드의 리프별 출처로, 점으로 구분된 리프 경로를 키로 합니다. |
infra_provenance | FieldProvenance 맵 | 아니요 | infra 페이로드의 리프별 출처로, 점으로 구분된 리프 경로를 키로 합니다. |
sensitive | 불리언 | 아니요 | 이 어태치먼트가 작성자가 민감하다고 선언한 자료를 다루면 true입니다. 즉, 어태치된 Feature가 values, infra 또는 provides 기둥에 민감한 리프를 선언하거나, 어태치먼트가 채우는 슬롯이 담는 자료를 민감하다고 선언한 경우입니다. 그 슬롯은 같은 이름의 호스트 Component 어태치먼트 슬롯이거나, 연결에 작성된 어태치먼트의 경우 연결의 소켓이 선언한 그 이름의 슬롯입니다. 병합된 어태치먼트에 대한 이러한 선언에서 도출되며, 값의 내용이나 이름에서 도출되지 않습니다. 두 선언 모두 없으면 설정되지 않습니다. |
sensitive_inject | string 맵의 맵 | 아니요 | 참조하는 provides 키를 어태치된 Feature가 민감하다고 선언한 inject의 전달 키로, inject와 같은 형태입니다. 메커니즘, 그다음 전달 키이며, 참조하는 provides 키가 값입니다. inject의 부분 집합입니다. 어태치먼트가 전달 메커니즘을 선언하지 않거나 민감한 provides 키를 참조하지 않으면 없습니다. |
sensitive_payload_leaves | string[] | 아니요 | 이 attachment의 values 및 infra 페이로드가 담고 있는 리프 중 attach된 Feature가 sensitive로 선언한 리프로, 각각 해당 데이터가 위치한 pillar 접두사가 붙은 점 구분 경로 values.db의 선언은 db.password를 포함하지만 dbPassword라는 이름의 형제 리프에는 미치지 않습니다. attachment 단위의 답은 개별 리프로 펼쳐지지 않습니다. 그렇게 하면 읽을 수 있는 상태로 남은 리프에 대해 거짓을 주장하게 되기 때문입니다. 키가 없다는 것은 이 attachment가 자신의 Feature가 sensitive로 선언한 리프를 지명하지 않는다는 뜻입니다. 이는 페이로드가 민감하지 않다고 주장하지 않으며, 지명할 그런 리프가 없는 attachment와 이 축을 전혀 보고하지 않는 생산자를 구분하지도 않습니다. 키가 없는 것을 값을 평문으로 표시하거나 내보내도 된다는 허가로 읽는 게스트는 의미를 거꾸로 읽은 것입니다. 리프는 페이로드가 담고 있는 순서대로, values pillar의 리프가 infra pillar의 리프보다 먼저 옵니다. 이는 values 및 infra 페이로드 자체가 담는 순서와 같으며, 동일한 입력의 실행 간에 페이로드가 바이트 단위로 동일하게 유지되는 근거입니다. attachment가 자신의 Feature가 sensitive로 선언한 리프를 담지 않으면 없습니다. |
connection | AttachmentConnection | 아니요 | 이 attachment가 속한 connection입니다. 노드의 connection 중 하나에 작성된 모든 attachment에는 있고, 노드 자체의 attachment 블록에 있는 모든 attachment에는 없습니다. connection에 작성된 attachment는 그 밖의 모든 면에서 노드의 attachment 중 하나입니다. 즉 connection의 alias와 slot을 점으로 이은 정규화된 이름을 키로 가지며, 바인딩과 sensitivity를 connection의 socket이 선언한 slot에서 가져옵니다. 따라서 이 필드가 둘을 구분하며, connection을 키에서 읽어 내도록 남겨 두지 않고 데이터로 담습니다. 소비자는 socket과 alias로 이를 그래프의 edge와 연결합니다. source가 이 attachment를 가진 노드이고 socket과 alias가 이 값들인 edge가 attachment가 제시되는 connection이며, 그 edge의 target이 제시 대상입니다. Feature attachment가 그리는 connection의 attachment에는 이 필드가 없습니다. 그런 connection은 attachment를 담지 않기 때문입니다. |
realization | string | 아니요 | 이 attachment를 실현하는 FeatureRecipe로, |
추가 속성은 허용되지 않습니다.
IRFeatureEntry.inject
구애받지 않는 주입 라우팅입니다. 로컬 변수를 Target의 provides 키에 매핑합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
env | string 맵 | 아니요 | 환경 변수 전달입니다. 키는 소비자의 로컬 변수 이름이고, 값은 대상의 provides 키입니다. |
file | string 맵 | 아니요 | 파일 마운트 전달입니다. 키는 소비자의 로컬 파일 경로이고, 값은 대상의 provides 키입니다. |
arg | string 맵 | 아니요 | 명령줄 인수 전달입니다. 키는 소비자의 플래그 접두사이고, 값은 대상의 provides 키입니다. |
IRBoundaryFeature
IR에 투영된 boundary 수준의 Feature attachment입니다. Feature 타입 URI와, boundary 범위 FeatureRecipe가 렌더링하고 source를 해석하는 기준이 되는 boundary infra로 구성됩니다. boundary 수준 attachment는 values 페이로드를 담지 않습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
type | string | 예 | 이 boundary에 attach된 카탈로그 Feature의 URI입니다. |
infra | object | 아니요 | boundary attachment의 물리적 크기 설정입니다. boundary 범위 FeatureRecipe가 템플릿과 source를 평가하는 기준이 되는 infra입니다. |
sensitive_payload_leaves | string[] | 아니요 | 이 boundary attachment의 infra 페이로드가 담고 있는 리프 중 attach된 Feature가 sensitive로 선언한 리프로, 각각 해당 데이터가 위치한 pillar 접두사가 붙은 점 구분 경로로 표시됩니다. boundary 수준 attachment는 values 페이로드를 담지 않으므로 여기에는 infra.db의 선언은 db.password를 포함하지만 dbPassword라는 이름의 형제 리프에는 미치지 않습니다. 키가 없다는 것은 이 attachment가 자신의 Feature가 sensitive로 선언한 리프를 지명하지 않는다는 뜻이며, attach된 Feature가 이 리더가 읽을 수 있는 스키마로 해석되지 않는 경우도 포함합니다. 이는 infra 페이로드가 민감하지 않다고 주장하지 않으며, 지명할 그런 리프가 없는 attachment와 이 축을 전혀 보고하지 않는 생산자를 구분하지도 않습니다. 키가 없는 것을 값을 평문으로 표시하거나 내보내도 된다는 허가로 읽는 소비자는 의미를 거꾸로 읽은 것입니다. 리프는 페이로드가 담고 있는 순서대로 나열되며, 이는 infra 페이로드 자체가 담는 순서와 같고 동일한 입력의 실행 간에 그래프가 바이트 단위로 동일하게 유지되는 근거입니다. attachment가 자신의 Feature가 sensitive로 선언한 리프를 담지 않으면 없습니다. |
realization | string | 아니요 | 이 boundary attachment를 실현하는 FeatureRecipe로, |
추가 속성은 허용되지 않습니다.
CatalogMetadata
카탈로그 엔터티에서 명시적으로 추출한 Enterprise Metadata Suite로, 라이프사이클 및 소유권 데이터를 Wasm 린터에 제공합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
maintainers | Maintainer[] | 아니요 | 카탈로그 엔티티가 자신의 소유자로 나열하는 메인테이너입니다. |
license | string | 아니요 | 카탈로그 엔티티가 자신이 설명하는 소프트웨어에 대해 선언하는 SPDX 라이선스 식별자입니다. |
repository | string | 아니요 | 카탈로그 엔티티가 소스 파일을 보관하는 곳으로 지정한 Git 저장소의 URL입니다. |
home | string | 아니요 | 카탈로그 엔티티의 홈페이지, wiki 또는 문서의 URL입니다. |
keywords | string[] | 아니요 | 카탈로그 엔티티가 선언하는 설명용 키워드입니다. |
추가 속성은 허용되지 않습니다.
IRNode
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
description | string | 아니요 | 애플리케이션에서 이 component 인스턴스의 역할을 설명하는, 개발자가 작성한 선택적 문서입니다. 렌더링과 lint 진단을 위해 Aggregate에서 그대로 전달됩니다. |
labels | string 맵 | 예 | 엔티티의 덕 타이핑 및 온톨로지 레이블입니다. |
component | string | 예 | 기반이 되는 Component의 이름입니다. |
resolved_version | string | 예 | 컴파일 중에 확정된 Component의 정확한 Semantic Version입니다. |
sync_wave | integer | 아니요 | 이 노드를 포함하는 경계의 syncWave 필드에서 상속된 배포 웨이브입니다(기본값 0, 음수 허용). K8s와 Helm에서는 웨이브가 배포 순서를 정합니다. 웨이브는 argocd.argoproj.io/sync-wave 어노테이션이 되며, 차트가 이미 Helm 훅으로 표시한 리소스에서는 해당 훅의 helm.sh/hook-weight도 됩니다. compose에서는 이 값이 서비스 레이블로 기록되는 동시에, 렌더링되는 파일의 서비스들 사이에 depends_on을 두어 그 순서를 정합니다. cloudformation에서는 디스패치 그룹이 조립되는 스택의 프로비저닝 순서를 정하며, 각 웨이브의 모든 리소스가 바로 앞 웨이브의 리소스에 의존하도록 선언됩니다. 이는 리소스가 생성되는 순서이자, 역순으로는 삭제되는 순서이며, 준비 상태(readiness)를 뜻하지는 않습니다. 스택 템플릿에는 리소스가 준비되었다는 개념이 없기 때문입니다. terraform에서는 경계가 조립되는 루트 구성의 module 블록 순서를 정하며, 각 웨이브의 모든 모듈이 바로 앞 웨이브의 모듈에 의존하도록 선언됩니다. 이는 엔진이 작업을 수행하는 순서이며, 준비 상태를 뜻하지는 않습니다. 구성에는 리소스가 준비되었다는 개념이 없기 때문입니다. 이 값은 노드의 빌드 출처 정보와 함께 전달되기도 합니다. |
boundary_path | string | 아니요 | 이 노드가 배치된 Release 경계의 경로입니다. 가장 바깥 경계부터 안쪽으로 경계 이름을 /로 이어 붙인 것입니다(예: 경계 data 안에 선언된 경계 inner에 배치된 컴포넌트의 경우 ‘data/inner’). 경계 이름에는 /를 포함할 수 없으므로 경로는 모호함 없이 다시 경계들로 분리됩니다. Release가 경계로 라우팅하는 가져온 Aggregate의 노드는 해당 경계의 경로를 가집니다. 렌더링 플러그인이 경계를 인식하는 고유 식별자를 생성할 수 있게 합니다. |
subsystem_path | string | 아니요 | 이 노드의 컴포넌트가 선언된 Aggregate 서브시스템의 경로입니다. 가장 바깥 서브시스템부터 안쪽으로 서브시스템 이름을 .으로 이어 붙인 것입니다(예: 서브시스템 backend 안에 중첩된 서브시스템 storage에 선언된 컴포넌트의 경우 ‘backend.storage’). 서브시스템 이름에는 .을 포함할 수 없으므로 경로는 모호함 없이 다시 서브시스템들로 분리됩니다. 최상위 components를 선언하는 Aggregate의 컴포넌트는 합성된 default를 가지며, 이는 synthesized_subsystem으로 표시됩니다. 경로는 해당 컴포넌트를 선언한 Aggregate를 기준으로 합니다. 가져온 Aggregate가 제공하는 노드는 가져올 때 사용한 이름 없이 그 Aggregate 내부의 경로를 가지므로(예: 가져온 Aggregate의 서브시스템 tier에 있는 컴포넌트의 경우 ‘tier’), 서로 다른 Aggregates의 노드가 같은 경로를 공유할 수 있습니다. 가져오기 이름으로 시작하는 노드의 ID와 source_file로 이들을 구별합니다. |
synthesized_subsystem | 불리언 | 아니요 | 이 노드의 서브시스템이 컴파일러에 의해 합성되었을 때 true입니다. 즉 이름 있는 subsystems 대신 최상위 components를 선언하는 Aggregate에 대해 생성된 default 서브시스템입니다. 작성되는 값이 아니라 도출되는 출처 정보로, 합성된 default와 사용자가 명시적으로 default라고 이름 붙인 서브시스템을 구별합니다. synthesized_boundary와는 독립적입니다(노드는 어느 한 축 또는 두 축 모두에서 합성될 수 있습니다). 작성된 모든 서브시스템에서는 없습니다(false). |
synthesized_boundary | 불리언 | 아니요 | 이 노드의 경계가 컴파일러에 의해 합성되었을 때 true입니다. 즉 이름 있는 boundaries 대신 최상위 components를 선언하는 Release에 대해 생성된 default 경계입니다. 작성되는 값이 아니라 도출되는 출처 정보로, 합성된 default와 사용자가 명시적으로 default라고 이름 붙인 경계를 구별하며, 노드의 아티팩트를 dist/boundaries/default/ 대신 dist/에 평면적으로 배치합니다. 작성된 모든 경계에서는 없습니다(false). |
catalog_metadata | CatalogMetadata | 아니요 | 카탈로그 엔터티에서 명시적으로 추출한 Enterprise Metadata Suite로, 라이프사이클 및 소유권 데이터를 Wasm 린터에 제공합니다. |
catalog_annotations | string 맵 | 아니요 | Domain 2에서 플랫폼 아키텍트가 작성한, 변경할 수 없는 컴포넌트 고유의 특성입니다. |
release_annotations | string 맵 | 아니요 | Release의 경계에서 하위로 전파되는 물리적 토폴로지 문자열과 운영상의 실제 조건입니다. |
aggregate_annotations | string 맵 | 아니요 | Aggregate의 서브시스템에서 하위로 전파되는 인지 메타데이터, 개발자 의도 및 FinOps 정보입니다. |
self_inject | object | 아니요 | Aggregate에서 가져온 Component 수준의 자기 inject 블록으로, 노드가 자신에게 선언하는 구애받지 않는 주입 라우팅입니다. 이 스키마 계층에서는 불투명하며, 이를 읽는 정책 플러그인이 바이트를 파싱합니다. |
source_file | string | 아니요 | 이 노드가 작성된 Aggregate 파일의 워크스페이스 기준 상대 경로입니다. 루트 계층 노드는 루트 Aggregate의 경로를, 하위 aggregate 노드는 가져온 Aggregate의 파일 경로를 가집니다. 경로는 워크스페이스 루트(.aggrega-config.yaml이 있는 디렉터리)를 기준으로 한 상대 경로이므로, 워크스페이스가 서로 다른 절대 경로에 있는 머신에서도 그래프가 바이트 단위로 동일합니다. 파일별로 진단을 필터링하는 소비자는 비교 전에 같은 워크스페이스 루트를 기준으로 이 필드를 해석합니다. 워크스페이스 루트 없이 그래프가 빌드된 경우에는 없습니다. |
uses | object | 아니요 | 작성된 그대로의 노드 uses 블록입니다. 각 소켓 이름은 대상 인스턴스 이름의 목록 또는 별칭을 키로 하는 연결 항목 맵에 대응하며, 작성자가 선언한 순서를 따릅니다. 이는 작성된 그대로의 블록으로, edges의 확정된 연결과는 다른 사실입니다. 작성자가 채운 소켓은 연결을 만들지 않은 경우에도 여기에 나타나므로, 작성자가 채운 소켓과 대상에 도달하는 소켓을 구별할 수 있습니다. 노드에 작성된 uses 블록이 없으면 없습니다. 이 스키마 계층에서는 불투명하며, 이를 읽는 정책 플러그인이 바이트를 파싱합니다. |
sensitive_payload_leaves | string[] | 아니요 | 이 노드의 values 및 infra 페이로드가 담고 있는 리프 중 해당 Component가 민감하다고 선언한 리프로, 각각 데이터가 위치한 기둥 접두사가 붙은 점 구분 경로(values.db에 대한 선언은 db.password를 포괄하지만 dbPassword라는 이름의 형제 리프에는 미치지 않습니다. 키가 없다는 것은 이 노드가 해당 Component가 민감하다고 선언한 리프를 하나도 표시하지 않는다는 뜻이며, 여기에는 노드의 Component가 이 판독기가 읽을 수 있는 스키마로 해석되지 않는 경우도 포함됩니다. 이는 노드의 페이로드가 민감하지 않다고 단언하지 않으며, 표시할 리프가 없는 노드와 이 축을 전혀 보고하지 않는 생성자를 구별하지도 않습니다. 키가 없는 것을 값을 평문으로 표시하거나 내보내도 된다는 허가로 읽는 소비자는 이를 거꾸로 읽은 것입니다. 리프는 페이로드가 보유한 순서대로, values 기둥의 리프가 infra 기둥의 리프보다 먼저 나타납니다. 이는 해당 페이로드들 자체가 담는 순서와 같으며, 동일한 입력에 대한 실행 간에 그래프를 바이트 단위로 동일하게 유지하는 요소입니다. 노드가 해당 Component가 민감하다고 선언한 리프를 담지 않으면 없습니다. |
추가 속성은 허용되지 않습니다.
IREdge
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
source | string | 예 | 연결이 시작되는 소비 노드의 ID입니다. |
target | string | 예 | 연결이 도달하는 노드의 ID입니다. |
socket | string | 아니요 | 이 엣지가 속한 usesSchema 카테고리입니다(예: ‘databases’, ‘tools’). |
alias | string | 아니요 | 이 연결에 대해 개발자가 정의한 별칭입니다(예: ‘primary_db’). |
socket_declaration | string (enum) | 예 | 소켓의 출처입니다. 소켓을 소유한 카탈로그 엔터티(소비하는 Component, 또는 Feature가 작성한 엣지의 경우 원래의 Feature)가 usesSchema에 그 소켓을 나열하면 declared이고, Aggregate 작성자가 카탈로그가 선언하지 않은 소켓을 지정하면 ad-hoc입니다. 이는 엣지 작성 주체와 독립적인 세 번째 축입니다. 누가 엣지를 그렸는지가 아니라 소켓이 어디서 왔는지를 나타내므로, 선언된 소켓으로 향하는 Release 작성 엣지와 ad-hoc 소켓으로 향하는 Aggregate 작성 엣지는 두 축에서 각각 독립적으로 다릅니다. 선언된 소켓은 엣지가 도달할 수 있는 대상을 제한하는 셀렉터를 포함한 usesSchema 항목을 가집니다. ad-hoc 소켓은 카탈로그 항목이 없으므로 셀렉터도 없으며, 엣지가 전달할 수 있는 내용은 대상이 선언한 provides로만 제한됩니다. 항상 존재하므로 소비자는 값이 없는 것을 declared로 해석할 필요가 없으며, 정책은 모든 엣지가 declared이도록 요구할 수 있습니다. 첨부의 바인딩 마커와는 구별되며, 바인딩 마커는 다른 대상에 대해 같은 형태의 질문에 답합니다. 허용 값: "declared", "ad-hoc" |
origin_feature | string | 아니요 | 이 엣지가 Feature에 의해 자율적으로 선언된 경우(feature.aggrega.ai/kind: secret 레이블이 붙은 자격 증명 Features 포함), Feature 타입 URI를 식별합니다. Wasm 플러그인이 자신의 토폴로지를 분리할 수 있게 합니다. |
origin_feature_instance | string | 아니요 | 이 엣지를 선언한 Feature의 첨부별 인스턴스 이름입니다. 경계 범위 FeatureRecipe의 해석된 provides를 인스턴스로 찾아, 한 경계에 있는 같은 Feature 타입의 두 첨부를 구별합니다. |
origin_release | 불리언 | 아니요 | 이 엣지가 선언되었지만 바인딩되지 않은 소켓을 기존 컴포넌트에 연결하는 Release에 의해 생성된 경우 true입니다. 구성이 아니라 엣지 작성 주체를 표시합니다. Release가 infra만 제공한 개발자 선언 엣지는 Aggregate 출처로 유지됩니다(origin_release 미설정, 해당 Release infra는 엣지의 infra 맵에 나타남). origin_feature 설정 => Feature 출처, origin_release true => Release 출처, 둘 다 아님 => Aggregate 출처. |
values | object | 아니요 | 이 엣지에 대해 해석된 연결별 개발자 값(Aggregate 엣지에서 옴)으로, 해석 시 소스 소켓(소비하는 컴포넌트의 소켓이며 엣지의 소스)이 선언한 valueSchema에 대해 검증되고 소비 노드의 렌더링 컨텍스트의 .context.uses. |
infra | object | 아니요 | Release 엣지 항목이 제공하는, 이 엣지에 대해 해석된 연결별 infra로, 해석 시 소스 소켓(소비하는 컴포넌트의 소켓이며 엣지의 소스)이 선언한 infraSchema에 대해 검증되고 .context.uses. |
inject | object | 아니요 | 구애받지 않는 주입 라우팅입니다. 로컬 변수를 Target의 provides 키에 매핑합니다. |
sensitive_payload_leaves | string[] | 아니요 | 이 엣지의 values와 infra가 담고 있는 리프 중, 그것들이 작성된 대상인 소켓이 sensitive로 선언한 리프로, 각각 해당 데이터가 위치한 pillar 접두사가 붙은 점 구분 경로 values.db의 선언은 db.password를 포함하지만 db_password라는 이름의 형제 리프에는 미치지 않습니다. 선언된 sensitive 값을 그래프에서 감추는 표면은 이 엣지의 values와 infra에 있는 이 리프들을 감추며, 같은 연결에 대한 소비 노드의 uses 항목에서도 감춥니다. 그 항목은 작성자가 작성한 그대로 값을 담고 있기 때문입니다. 키가 없다는 것은 이 엣지가 자신의 소켓 계약이 sensitive로 선언한 리프를 지명하지 않는다는 뜻이며, 소켓이 이 독자가 읽을 수 있는 계약을 선언하지 않은 경우도 포함합니다. 이는 구성이 민감하지 않다고 주장하지 않으며, 키가 없는 것을 값을 평문으로 표시하거나 내보내도 된다는 허가로 읽는 소비자는 의미를 거꾸로 읽은 것입니다. 리프는 페이로드가 담고 있는 순서대로, values pillar의 리프가 infra pillar의 리프보다 먼저 옵니다. 이것이 동일한 입력의 실행 간에 그래프가 바이트 단위로 동일하게 유지되는 근거입니다. 엣지가 자신의 소켓 계약이 sensitive로 선언한 리프를 담지 않으면 없습니다. |
추가 속성은 허용되지 않습니다.
IREdge.inject
구애받지 않는 주입 라우팅입니다. 로컬 변수를 Target의 provides 키에 매핑합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
env | string 맵 | 아니요 | 환경 변수 전달입니다. 키는 소비자의 로컬 변수 이름이고, 값은 대상의 provides 키입니다. |
file | string 맵 | 아니요 | 파일 마운트 전달입니다. 키는 소비자의 로컬 파일 경로이고, 값은 대상의 provides 키입니다. |
arg | string 맵 | 아니요 | 명령줄 인수 전달입니다. 키는 소비자의 플래그 접두사이고, 값은 대상의 provides 키입니다. |
IRMetadata
그래프의 식별 정보: 그래프를 빌드한 원본 Aggregate입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
aggregate_name | string | 예 | Aggregate의 metadata.name입니다. |
추가 속성은 허용되지 않습니다.
IRProvenance
진단과 감사를 위한 추적성 메타데이터입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
schema_version | string | 예 | 그래프가 따르는 IR 스키마의 버전으로, aggrega.ai/v1beta1이며 그래프의 apiVersion이 담는 값과 같습니다. |
compiler_version | string | 예 | 필수 준수 스탬프입니다. 이 그래프를 빌드한 aggrega 바이너리를 그 버전으로 식별합니다. |
aggregate_version | string | 예 | 컴파일 중 사용된 루트 Aggregate 의도의 정확한 시맨틱 버전입니다. |
manifest_version | string | 예 | 컴파일 중 사용된 Manifest 잠금 파일의 정확한 시맨틱 버전입니다. |
release_version | string | 예 | 컴파일 중 사용된 Release 라우팅 파일의 정확한 시맨틱 버전입니다. |
추가 속성이 허용됩니다.
IRSpec
그래프 자체: 노드, 에지, 그리고 노드별로 키가 지정된 페이로드입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
nodes | IRNode 맵 | 예 | 그래프의 모든 노드를 절대 ID로 키를 지정한 딕셔너리입니다. 순수하게 토폴로지적입니다. 키: 하나 이상의 문자, 숫자, 밑줄, 점 또는 하이픈. 패턴: ^[a-zA-Z0-9_.-]+$. |
edges | IREdge[] | 예 | 노드 간의 명시적인 논리 네트워크 경로와 의존성입니다. |
values_mapping | object | 예 | 불투명하게 통과되는 인지 페이로드에 대한 단일 정보원으로, 노드 ID별로 매핑됩니다. |
infra_mapping | object | 예 | Release에서 주입된 물리적 사이징 페이로드로, 노드 ID별로 매핑됩니다. |
feature_values_mapping | IRFeatureEntry 맵의 맵 | 예 | 노드 ID를 첨부된 Feature 구성에 매핑한 정규화된 맵입니다. 하나의 버킷이 무엇을 생성하든 노드의 모든 첨부(운영 Features, 자격 증명 Features, ID Features)를 담으며, 작성자가 각 첨부에 부여한 인스턴스 이름으로 키가 지정됩니다. 노드의 연결 중 하나에 작성된 첨부는 연결의 별칭과 슬롯을 점으로 결합한 정규화된 이름으로 키가 지정되며, 자신의 connection 필드에 해당 연결을 명시합니다. 키: 하나 이상의 문자, 숫자, 밑줄, 점 또는 하이픈. 패턴: ^[a-zA-Z0-9_.-]+$. |
boundary_features | IRBoundaryFeature 맵의 맵 | 아니요 | 각 경계의 Feature 첨부로, 경계 경로와 인스턴스 이름 순으로 키가 지정됩니다. 그래프에 경계 수준 Feature 첨부가 있을 때만 존재합니다. 키: 하나 이상의 문자, 숫자, 밑줄, 점, 슬래시 또는 하이픈. 패턴: ^[a-zA-Z0-9_./-]+$. |
provenance | IRProvenance | 예 | 진단과 감사를 위한 추적성 메타데이터입니다. |
추가 속성은 허용되지 않습니다.
IRGraph
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 예 | 상수: "aggrega.ai/v1beta1" |
kind | const “IR” | 예 | 상수: "IR" |
metadata | IRMetadata | 예 | 그래프의 식별 정보: 그래프를 빌드한 원본 Aggregate입니다. |
spec | IRSpec | 예 | 그래프 자체: 노드, 에지, 그리고 노드별로 키가 지정된 페이로드입니다. |
추가 속성은 허용되지 않습니다.