Aggrega Release별 lockfile 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 id: https://aggrega.ai/schemas/lockfile-v1beta1.schema.json
이후의 빌드를 결정적으로 수행하기 위해 Release에서 해석된 모든 URI를 고정하는, 기계가 생성하는 lockfile입니다. <release-stem>.yaml 옆의 <release-stem>.lock에 위치하며, aggrega pull --release <release>가 생성하고 aggrega build --release <release>가 사용합니다. 두 가지 출처(provenance) 형태가 의존성 그래프에서 서로 다른 두 가지 관계를 기록합니다. referenced_from(문자열 목록)은 entities에 나타나 점으로 구분된 작성 위치 경로로서 각 URI가 Release / Aggregate / Manifest / .aggrega-config.yaml의 어느 위치에서 포함되었는지를 기록하고, plugins에도 나타나 아티팩트에 도달하는 데 거친 각 Plugin 엔터티의 참조를 기록합니다. consumers({consumer_uri, fragments} 레코드 목록)는 schema_libraries, mapping_libraries, workload_libraries, artifact_libraries에 나타나며, 어떤 카탈로그 엔터티가 라이브러리의 어떤 <entry-name> 프래그먼트를 참조하는지를 기록합니다. 이 구조화된 형태 덕분에 Release를 다시 해석하지 않고도 라이브러리 버전 변경이 어떤 소비자에게 영향을 주는지 diff로 추적할 수 있습니다. 스키마 발전 원칙: 새 최상위 섹션을 추가하는 것은 SemVer-MINOR(추가적 변경)이고, 기존 섹션 안에 새 필드를 추가하는 것은 SemVer-MINOR이며, 키를 제거하거나 제약을 강화하는 것은 SemVer-MAJOR입니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
entities | object[] | 아니요 | 이 Release에서 도달할 수 있는 카탈로그 엔터티: Component, Feature, Recipe, FeatureRecipe, Plugin, Aggregate, Release 자신의 Aggregate와 Manifest, 그리고 그 Manifest가 확장하는 Manifest. 각 항목은 kind와 정규 URI를 함께 사용해 식별되므로, 이름을 공유하는 서로 다른 종류의 두 엔터티(예를 들어 둘 다 imported/flow라는 이름의 Aggregate와 Manifest)는 두 개의 항목이 되며, 각각 자신의 다이제스트에 대해 검증됩니다. 각 항목은 확인된 버전, 엔터티가 담고 있는 내용의 다이제스트, 그리고 해당 URI를 Release의 의존성 클로저로 끌어들인 작성 위치 출처(referenced_from)를 기록합니다. 항목에 kind가 없는 잠금 파일은 오래된 것입니다. aggrega pull --release <release>가 이를 다시 작성합니다. 기본값: [] |
external_inputs | ExternalInput[] | 아니요 | 획득 시점에 내용 주소 기반 입력 저장소에 고정된 원격 입력으로, 원격 스키마 문서나 벤더링되지 않은 차트 의존성처럼 provider 플러그인의 렌더링이 워크스페이스 바깥에서 가져와 사용하는 내용입니다. 각 항목은 하나의 URL을 저장소에서 그 바이트를 가리키는 다이제스트에 고정합니다. 빌드는 고정된 입력을 저장소에서 제공하며, 네트워크 접근 없이 이 섹션을 읽습니다. 기본값: [] |
generated_at | string | 예 | 이 lockfile을 생성한 pull의 RFC 3339 타임스탬프입니다. lockfile을 로드할 때 패턴이 값을 이 형식으로 제한합니다. 진단용 출처 정보로, 해석이 이루어진 실제 시각을 기록합니다. pull할 때마다 의도적으로 바뀌며, lockfile의 바이트 동일성 보장에 포함되지 않습니다. 패턴: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
mapping_libraries | LibraryEntry[] | 아니요 | Release의 의존성 클로저가 Recipe / FeatureRecipe의 valuesMapping: { $import: ... } 위치를 통해 도달하는 MappingLibrary 항목입니다. 각 항목의 consumers 목록은 어떤 카탈로그 엔터티가 라이브러리의 어떤 <entry-name> 조각을 참조하는지 기록합니다. 이 구조화된 기록 덕분에 Release를 다시 해석하지 않고도 라이브러리 버전 업데이트의 영향 diff를 추적할 수 있습니다. 기본값: [] |
mutators | object[] | 아니요 | 확인된 transform 역할 거버넌스 연결로, 작성된 순서를 따릅니다. transform 역할 플러그인(노드 레이블을 다시 쓰는 label-transform, 또는 확장 전에 어노테이션을 주입하는 annotation-transform)은 렌더링된 출력 바이트를 결정하므로, 연결 집합(순서가 있는 목록과, 연결마다 역할, 플러그인 좌표, export 함수)은 여기에 고정되는 바이트 결정 입력입니다. 빌드는 집합, 순서, 역할, export 함수를 재구성할 때 .aggrega-config.yaml이 아니라 이 섹션을 읽으므로, pull 이후에 이루어진 plugins.governance 변경(다음 pull에서만 반영됨)은 빌드 출력에 영향을 주지 않습니다. 순서는 의미를 가집니다. 각 transform 실행기는 자기 역할의 연결을 목록 순서대로 적용하므로, URI 순으로 정렬되는 plugins / providers 섹션과 달리 이 목록은 절대 재정렬되지 않습니다. 플러그인의 내용 다이제스트는 여기에 중복 기록되지 않습니다. 다이제스트는 plugins와 entities 섹션에만 기록되며, 이 레코드는 식별자로 그 섹션을 가리킵니다. 기본값: [] |
plugins | object[] | 아니요 | 바이트가 렌더링된 출력을 결정하는 Wasm 플러그인으로, 각각 .wasm의 콘텐츠 다이제스트로 고정됩니다. .aggrega-config.yaml plugins.governance 아래에 transform 역할(label-transform, annotation-transform)로 연결된 governance 플러그인과, 참조된 Recipes / FeatureRecipes / Providers에 포함된 플러그인 URI가 해당합니다. verdict 역할(ir-verdict, render-verdict)로 연결된 governance 플러그인과 plugins.linter 연결은 verdict를 반환할 뿐 출력 바이트를 결정하지 않으므로 둘 다 고정되지 않습니다. 둘 다 여기에도 entities 아래에도 나타나지 않으며, verdict 연결이 읽는 규칙 파일은 verdict_inputs 아래에 기록됩니다. 기본값: [] |
providers | object[] | 아니요 | 확인된 capability별 provider 선택입니다. 각 항목은 하나의 capability(예: helm)를 그것을 렌더링하는 provider 렌더링 플러그인의 다이제스트 없는 OCI 식별자에 고정하며, 이는 pull 시점에 .aggrega-config.yaml의 plugins.providers 목록(capability를 제공하는 플러그인이 여럿일 때) 또는 유일하게 제공하는 플러그인(모호하지 않을 때)에서 확인됩니다. 빌드는 provider를 선택할 때 .aggrega-config.yaml이 아니라 이 섹션을 읽으므로, pull 이후의 워크스페이스 구성 변경은 빌드 출력에 영향을 주지 않습니다. 플러그인의 내용 다이제스트는 여기에 중복 기록되지 않습니다. 다이제스트는 plugins와 entities 섹션에만 기록되며, 이 레코드는 식별자로 그 섹션을 가리킵니다. 버전 공존은 유지됩니다. 이 레코드는 capability별로 플러그인 저장소를 선택하고, 구체적인 버전은 entities(확인된 플러그인 버전마다 항목 하나)에 있으며, 각 Recipe의 spec.capability 버전 고정이 렌더링 시점에 그중 하나를 선택합니다. 기본값: [] |
release | string | 예 | 이 lockfile에 대응하는 Release의 경로로, lockfile 자신의 디렉터리를 기준으로 해석됩니다(예: ./release-prod.yaml). Release별 명명 관례에 따라 <release-stem>.lock은 <release-stem>.yaml 옆에 놓입니다. 상대 경로 덕분에 lockfile은 머신별 절대 경로 없이도 스스로를 설명합니다. 이 값은 Release를 가리킬 뿐이며, 해석 시점에 Release가 담고 있던 내용은 release_documents 아래에 기록됩니다. |
release_documents | object[] | 아니요 | 해석 과정에서 읽은 Release 파일로, 각각 바이트의 내용 다이제스트로 기록됩니다. 이 lockfile이 속한 Release가 먼저 오고, 그 뒤에 이 Release가 확장하는 각 Release가 extends 체인을 따라가는 순서대로 옵니다. Release가 요청하는 모든 것은 그 Release가 담고 있는 내용에서 해석되므로, pull 이후에 편집된 Release는 기록된 다이제스트와 더 이상 일치하지 않으며, 빌드나 aggrega pull --verify는 무엇이든 렌더링하기 전에 해당 파일을 지목하고 aggrega pull --release <release>를 해결 방법으로 제시하며 중단됩니다. 다이제스트는 아무것도 정규화하지 않은 있는 그대로의 바이트를 대상으로 하며, 이는 Aggregate와 Manifest 고정이 따르는 규칙과 같습니다. 주석이나 공백만 편집해도 변경으로 간주됩니다. 이 섹션이 없는 lockfile은 Release 파일을 기록하지 않으며, 그런 lockfile을 가진 빌드는 Release가 기록되지 않았다고 보고합니다. Release가 parameters를 통해 가져오는 파일은 여기에 기록되지 않습니다. |
schema_libraries | LibraryEntry[] | 아니요 | Release의 의존성 클로저가 엔터티의 schema: / usesSchema: / featuresSchema: 내용에 있는 $ref 및 $import: 위치를 통해 도달하는 SchemaLibrary 항목입니다. 각 항목의 consumers 목록은 어떤 카탈로그 엔터티가 라이브러리의 어떤 <entry-name> 조각을 참조하는지 기록합니다. 이 구조화된 기록 덕분에 Release를 다시 해석하지 않고도 라이브러리 버전 업데이트의 영향 diff를 추적할 수 있습니다. 기본값: [] |
source_artifacts | SourceArtifactEntry[] | 아니요 | pull 시점에 Recipe / FeatureRecipe의 spec.source 필드에서 가져온 소스 아티팩트입니다. 각 항목은 고유한 {kind, url, chart, pinned_version} 식별자를 내용 다이제스트, 미디어 타입, 그리고 이 아티팩트로 해석된 모든 카탈로그 엔터티를 가리키는 구조화된 referenced_by: 역참조와 함께 식별합니다. url은 작성된 식별 URL이며, 저장소 루트 helm 소스의 경우 해석된 아티팩트 위치는 출처 정보로서 resolved_url: 아래에 별도로 기록됩니다. 같은 차트를 같은 버전으로 고정한 여러 Recipes는 여러 referenced_by: 레코드를 가진 단일 항목으로 중복 제거됩니다. kind enum은 해석되는 네 가지 소스 종류와, 어떤 소스 어댑터도 제공하지 않는 terraform-module-oci를 포함합니다. 이를 지정한 Recipe나 FeatureRecipe는 읽히는 시점에 거부되므로, 어떤 pull도 그 종류의 항목을 기록하지 않습니다. 기본값: [] |
toolchain | object | 아니요 | 이 lockfile을 생성한 툴체인의 버전으로, 컴파일러 자체의 버전과 컴파일러에 포함된 각 코어 플러그인의 버전입니다. 어떤 컴파일러와 어떤 코어 플러그인이 빌드를 해석하고 렌더링했는지 사후에 lockfile로 답할 수 있도록 기록됩니다. 고정된 섹션만으로는 이 질문에 항상 답할 수 없는데, 컴파일러 바이너리 내부에서 제공되는 코어 provider 플러그인은 고정되지 않은 채로 남아 자체 버전이 기록되지 않기 때문입니다. 버전만 기록합니다. 이 스탬프는 플러그인의 바이트가 어디에서 왔는지 기록하지 않으므로, 같은 컴파일러로 같은 의존성 클로저를 고정한 두 머신은 같은 스탬프를 씁니다. 이 섹션을 비교하거나, 이에 대해 경고하거나, 이를 이유로 빌드를 거부하는 것은 없으며, lockfile에 이 섹션이 없어도 아무 알림이 없습니다. 툴체인은 lockfile이 고정하는 의존성 클로저의 일부가 아닙니다. 같은 이유로, 같은 입력에 대한 두 pull 사이의 바이트 동일성 비교에서 이 섹션은 generated_at과 같은 기준으로 제외됩니다. |
verdict_inputs | object[] | 아니요 | verdict 역할 거버넌스 연결(ir-verdict / render-verdict)이 컴파일 시점에 읽는 외부 규칙 입력으로, 연결의 with.sources를 통해 제공되는 Kyverno / Rego 규칙 파일입니다. 감사와 pull 간 드리프트 가시성을 위해 소스별 콘텐츠 다이제스트로 기록됩니다. verdict를 결정한 다이제스트는 pull 간에 비교할 수 있으므로, 변경된 규칙 파일은 lockfile diff로 드러납니다. 이 섹션은 빌드 입력이 아니라 출처(PROVENANCE) 정보입니다. mutators.sources와 달리 content를 담지 않으며, 빌드는 이 섹션을 읽지 않습니다(NOT). verdict 플러그인은 고정되지 않고 캐시되며 규칙 입력을 실시간으로 읽습니다(verdict는 출력 바이트를 결정하지 않으므로, lockfile이 결정적 출력을 위해 고정하는 어떤 것에도 포함되지 않습니다). verdict 플러그인은 고정되지 않으므로 entities / plugins 섹션에 없으며, 따라서 이 레코드는 작성된 URI로 연결을 식별합니다. 이는 그 섹션들을 가리키지 않고 독립적으로 존재하는 기록입니다. 다이제스트를 기록하면 수락/거부 결정을 좌우한 입력을 빌드에 고정하지 않고도 감사하고 재현할 수 있습니다. 기본값: [] |
version | const 1 | 예 | Lockfile 스키마 버전: 1. 스키마에 SemVer-MAJOR 변경이 있으면 증가합니다. 상수: 1 |
workload_libraries | LibraryEntry[] | 아니요 | Release의 의존성 클로저가 Recipe의 workload: { $import: ... } 위치를 통해 도달하는 WorkloadLibrary 항목입니다. 각 항목의 consumers 목록은 어느 카탈로그 엔티티가 라이브러리의 어느 <entry-name> 조각을 참조하는지 기록합니다. 이 구조화된 레코드 덕분에 Release를 다시 해석하지 않고도 라이브러리 버전 상향의 영향 diff를 추적할 수 있습니다. 기본값: [] |
artifact_libraries | LibraryEntry[] | 아니요 | Release의 의존성 클로저가 Recipe / FeatureRecipe의 artifacts.<name>: { $import: ... } 위치를 통해 도달하는 ArtifactLibrary 항목입니다. 각 항목의 consumers 목록은 어느 카탈로그 엔티티가 라이브러리의 어느 <entry-name> 번들을 참조하는지 기록합니다. 이 구조화된 레코드 덕분에 Release를 다시 해석하지 않고도 라이브러리 버전 상향의 영향 diff를 추적할 수 있습니다. 기본값: [] |
추가 속성은 허용되지 않습니다.
lockfile.entities[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
kind | string (enum) | 예 | 카탈로그 엔터티의 종류로, Release, 그 Aggregate 또는 그 Manifest가 해당 엔터티를 지정하는 위치에서 읽습니다. component와 feature는 Aggregate, Release 또는 Manifest 매핑이 지정하는 Component 또는 Feature 타입을, recipe와 feature_recipe는 Manifest 매핑이 바인딩하는 구현을, plugin은 Plugin 엔터티를, aggregate는 Release 자신의 Aggregate와 그것이 포함하는 모든 Aggregate를, manifest는 Release 자신의 Manifest와 그것이 확장하는 Manifest를 나타냅니다. uri와 함께 항목을 식별합니다. 빌드는 각 항목을 같은 종류와 URI의 엔터티와 비교하므로, 종류가 다른 같은 이름의 두 엔터티 중 어느 쪽을 편집하더라도 감지됩니다. 허용되는 값: "aggregate", "component", "feature", "feature_recipe", "manifest", "plugin", "recipe" |
uri | string | 예 | 카탈로그 엔티티의 정규 URI입니다(예: hub.aggrega.ai/component/core/compute/api-server). |
resolved_version | string | 예 | pull 시점에 리졸버가 선택한 구체적인 버전입니다. 카탈로그 엔티티 자체의 버전(예: 1.2.3)이거나, 버전이 아닌 경로로 해석된 최상위 엔티티의 경우 비어 있습니다. 하나의 경로 세그먼트를 가리키므로 단일 경로 세그먼트로 기록되며, 따라서 /, \, ..를 포함하지 않습니다. 이 값은 빌드가 이 엔티티를 다시 읽어 오는 캐시 슬롯을 구성하며, 캐시 디렉터리 밖으로 벗어나는 값은 그 바깥의 위치를 가리키게 됩니다. 패턴: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | 예 | 엔티티의 게시본이 담고 있는 내용의 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 엔티티의 문서와 그 옆에 선언된 모든 파일을 경로순으로 정렬하여, 각 파일의 경로와 바이트의 SHA-256을 반영해 계산한 SHA-256입니다. 파일을 선언하지 않은 엔티티는 하나의 문서로 계산됩니다. 그 밖의 것은 반영되지 않습니다. 아카이브의 압축 방식, 타임스탬프, 실행 비트를 포함한 어떤 권한 비트도 반영되지 않으므로, 엔티티는 카탈로그 디렉터리에서 읽든 레지스트리에서 가져오든, 어떤 시스템에서 같은 파일을 체크아웃하든 동일한 다이제스트를 기록합니다. 패턴: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | 아니요 | 해석된 아티팩트의 OCI 매니페스트 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 서명은 이 다이제스트에 대해 이루어지며, 매니페스트는 게시된 바이트의 다이제스트를 명시합니다. 가져오기와 캐시 읽기는 엔티티를 위의 digest와 대조하기 전에 이 다이제스트로 검사됩니다. 레지스트리에서 해석된 엔티티에만 존재합니다. 패턴: ^sha256:[a-f0-9]{64}$. |
referenced_from | string[] | 아니요 | 작성 위치 출처입니다. 이 URI가 Release의 의존성 클로저에 포함된 이유를 기록하는, Release / Aggregate / Manifest YAML 내부를 가리키는 점 표기 경로입니다(예: aggregate.spec.components.api.type). 기본값: [] |
signature | VerifiedSignature | 아니요 | pull 시점에 해석한 레지스트리의 신뢰 정책에 따라 이 엔티티의 서명이 검증되었을 때 기록되는 서명 검증 사실입니다. |
deprecation | DeprecationRecord | 아니요 | pull 시점에 이 아티팩트에서 서명되고 신뢰된 폐기 마커가 발견되었을 때 기록되는, 검증된 소급 폐기 마커입니다. 마커는 폐기 대상 아티팩트의 서명된 OCI referrer로, 아티팩트를 다시 게시하지 않고 게시 후에 첨부됩니다. 마커의 심각도와 메시지, 그리고 마커를 작성한 검증된 서명자를 기록합니다. 빌드는 이 사실을 읽어 lockfile만으로 폐기 정책을 적용하며, 마커를 다시 탐색하거나 다시 검증하지 않습니다. |
추가 속성은 허용되지 않습니다.
lockfile.mutators[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
plugin | string | 예 | transform 역할 플러그인의 해석된 플러그인 좌표로, Plugin 엔티티의 <pluginType>/<name> 식별자입니다(예: governance/tag-injector). 고정된 다이제스트와 버전 집합을 위해 식별자로 plugins 및 entities 섹션에 조인됩니다. |
role | string (enum) | 예 | 이 연결이 바인딩된 transform 역할로, 작성된 plugins.governance 항목에서 그대로 기록되므로 빌드는 역할을 추론하지 않고 정확히 그 역할로 연결을 실행합니다. label-transform은 토폴로지 구성 시 노드 레이블을 다시 작성하고, annotation-transform은 해석 중 확장 전에 어노테이션을 주입합니다. 허용 값: "label-transform", "annotation-transform" |
function | string | 아니요 | 연결이 지정하는 export 재정의입니다. 없으면 역할의 기본 export(label-transform은 mutate, annotation-transform은 transform_annotations)가 선택됩니다. |
settings | object | 아니요 | 연결이 선언한 자유 형식 설정 객체로, 작성된 그대로 고정되어 플러그인에 그대로 전달됩니다. 빌드는 실시간 구성이 아닌 여기에서 설정을 읽으므로, pull 이후의 설정 변경은 빌드 출력을 바꾸지 않습니다. 연결이 설정을 선언하지 않으면 없습니다. |
sources | object[] | 아니요 | 연결이 선언한 소스 파일의 콘텐츠 주소 기반 pin으로, 기본 이름 순서입니다. 빌드는 호스트에서 실시간으로 읽지 않고 각 pin에 기록된 콘텐츠로 플러그인이 읽는 소스를 재구성하므로, pull 이후 소스 파일이 변경되어도 빌드 출력은 변하지 않습니다. 연결이 소스를 선언하지 않으면 없습니다. |
추가 속성은 허용되지 않습니다.
lockfile.mutators[].sources[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
content | string | 예 | 소스 파일의 콘텐츠로, 빌드가 lockfile에서 플러그인의 소스 입력을 재구성할 수 있도록 그대로 담깁니다. |
digest | string | 예 | 기록된 콘텐츠의 콘텐츠 주소로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 다시 pull할 때 원본 파일을 이 다이제스트와 비교하여 드리프트를 감지합니다. 패턴: ^sha256:[a-f0-9]{64}$. |
path | string | 예 | 소스 파일의 기본 이름입니다. 절대 호스트 경로가 아니므로 pin은 이식 가능하고 결정적입니다. |
추가 속성은 허용되지 않습니다.
lockfile.plugins[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
uri | string | 예 | Wasm 플러그인의 .wasm 아티팩트의 순수 식별자로, <pluginType>/<name> 경로입니다(예: governance/aggrega-security-baseline). 첫 번째 세그먼트는 플러그인의 타입(provider, linter, pipeline-step, governance, cli, parser, importer)이고, 그 뒤의 세그먼트는 플러그인의 이름입니다. 타입과 이름이 함께 플러그인의 식별자를 이루므로, 같은 이름이 두 타입 아래에 있으면 두 개의 플러그인입니다. 물리적인 가져오기 위치는 이 식별자와 구성된 레지스트리로부터 도출되며, lockfile에는 기록되지 않습니다. |
resolved_version | string | 예 | Wasm 아티팩트가 해석된 콘텐츠 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 플러그인 아티팩트는 버전 이름이 아니라 콘텐츠 주소로 지정됩니다. .wasm은 플러그인 매니페스트에 인라인으로 포함되고 바이트의 다이제스트로 고정되므로, 이 필드는 그 다이제스트를 기록하며 이는 아래의 digest이기도 합니다. 이 값은 빌드가 아티팩트를 다시 읽어 오는 캐시 슬롯을 구성하므로 /, \, ..를 포함하지 않으며, sha256: 형식이 이미 이를 배제합니다. 패턴: ^sha256:[a-f0-9]{64}$. |
digest | string | 예 | 해석된 Wasm 아티팩트의 콘텐츠 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 이는 콘텐츠 주소가 비교되는 모든 곳에서 쓰이는 형식입니다. 패턴: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | 아니요 | 해석된 Wasm 아티팩트의 OCI 매니페스트 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 서명은 이 다이제스트에 대해 이루어지며, 위의 콘텐츠 digest는 캐시 고정과 무결성 검사에 쓰이는 이식 가능한 식별자입니다. 레지스트리에서 해석된 아티팩트에만 존재합니다. 패턴: ^sha256:[a-f0-9]{64}$. |
referenced_from | string[] | 아니요 | 이 아티팩트가 Release의 의존성 클로저에 포함된 이유로, 이 아티팩트에 도달하는 데 거친 각 Plugin 엔터티의 참조를 entities 섹션이 그 엔터티를 기록하는 형태로 나타냅니다(예: governance/label-injector:1.0.0). 기본값: [] |
signature | VerifiedSignature | 아니요 | 이 플러그인의 서명이 pull 시점에 카탈로그 엔터티와 동일한 레지스트리별 신뢰 정책에 따라 검증되었을 때 기록되는 검증된 서명 정보입니다. |
deprecation | DeprecationRecord | 아니요 | pull 시점에 이 아티팩트에서 서명되고 신뢰된 폐기 마커가 발견되었을 때 기록되는, 검증된 소급 폐기 마커입니다. 마커는 폐기 대상 아티팩트의 서명된 OCI referrer로, 아티팩트를 다시 게시하지 않고 게시 후에 첨부됩니다. 마커의 심각도와 메시지, 그리고 마커를 작성한 검증된 서명자를 기록합니다. 빌드는 이 사실을 읽어 lockfile만으로 폐기 정책을 적용하며, 마커를 다시 탐색하거나 다시 검증하지 않습니다. |
추가 속성은 허용되지 않습니다.
lockfile.providers[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
capability | string | 예 | 이 바인딩이 provider를 선택하는 대상 capability로, Recipe가 spec.capability를 통해 바인딩하는 순수 capability 이름입니다(예: helm, compose). |
plugin | string | 예 | 해석된 provider 렌더링 플러그인의 순수 식별자입니다(Plugin 엔터티의 식별자로, metadata.pluginType과 metadata.name을 슬래시로 연결한 것, 예: provider/helm). 고정된 다이제스트와 버전 집합을 위해 식별자로 plugins 및 entities 섹션과 조인됩니다. |
추가 속성은 허용되지 않습니다.
lockfile.release_documents[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
digest | string | 예 | 해석 과정에서 읽었을 때의 Release 파일 바이트의 콘텐츠 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 패턴: ^sha256:[a-f0-9]{64}$. |
path | string | 예 | 이 lockfile이 속한 Release가 있는 디렉터리를 기준으로 한 Release 파일의 상대 경로로, 슬래시(/)를 사용합니다(예: release-prod.yaml, ../shared/base-release.yaml). 절대 호스트 경로는 사용하지 않으므로 기록이 이식 가능하고 결정적입니다. |
추가 속성은 허용되지 않습니다.
lockfile.toolchain
이 lockfile을 생성한 툴체인의 버전으로, 컴파일러 자체의 버전과 컴파일러에 포함된 각 코어 플러그인의 버전입니다. 어떤 컴파일러와 어떤 코어 플러그인이 빌드를 해석하고 렌더링했는지 사후에 lockfile로 답할 수 있도록 기록됩니다. 고정된 섹션만으로는 이 질문에 항상 답할 수 없는데, 컴파일러 바이너리 내부에서 제공되는 코어 provider 플러그인은 고정되지 않은 채로 남아 자체 버전이 기록되지 않기 때문입니다. 버전만 기록합니다. 이 스탬프는 플러그인의 바이트가 어디에서 왔는지 기록하지 않으므로, 같은 컴파일러로 같은 의존성 클로저를 고정한 두 머신은 같은 스탬프를 씁니다. 이 섹션을 비교하거나, 이에 대해 경고하거나, 이를 이유로 빌드를 거부하는 것은 없으며, lockfile에 이 섹션이 없어도 아무 알림이 없습니다. 툴체인은 lockfile이 고정하는 의존성 클로저의 일부가 아닙니다. 같은 이유로, 같은 입력에 대한 두 pull 사이의 바이트 동일성 비교에서 이 섹션은 generated_at과 같은 기준으로 제외됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
compiler_version | string | 예 | 이 lockfile을 작성한 컴파일러의 버전으로, 모든 Aggrega 인터페이스가 보고하는 v 없는 형식입니다(v1.2.0이 아닌 1.2.0). 버전 스탬프가 찍힌 빌드는 그 버전을 기록하고(태그가 지정된 릴리스 빌드는 해당 태그), 버전 스탬프가 없는 빌드는 (devel) 표시를 기록하므로, 스탬프가 없는 컴파일러가 생성한 lockfile이 릴리스 출력으로 오인되지 않습니다. 단일 경로 세그먼트로 기록되므로 /, \, ..를 포함하지 않습니다. 패턴: ^([^/\\.]|\.[^/\\.])*\.?$. |
core_plugins | object[] | 예 | 컴파일러가 포함하는 각 코어 플러그인의 버전으로, 플러그인당 하나의 항목이며 플러그인 좌표 순으로 정렬됩니다. 코어 플러그인은 컴파일러 자체 태그에 같은 버전으로 게시되므로, 컴파일러가 플러그인을 내부에서 제공했든 레지스트리에서 가져왔든 이 버전들은 동일하게 읽힙니다. 이것이 스탬프에 머신별 세부 정보가 포함되지 않도록 합니다. 코어 플러그인을 포함하지 않는 빌드에서는 비어 있습니다. 기본값: [] |
추가 속성은 허용되지 않습니다.
lockfile.toolchain.core_plugins[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
plugin | string | 예 | 코어 플러그인의 좌표로, Plugin 엔터티의 <pluginType>/<name> 식별자입니다(예: provider/helm). providers 및 mutators 섹션이 플러그인을 지칭할 때 쓰는 것과 같은 식별자입니다. |
version | string | 예 | 이 코어 플러그인의 버전으로, 모든 Aggrega 인터페이스가 보고하는 v 없는 형식입니다. 단일 경로 세그먼트로 기록되므로 /, \, ..를 포함하지 않습니다. 패턴: ^([^/\\.]|\.[^/\\.])*\.?$. |
추가 속성은 허용되지 않습니다.
lockfile.verdict_inputs[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
plugin | string | 예 | verdict 연결의 작성된 플러그인 URI로, .aggrega-config.yaml의 plugins.governance에 작성된 그대로입니다(예: governance/aggrega-security-baseline:1.0.0). 기록된 규칙 입력이 어느 연결에 속하는지 식별합니다. verdict 플러그인은 고정되지 않고 캐시되므로 조인할 plugins / entities 섹션 항목이 없습니다. |
role | string (enum) | 예 | 이 연결이 바인딩된 verdict 역할로, ir-verdict(정적 분석 시 IR 그래프 대상) 또는 render-verdict(렌더링 시 렌더링된 아티팩트 대상)입니다. 두 verdict 단계 모두에 연결된 동일한 플러그인을 구분하며, 각각 고유한 규칙 입력을 가질 수 있습니다. 허용 값: "ir-verdict", "render-verdict" |
sources | object[] | 아니요 | 연결이 선언한 규칙 입력 파일의 콘텐츠 다이제스트로, 기본 이름 순으로 정렬됩니다. 연결이 소스를 선언하지 않으면 존재하지 않습니다. |
추가 속성은 허용되지 않습니다.
lockfile.verdict_inputs[].sources[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
digest | string | 예 | pull 시점의 규칙 입력 파일 바이트의 콘텐츠 주소로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 다시 pull하면 이를 재계산하므로, 변경된 규칙 파일은 lockfile diff로 드러납니다. 패턴: ^sha256:[a-f0-9]{64}$. |
path | string | 예 | 규칙 입력 파일의 기본 이름입니다. 절대 호스트 경로는 사용하지 않으므로 기록이 이식 가능하고 결정적입니다. |
추가 속성은 허용되지 않습니다.
정의
DeprecationRecord
pull 시점에 이 아티팩트에서 서명되고 신뢰된 폐기 마커가 발견되었을 때 기록되는, 검증된 소급 폐기 마커입니다. 마커는 폐기 대상 아티팩트의 서명된 OCI referrer로, 아티팩트를 다시 게시하지 않고 게시 후에 첨부됩니다. 마커의 심각도와 메시지, 그리고 마커를 작성한 검증된 서명자를 기록합니다. 빌드는 이 사실을 읽어 lockfile만으로 폐기 정책을 적용하며, 마커를 다시 탐색하거나 다시 검증하지 않습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
message | string | 예 | 마커가 담고 있는 사람이 읽을 수 있는 지원 중단 메시지로, 일반적으로 마이그레이션 안내입니다. |
severity | string (enum) | 예 | 마커 심각도로, warning < error < retracted 순으로 정렬됩니다. 이 심각도가 구성된 중단 임계값 이상이면 빌드가 중단되고, 그렇지 않으면 권고를 출력합니다. 허용 값: "warning", "error", "retracted" |
signer | VerifiedSignature | 아니요 | 마커의 검증된 서명자로, 아티팩트 서명의 서명자와 같은 방식으로 기록됩니다. 키리스 서명이면 인증서 subject/issuer, 키 서명이면 고정된 키의 지문입니다. 마커는 그 자체로 서명된 아티팩트이므로 그 서명자는 아티팩트 서명과 같은 형태를 가지며, 여기의 bundle_digest는 지원 중단된 아티팩트가 아니라 마커 자체의 서명 번들을 가리킵니다. |
추가 속성은 허용되지 않습니다.
ExternalInput
고정된 단일 외부 입력입니다. 렌더가 요청한 URL, 콘텐츠 주소 지정 입력 저장소(sha256/<digest>)에서 해당 바이트를 가리키는 SHA-256 고정값, 페이로드 크기, 그리고 이를 필요로 한 소비자의 출처로 구성됩니다. 고정값은 권위를 가집니다. 고정된 URL은 항상 저장소에서 제공되며, 저장소를 다시 채울 때는 바이트가 렌더에 도달하기 전에 이 다이제스트로 검증됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
required_by | string[] | 예 | 출처로, 이 입력을 요청한 렌더 위치입니다. lockfile 작성기가 정렬하고 중복을 제거합니다. |
sha256 | string | 예 | 소문자 16진수 SHA-256 고정값입니다. https 입력이면 페이로드 바이트의 다이제스트이고, oci 입력이면 참조가 해석된 매니페스트 다이제스트입니다. sha256/<digest>의 저장소 blob을 가리킵니다. 패턴: ^[0-9a-f]{64}$. |
size | integer | 예 | 고정된 페이로드의 크기(바이트)입니다. 바이트 수는 음수가 될 수 없습니다. 최솟값: 0. |
url | string | 예 | 렌더 위치에서 작성된 그대로의 입력 URL로, 렌더 시점의 요청을 해당 고정값과 대응시키는 조회 키입니다. |
추가 속성은 허용되지 않습니다.
LibraryEntry
schema_libraries, mapping_libraries, workload_libraries, artifact_libraries 항목이 공유하는 공통 형태입니다. consumers 목록은 카탈로그 그래프 관계, 즉 어떤 카탈로그 엔터티가 이 라이브러리의 어떤 <entry-name> 프래그먼트를 참조하는지를 기록하여, 라이브러리의 다이제스트가 바뀔 때 구조화된 영향 diff를 지원합니다. 라이브러리는 다른 것과 마찬가지로 OCI 아티팩트이므로 카탈로그 엔터티와 같은 검증된 사실을 기록합니다. 서명이 약속하는 매니페스트 다이제스트, 검증된 서명 자체, 그리고 pull 시점에 발견된 검증된 소급 지원 중단 마커입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
uri | string | 예 | 라이브러리 엔터티의 정규 URI입니다. |
resolved_version | string | 예 | pull 시점에 해석된 구체적인 버전(라이브러리 의존성 그래프에 대한 최소 버전 선택)으로, 라이브러리 자체의 버전입니다. 빌드가 라이브러리를 다시 읽어 오는 캐시 슬롯을 구성하므로 단일 경로 세그먼트로 기록되며, /, \, ..를 포함하지 않습니다. 캐시 디렉터리를 벗어나는 값은 그 바깥의 위치를 가리키게 됩니다. 패턴: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | 예 | 해석된 라이브러리 아티팩트의 콘텐츠 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 콘텐츠 주소가 비교되는 모든 곳에서 쓰이는 형식입니다. 패턴: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | 아니요 | 해석된 라이브러리 아티팩트의 OCI 매니페스트 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 서명은 이 다이제스트를 약속하며, 위의 콘텐츠 digest는 캐시 고정과 무결성 검사에 쓰이는 이식 가능한 식별자입니다. 레지스트리에서 해석된 라이브러리에만 존재합니다. 패턴: ^sha256:[a-f0-9]{64}$. |
signature | VerifiedSignature | 아니요 | 이 라이브러리의 서명이 pull 시점에 카탈로그 엔터티와 같은 레지스트리별 신뢰 정책에 따라 검증되었을 때 기록되는 검증된 서명 사실입니다. |
deprecation | DeprecationRecord | 아니요 | pull 시점에 이 라이브러리에서 발견된 검증된 소급 지원 중단 마커입니다. 빌드는 이를 보고하고, 워크스페이스에 구성된 중단 임계값을 기록된 심각도가 충족하면 중단합니다. 따라서 버전이 고정된 뒤 철회된 라이브러리는 명시적으로 고정된 버전이 우회하는 버전 선택 시점에서만이 아니라 모든 빌드에서 알려집니다. |
consumers | object[] | 아니요 | 어떤 카탈로그 엔터티가 이 라이브러리를 어떤 <entry-name> 프래그먼트에서 참조하는지에 대한 기록입니다. 팬인을 포착합니다. 라이브러리 하나에 소비자가 여럿 있고, 각 소비자는 여러 프래그먼트를 참조할 수 있습니다. 각 기록은 소비자 URI와 그 소비자가 가져오는 프래그먼트 집합을 담습니다. 기본값: [] |
추가 속성은 허용되지 않습니다.
LibraryEntry.consumers[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
consumer_uri | string | 예 | 이 라이브러리를 참조하는 카탈로그 엔터티의 정규 URI입니다. 스키마 라이브러리의 경우 Component 또는 Feature, 매핑·워크로드·아티팩트 라이브러리의 경우 Recipe 또는 FeatureRecipe이며, 또는 항목이 이 라이브러리를 참조하는 같은 종류의 다른 라이브러리입니다. |
fragments | string[] | 예 | 이 소비자가 라이브러리 안에서 참조하는 <entry-name> 프래그먼트 집합입니다(예: ["#/schemas/PortSpec", "#/schemas/EndpointSpec"]). 순서는 작성기가 사전순으로 정규화합니다. |
추가 속성은 허용되지 않습니다.
SourceArtifactEntry
단일 소스 아티팩트 고정 항목입니다. {kind, url, chart, module_subdir, pinned_version} 식별자, 풀(pull)을 검증하는 콘텐츠 다이제스트, 정규 미디어 타입, 그리고 이 아티팩트로 해석된 모든 카탈로그 엔터티로 향하는 구조화된 역참조로 구성됩니다. chart와 module_subdir는 두 가지 선택자 항목으로, 선택자가 필요한 종류에 대해 각각 URL만으로는 지정되지 않는 부분을 지정합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
kind | enum | 예 | 소스 종류입니다. 어떤 어댑터가 아티팩트를 해석했는지와 어떤 미디어 타입이 예상되는지를 결정합니다. terraform-module-oci는 이 집합에 속하지만 어떤 소스 어댑터도 이를 제공하지 않습니다. 이를 지정한 Recipe나 FeatureRecipe는 읽히는 시점에 거부됩니다. 허용되는 값: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | 예 | 작성된 URL로, Recipe의 spec.source.url에 작성된 그대로의 식별 URL입니다. helm-https-chart의 경우 작성된 그대로의 저장소 루트(repo-root 형식) 또는 직접 .tgz(direct 형식)입니다. 빌드는 오프라인에서 이 동일한 URL을 재구성하므로, 이는 고정 항목의 키가 되는 안정적인 식별자입니다. git-repository의 경우 복제 가능한 저장소 URL입니다. helm-oci-chart의 경우 레지스트리 참조입니다. compose-https-fragment의 경우 프래그먼트의 HTTPS URL입니다. repo-root helm 소스에 대해 해석된 아티팩트 위치는 출처 정보로서 resolved_url: 아래에 별도로 기록됩니다. |
chart | string | 아니요 | repo-root helm 소스의 차트 이름(Recipe의 spec.source.chart)으로, {kind, url, chart, module_subdir, pinned_version} 식별자의 일부입니다. 따라서 하나의 저장소 루트에서 같은 버전으로 제공되는 두 차트는 서로 다른 항목으로 고정됩니다. 직접 .tgz, OCI, compose 또는 git 소스에는 없으며, 이들 중 어느 것도 URL 안에서 차트를 선택하지 않습니다. |
module_subdir | string | 아니요 | git 소스 저장소 안에서 아티팩트에 해당하는 디렉터리(Recipe의 spec.source.module_subdir)로, {kind, url, chart, module_subdir, pinned_version} 식별자의 일부입니다. 따라서 하나의 저장소에서 같은 커밋에 있는 두 디렉터리는 서로 다른 항목으로 고정됩니다. 저장소 전체가 아티팩트인 경우와, 복제본 안으로 내려가는 대신 URL로 아티팩트에 도달하는 모든 종류에는 없습니다. |
pinned_version | string | 예 | 풀 시점에 고정된 구체적인 버전입니다. helm-* 종류의 경우 차트 버전입니다. git-repository의 경우 작성된 참조가 해석된 커밋입니다(원래의 태그/브랜치 참조가 아닙니다. 원래 참조는 Recipe가 spec.source.ref:를 작성한 경우 각 referenced_by: 항목의 requested_ref: 아래에 기록됩니다). 빌드는 Recipe가 작성한 내용으로 이 항목을 찾습니다. 작성된 ref:가 있으면 기록된 requested_ref:와 대조하고, 없으면 이 고정 값과 대조합니다. 따라서 태그를 지정한 Recipe는 커밋이 Recipe에 전혀 나타나지 않아도 그 태그가 고정된 커밋으로 해석됩니다. 빌드가 아티팩트를 다시 읽어 오는 캐시 슬롯을 구성하므로 단일 경로 세그먼트로 기록되며, /, \, ..를 포함하지 않습니다. 패턴: ^([^/\\.]|\.[^/\\.])*\.?$. |
resolved_url | string | 아니요 | 출처 정보 전용입니다. 작성된 URL이 풀 시점에 해석된 구체적인 아티팩트 위치입니다. repo-root helm 소스의 경우 저장소 인덱스가 chart+version을 해석한 직접 .tgz URL입니다. 진단용으로 기록되며 아티팩트 식별자의 일부가 아닙니다. 해석된 위치가 작성된 URL과 같은 경우(직접 .tgz, OCI, compose 또는 git 소스)에는 없습니다. |
digest | string | 예 | 해석된 .tar.gz 아카이브의 콘텐츠 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 빌드 시점 검증은 캐시 슬롯의 바이트를 읽고 다이제스트를 다시 계산하여 이 필드와 비교합니다. 불일치하면 빌드가 중단되고 콘텐츠 다이제스트 불일치가 보고됩니다. 패턴: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | 아니요 | 해석된 아티팩트의 OCI 매니페스트 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 매니페스트는 캐시된 아카이브를 검증하는 독립적인 신뢰 루트이며, 위의 콘텐츠 digest는 캐시 고정과 무결성 검사에 사용되는 이식 가능한 식별자입니다. OCI로 배포된 소스(helm-oci-chart)에만 있습니다. 패턴: ^sha256:[a-f0-9]{64}$. |
mediatype | string | 예 | 레지스트리가 알린 정식 미디어 타입(레지스트리 메타데이터가 없는 kind의 경우 해당 kind의 기본값)입니다. 진단용 출처 정보를 위해 기록됩니다. |
referenced_by | SourceArtifactReference[] | 예 | 이 아티팩트로 해석된 카탈로그 엔터티로, 결정적인 출력을 위해 (uri, field) 순으로 정렬됩니다. 항목은 Recipe 또는 FeatureRecipe가 그것을 pull했기 때문에만 존재하므로 목록은 결코 비어 있지 않습니다. 최소 1개 항목입니다. |
추가 속성은 허용되지 않습니다.
SourceArtifactReference
단일 카탈로그 엔터티 → 소스 아티팩트 역참조입니다. entity와 uri가 함께 카탈로그 엔터티를 식별하며, field는 엔터티의 spec 안에서 아티팩트가 선언된 소스 측 경로를 지정합니다. 선택 항목인 requested_ref:는 Recipe가 작성한 spec.source.ref:를 보존하며, Recipe가 이를 작성한 경우 항상 기록됩니다(git-repository 태그/브랜치 → 커밋 SHA).
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
entity | enum | 예 | 이 역참조를 보유하는 카탈로그 엔터티 종류입니다. 허용되는 값: "recipe", "feature_recipe" |
uri | string | 예 | Recipe 또는 FeatureRecipe의 정규 URI입니다(예: hub.aggrega.ai/recipe/helm/mariadb-bitnami:1.0.0). |
field | string | 예 | 엔터티의 spec 안에서 아티팩트가 선언된 소스 측 경로입니다. 값은 spec.source입니다. |
requested_ref | string | 아니요 | 선택 항목입니다. Recipe가 작성한 spec.source.ref:로, Recipe가 이를 작성한 경우 항상 기록됩니다. ref: v1.0.0을 작성한 git-repository Recipe의 경우, 이 필드는 "v1.0.0"을 보존하고 pinned_version:은 그 참조가 해석된 커밋을 보유합니다. Recipe가 ref:를 작성하지 않은 경우에는 없으며, 이는 해석기가 작성된 버전을 그대로 고정하는 모든 종류(helm-, compose-)에 해당합니다. 이 필드는 두 가지 역할을 동시에 수행하며, 조건 없이 기록하기 때문에 두 역할이 서로를 배제하지 않습니다. 빌드는 커밋 대신 참조를 지정한 Recipe로부터 이 항목을 찾기 위해 이 필드로 조인합니다. 그리고 업그레이드가 아닌 pull은 기록된 각 참조를 고정된 버전에 묶어 둡니다. 원격에서 이동한 참조는 채택되지 않고 실행을 중단시킵니다. |
추가 속성은 허용되지 않습니다.
VerifiedSignature
pull 시점에 해석 레지스트리의 신뢰 정책에 따라 아티팩트의 서명이 검증되었을 때 기록되는 검증된 서명 사실입니다. 서명 가능한 모든 아티팩트(카탈로그 엔터티, 라이브러리, Wasm 플러그인)는 종류별 경로가 아니라 하나의 경로로 검증되므로 모두 같은 방식으로 이를 기록합니다. 검증 모드, 일치한 keyless 신원/발급자(keyless인 경우), 콘텐츠 캐시에 있는 서명 번들의 콘텐츠 주소 다이제스트를 기록합니다. 빌드는 검증을 다시 실행하지 않습니다. 렌더링이 시작되기 전에 빌드는 모든 섹션에서 빌드에 사용하는 모든 항목의 이 사실을 읽습니다. 캐시된 번들을 다시 해시하여 결과를 bundle_digest와 비교하고, blob이 없거나 다르면 중단합니다. 또한 콘텐츠 캐시가 제공한 항목에 대해서는 해당 번들에서 서명이 어떤 아티팩트에 대해 만들어졌는지 읽고, 빌드가 그 항목에 대해 읽은 아티팩트와 다른 아티팩트에 대해 만들어졌다면 중단합니다. 따라서 한 항목에서 다른 항목으로 복사된 signature는 서명 요구 사항이 무엇이든 거부됩니다. 빌드는 서명을 검증하지 않으므로, 항목 자신의 아티팩트에 대해 작성되어 수동으로 캐시에 기록된 번들은 pull이 검증한 번들과 구별되지 않습니다. 그리고 작업 공간의 신뢰 구성이 콘텐츠 캐시가 제공한 항목에 서명을 요구하는 경우(이 요구 사항은 pull이 아티팩트를 가져올 때 적용하는 것이므로, pull이 서명 없는 아티팩트를 허용하게 하는 건너뛰기와 advisory 레지스트리는 빌드도 그 항목을 허용하게 합니다), 사실을 갖지 않은 항목은 빌드를 중단시킵니다. 카탈로그 디렉터리, 컴파일러 바이너리 내부의 사본, 또는 Release 옆에서 읽은 항목에는 이 요구 사항이 적용되지 않습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
bundle_digest | string | 예 | 캐시된 서명 번들 blob의 SHA-256 다이제스트로, sha256: 뒤에 소문자 16진수 64자가 오는 형식입니다. 캐시 blob의 이름이 되므로 경로를 구성하며 /, \, ..를 포함하지 않습니다(sha256: 형식이 이미 이를 배제합니다). 또한 모든 섹션의 항목에서 빌드가 해당 blob을 다시 해시하여 비교하는 대상입니다. 패턴: ^sha256:[a-f0-9]{64}$. |
identity | string | 아니요 | 서명의 검증된 서명자입니다. keyless 서명의 경우 서명 인증서의 subject이고, keyed 서명의 경우 keyed:sha256: 뒤에 고정된 공개 키 PEM 텍스트의 SHA-256이 오는 값입니다. |
issuer | string | 아니요 | keyless 서명에 대해 검증된 OIDC 발급자입니다. keyed 서명의 경우 비어 있습니다. |
mode | string (enum) | 예 | 서명을 허용한 검증 모드입니다. 허용되는 값: "keyless", "keyed" |
추가 속성은 허용되지 않습니다.