Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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àTipoObbligatoriaDescrizione
kindenumsì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"
urlstringsì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_urlstringnoSolo 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.
versionstringsì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: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringsìDigest del contenuto dell’archivio .tar.gz in cache nella forma sha256:. La verifica in fase di build calcola lo SHA-256 di blob.tgz, lo confronta con questo campo E con il digest della voce del file di lock, e arresta la build, segnalando una mancata corrispondenza del digest del contenuto, quando uno dei due differisce. Pattern: ^sha256:[a-f0-9]{64}$.
mediatypestringsì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_atstringsì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.