이 페이지는 기계 번역되었습니다. 영어 원문 읽기.
Aggrega 캐시 슬롯 메타데이터 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 id: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
모든 소스 아티팩트 캐시 슬롯에 blob.tgz와 함께 기록되는 metadata.yaml 파일입니다. {kind, url, version, digest, mediatype, pulled_at} 식별 튜플을 기록하여 캐시 검사와 빌드 시점 무결성 검증이 하나의 정식 레코드를 갖도록 합니다. 와이어 형태는 닫혀 있으며(additionalProperties: false) 여섯 필드가 모두 필수입니다. 스키마 발전 원칙: 새 선택적 필드를 추가하는 것은 SemVer-MINOR(추가적 변경)이고, 필드를 제거하거나 제약을 강화하는 것은 SemVer-MAJOR입니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
kind | enum | 예 | 이 캐시 슬롯을 생성한 소스 kind입니다. lockfile의 source_artifacts[].kind enum을 그대로 반영하며, 빌드 시점의 모든 소비자는 일치하는 kind를 읽어 올바른 로더를 선택합니다. 허용 값: "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 형식)입니다. git-repository의 경우 복제 가능한 저장소 URL입니다. helm-oci-chart의 경우 레지스트리 참조입니다. compose-https-fragment의 경우 프래그먼트의 HTTPS URL입니다. repo-root helm 소스에 대해 해석된 아티팩트 위치는 출처 정보로서 resolved_url: 아래에 별도로 기록됩니다. |
resolved_url | string | 아니요 | 출처 정보 전용: pull 시점에 작성된 URL이 해석된 구체적인 아티팩트 위치입니다. repo-root helm 소스의 경우 저장소 인덱스가 chart+version을 해석한 직접 .tgz URL입니다. 진단용으로 기록되며 어떠한 무결성 계약에도 포함되지 않습니다. 해석된 위치가 작성된 URL과 같으면 생략됩니다. |
version | string | 예 | pull 시점에 리졸버가 고정한 구체적인 버전입니다. helm-* kind의 경우 차트 버전입니다. git-repository의 경우 작성된 참조가 해석된 커밋입니다. 이 메타데이터가 위치하는 캐시 슬롯 경로를 구성하므로 단일 경로 세그먼트로 기록되며, 따라서 /, \, ..를 포함하지 않습니다. 패턴: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | 예 | 캐시된 .tar.gz 아카이브의 콘텐츠 다이제스트로, sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | 예 | 레지스트리가 알린 정식 미디어 타입(레지스트리 메타데이터가 없는 kind의 경우 해당 kind의 기본값)입니다. 진단용 출처 정보를 위해 기록됩니다. |
pulled_at | string | 예 | pull 시점의 실제 시각을 기록하는 RFC 3339 타임스탬프입니다. 진단용 출처 정보 전용이며 어떠한 무결성 계약에도 포함되지 않습니다. 메타데이터를 읽을 때 패턴이 값을 RFC 3339 형태로 제한합니다. 패턴: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
추가 속성은 허용되지 않습니다.