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

Aggrega Wasm 정책 소켓 스키마

자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.

스키마 id: https://aggrega.ai/schemas/wasm-policy-v1beta1.schema.json

판정 역할에 연결된 거버넌스 플러그인이 소비하는 와이어 형태(ir-verdict 역할에서는 PolicyInput, render-verdict 역할에서는 RenderPolicyInput)와 내보내는 와이어 형태(PolicyOutput)입니다. halt 심각도의 판정은 빌드 시점 진단과 함께 빌드를 중단하고, warn 또는 info 판정은 보고된 뒤 빌드가 계속됩니다. IR 단계 입력 그래프는 기능에 구애받지 않는 전체 IR 그래프로, 여기서 다시 선언하지 않고 ir-v1beta1.schema.json에서 참조하므로 정책 플러그인은 컴파일러와 동일한 노드, 엣지, 연결 세부 정보를 봅니다. 플러그인 작성자는 IR 스키마 버전을 추적해야 합니다. 렌더 단계 입력은 그래프 대신 렌더링된 출력 파일을 담습니다. Go, Rust, TypeScript 페이로드 타입은 이 스키마로부터 plugin-ABI 패키지에 생성되므로 세 언어는 하나의 와이어를 읽고 씁니다. 게스트는 이 타입을 해당 패키지에서, 또는 플러그인 키트가 다시 내보내는 경우 플러그인 키트를 통해 가져옵니다.

다음 형태 중 하나

  • PolicyInput
  • RenderPolicyInput
  • PolicyOutput

정의

PolicyInput

정적 분석이 정책 소켓에 전달하는 페이로드입니다. 전체 IR 그래프(Topology Builder가 내보내는 것과 동일한 형태)와 함께 분석기가 열거한 사전 계산된 라우팅 경로를 담습니다.

속성타입필수설명
graphIRGraph예ir-v1beta1.schema.json을 단일 출처로 하는, 기능에 구애받지 않는 전체 IR 그래프입니다. 정책 플러그인은 좁은 투영이 아니라 완전한 노드/엣지/연결 세부 정보를 기반으로 추론합니다.
precalculated_pathsPrecalculatedPath[]예정책이 그래프를 다시 순회하지 않고 도달 가능성을 추론할 수 있도록 분석기가 미리 열거한 라우팅 경로입니다.
sourcesPolicySource[]아니요호스트가 컴파일 시점에 읽어 플러그인에 그대로 전달하는 정의 파일로, 경로순으로 정렬된 순서 있는 목록입니다. 호스트는 바이트를 불투명한 내용으로 읽으며 파싱하지 않습니다. 연결이 소스를 선언하지 않으면 없습니다.
settingsobject아니요호스트가 플러그인에 그대로 전달하는 자유 형식 설정 객체입니다. 호스트는 그 내용을 파싱하거나 그에 따라 동작하지 않습니다. 연결이 설정을 선언하지 않으면 없습니다.

추가 속성은 허용되지 않습니다.

PolicyOutput

정책 플러그인이 내보내는 응답 형태입니다. 평가 중에 발생한 판정을 담으며, 발생한 판정마다 진단이 하나씩 있습니다. 허용 규칙은 아무것도 내보내지 않으므로, 빈 results 배열은 발생한 판정이 없음을 의미합니다.

속성타입필수설명
resultsDiagnostic[]예발생한 판정으로, 판정마다 진단이 하나씩이며 플러그인이 내보낸 순서를 따릅니다. 발생한 판정이 없으면 비어 있습니다.
errorstring아니요게스트가 실행되었지만 작업을 완료하지 못했을 때 설정되는 실패 메시지이며, 성공 시에는 없습니다. 출력이 담는 진단과는 구별됩니다. 진단은 결과를 생성한 실행 중에 발견된 문제를 보고하는 반면, error는 작업 자체가 완료되지 않았음을 보고합니다. 호스트는 error가 있으면 플러그인 호출 실패로 표시합니다.

추가 속성은 허용되지 않습니다.

RenderPolicyInput

render-verdict 역할에 연결된 거버넌스 플러그인이 받는 페이로드로, IR 그래프 대신 정책이 추론 대상으로 삼는 렌더링된 출력 파일을 담습니다.

속성타입필수설명
artifactsRenderedArtifact[]예정책이 추론 대상으로 삼는 렌더링된 출력 파일로, 동일한 입력의 실행 간에 와이어가 바이트 단위로 동일하도록 경로순으로 정렬된 순서 있는 목록입니다.
sourcesPolicySource[]아니요호스트가 컴파일 시점에 읽어 플러그인에 그대로 전달하는 정의 파일로, 경로순으로 정렬된 순서 있는 목록입니다. 호스트는 바이트를 불투명한 내용으로 읽으며 파싱하지 않습니다. 연결이 소스를 선언하지 않으면 없습니다.
settingsobject아니요호스트가 플러그인에 그대로 전달하는 자유 형식 설정 객체입니다. 호스트는 그 내용을 파싱하거나 그에 따라 동작하지 않습니다. 연결이 설정을 선언하지 않으면 없습니다.

추가 속성은 허용되지 않습니다.

RenderedArtifact

렌더링된 출력 파일 하나입니다. 그 경로와 해당 경로의 렌더링된 내용으로 구성됩니다.

속성타입필수설명
pathstring예렌더 루트를 기준으로 한 렌더링된 파일의 출력 경로입니다.
contentstring예이 경로의 렌더링된 내용입니다.
treeany아니요이 아티팩트의 파싱된 구조화 트리로, 호스트가 플러그인에 전달하기 전에 내용을 파싱한 경우에 존재합니다. 플러그인이 기본적으로 읽지 못하는 소스 형식의 정식 JSON 뷰입니다(예: JSON으로 파싱된 HCL 아티팩트). 최상위 수준은 파싱된 문서 자체의 형태에 맞춰 객체, 배열 또는 스칼라일 수 있습니다. 호스트가 아티팩트를 파싱하지 않은 경우에는 없으며, 이때 플러그인은 원래 내용을 직접 읽습니다. 호스트는 트리를 불투명하게 전달하며, 내용을 해석하지 않고 그대로 담습니다.
formatstring아니요아티팩트가 렌더링된 형식으로, 생성한 provider가 이를 선언한 경우에 존재합니다. 생성한 provider가 형식을 선언하지 않으면 없습니다.

추가 속성은 허용되지 않습니다.

PolicySource

플러그인에 전달되는 정의 파일 하나입니다. 기본 이름 경로와 파일 내용으로 구성됩니다. 둘 다 그대로 전달되며, 호스트는 내용을 파싱하지 않습니다.

속성타입필수설명
pathstring예소스 파일의 기본 이름입니다. 호스트는 절대 호스트 경로가 아닌 기본 이름만 제공하므로 와이어는 이식 가능하고 결정론적입니다.
contentstring예불투명한 string으로 그대로 전달되는 소스 파일의 내용입니다.

추가 속성은 허용되지 않습니다.

PrecalculatedPath

정책 규칙이 그래프를 다시 순회하지 않고 도달 가능성을 추론할 수 있도록 분석기가 구체화한, 미리 열거된 라우팅 경로 하나입니다.

속성타입필수설명
path_idstring예이 경로의 안정적인 식별자로, 동일한 입력의 실행 간에 결정론적입니다.
nodesstring[]예경로가 소스에서 종단까지 거치는 노드 ID의 순서 있는 시퀀스입니다.
attached_featuresstring[]예경로상의 모든 노드에 연결된 Feature 타입 URI의 알파벳순 정렬 합집합입니다. 집합 소속 의미론을 따르므로, 여러 노드가 같은 Feature를 담더라도 한 번만 나타납니다. 경로상의 어떤 노드도 Feature 연결을 담지 않으면 비어 있습니다.

추가 속성은 허용되지 않습니다.