Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.
Skema metadata slot cache Aggrega
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
File metadata.yaml yang ditulis ke setiap slot cache artefak sumber di samping blob.tgz. File ini mencatat tuple identitas {kind, url, version, digest, mediatype, pulled_at} sehingga inspeksi cache dan verifikasi integritas saat build memiliki satu catatan kanonis. Bentuk wire-nya tertutup (additionalProperties: false) dan keenam field wajib diisi. Disiplin evolusi skema: menambahkan field opsional baru adalah SemVer-MINOR (aditif); menghapus field atau memperketat batasan adalah SemVer-MAJOR.
Jenis tingkat teratas: object
Properti
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | enum | ya | Jenis sumber yang menghasilkan slot cache ini. Mencerminkan enum source_artifacts[].kind pada lockfile; kind yang cocok inilah yang dibaca setiap konsumen saat build untuk memilih loader yang tepat. Nilai yang diizinkan: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | ya | URL yang ditulis penulis — URL identitas sebagaimana ditulis dalam spec.source.url milik Recipe. Untuk helm-https-chart, ini adalah root repo (bentuk repo-root) atau .tgz langsung (bentuk langsung) persis seperti yang ditulis. Untuk git-repository, URL repositori yang dapat di-clone. Untuk helm-oci-chart, referensi registry. Untuk compose-https-fragment, URL HTTPS fragmen tersebut. Lokasi artefak hasil resolusi untuk sumber helm repo-root dicatat terpisah di bawah resolved_url: sebagai provenans. |
resolved_url | string | tidak | Hanya provenans: lokasi artefak konkret yang menjadi hasil resolusi URL yang ditulis pada saat pull. Untuk sumber helm repo-root, ini adalah URL .tgz langsung yang menjadi hasil resolusi chart+version oleh indeks repositori. Dicatat untuk diagnostik; bukan bagian dari kontrak integritas apa pun. Tidak ada jika lokasi hasil resolusi sama dengan URL yang ditulis. |
version | string | ya | Versi konkret yang dipatok oleh resolver pada saat pull. Untuk kind helm-*, versi chart. Untuk git-repository, commit yang menjadi hasil resolusi referensi yang ditulis. Dicatat sebagai satu segmen path, karena nilai ini membentuk slot cache tempat metadata ini berada, sehingga tidak mengandung /, \ maupun ... Pola: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | ya | Digest konten arsip .tar.gz yang di-cache dalam bentuk sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | ya | Media type kanonis yang diumumkan registry (atau default kind tersebut untuk kind tanpa metadata registry). Dicatat untuk provenans diagnostik. |
pulled_at | string | ya | Timestamp RFC 3339 yang mencatat waktu jam dinding saat pull. Hanya provenans diagnostik — bukan bagian dari kontrak integritas apa pun. Pola ini membatasi nilai pada bentuk RFC 3339 saat metadata dibaca. Pola: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
Properti tambahan tidak diizinkan.