Schema dei metadati dello slot della cache di Aggrega
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
Il file metadata.yaml scritto in ogni slot della cache degli artefatti sorgente accanto a blob.tgz. Registra la tupla di identità {kind, url, version, digest, mediatype, pulled_at}, così l’ispezione della cache e la verifica di integrità in fase di build hanno un unico record canonico. La forma serializzata è chiusa (additionalProperties: false) e tutti e sei i campi sono obbligatori. Disciplina di evoluzione dello schema: aggiungere un nuovo campo opzionale è SemVer-MINOR (additivo); rimuovere un campo o restringere un vincolo è SemVer-MAJOR.
Tipo di primo livello: object
Proprietà
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
kind | enum | sì | Il tipo di sorgente che ha prodotto questo slot della cache. Rispecchia l’enum source_artifacts[].kind del file di lock; il tipo corrispondente è ciò che ogni consumatore in fase di build legge per scegliere il loader giusto. Valori consentiti: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | sì | L’URL scritto dall’autore — l’URL di identità così come è scritto nello spec.source.url della Recipe. Per helm-https-chart è la radice del repository (forma con radice del repository) o il .tgz diretto (forma diretta), esattamente come scritto. Per git-repository, l’URL clonabile del repository. Per helm-oci-chart, il riferimento al registry. Per compose-https-fragment, l’URL HTTPS del frammento. La posizione risolta dell’artefatto per una sorgente helm con radice del repository viene registrata separatamente sotto resolved_url: come provenienza. |
resolved_url | string | no | Solo provenienza: la posizione concreta dell’artefatto in cui l’URL scritto dall’autore si è risolto al momento del pull. Per una sorgente helm con radice del repository è l’URL diretto del .tgz in cui l’indice del repository ha risolto chart+versione. Registrata per la diagnostica; non fa parte di alcun contratto di integrità. Assente quando la posizione risolta è uguale all’URL scritto dall’autore. |
version | string | sì | La versione concreta che il resolver ha fissato al momento del pull. Per i tipi helm-*, la versione del chart. Per git-repository, il commit in cui si è risolto il riferimento scritto dall’autore. Registrata come un singolo segmento di percorso, perché costruisce lo slot della cache in cui si trovano questi metadati, quindi non contiene /, \ né ... Pattern: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | sì | Digest del contenuto dell’archivio .tar.gz in cache nella forma sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | sì | Tipo di media canonico annunciato dal registry (o il valore predefinito del tipo per i tipi senza metadati di registry). Registrato come provenienza diagnostica. |
pulled_at | string | sì | Timestamp RFC 3339 che registra l’ora reale al momento del pull. Solo provenienza diagnostica — non fa parte di alcun contratto di integrità. Il pattern vincola il valore alla forma RFC 3339 quando i metadati vengono letti. Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
Non sono consentite proprietà aggiuntive.