Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Schéma des métadonnées de l’emplacement du cache d’Aggrega

Référence générée. Ne pas modifier à la main — régénérer à partir du JSON Schema publié.

Identifiant du schéma : https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json

Le fichier metadata.yaml écrit dans chaque emplacement du cache d’artefacts sources à côté de blob.tgz. Enregistre le tuple d’identité {kind, url, version, digest, mediatype, pulled_at} afin que l’inspection du cache et la vérification d’intégrité au moment du build disposent d’un unique enregistrement canonique. La forme sérialisée est fermée (additionalProperties: false) et les six champs sont tous obligatoires. Discipline d’évolution du schéma : ajouter un nouveau champ facultatif est SemVer-MINOR (additif) ; supprimer un champ ou resserrer une contrainte est SemVer-MAJOR.

Type de premier niveau : object

Propriétés

PropriétéTypeObligatoireDescription
kindenumouiLe type de source qui a produit cet emplacement du cache. Reflète l’enum source_artifacts[].kind du fichier de verrouillage ; le type correspondant est ce que lit chaque consommateur au moment du build pour choisir le bon chargeur. Valeurs autorisées : "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci"
urlstringouiL’URL rédigée — l’URL d’identité telle qu’écrite dans le spec.source.url de la Recipe. Pour helm-https-chart, il s’agit de la racine du dépôt (forme racine du dépôt) ou du .tgz direct (forme directe), exactement tel que rédigé. Pour git-repository, l’URL clonable du dépôt. Pour helm-oci-chart, la référence de registre. Pour compose-https-fragment, l’URL HTTPS du fragment. L’emplacement résolu de l’artefact pour une source helm à racine de dépôt est enregistré séparément sous resolved_url: comme provenance.
resolved_urlstringnonProvenance uniquement : l’emplacement concret de l’artefact vers lequel l’URL rédigée s’est résolue au moment du pull. Pour une source helm à racine de dépôt, il s’agit de l’URL directe du .tgz vers laquelle l’index du dépôt a résolu chart+version. Enregistré à des fins de diagnostic ; ne fait partie d’aucun contrat d’intégrité. Absent lorsque l’emplacement résolu est égal à l’URL rédigée.
versionstringouiLa version concrète que le résolveur a épinglée au moment du pull. Pour les types helm-*, la version du chart. Pour git-repository, le commit vers lequel la référence rédigée s’est résolue. Enregistrée sous la forme d’un seul segment de chemin, car elle construit l’emplacement du cache dans lequel se trouvent ces métadonnées, de sorte qu’elle ne contient ni /, ni \, ni ... Motif : ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringouiDigest du contenu de l’archive .tar.gz en cache, sous la forme sha256:. La vérification au moment du build calcule le SHA-256 de blob.tgz, le compare à ce champ ET au digest de l’entrée du fichier de verrouillage, et interrompt le build, en signalant une non-correspondance du digest du contenu, lorsque l’un ou l’autre diffère. Motif : ^sha256:[a-f0-9]{64}$.
mediatypestringouiType de média canonique annoncé par le registre (ou la valeur par défaut du type pour les types sans métadonnées de registre). Enregistré à titre de provenance diagnostique.
pulled_atstringouiHorodatage RFC 3339 enregistrant l’heure réelle au moment du pull. Provenance diagnostique uniquement — ne fait partie d’aucun contrat d’intégrité. Le motif astreint la valeur à la forme RFC 3339 lorsque les métadonnées sont lues. Motif : ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$.

Les propriétés supplémentaires ne sont pas autorisées.