Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Aggrega-Schema für die Metadaten des Cache-Slots

Generierte Referenz. Nicht von Hand bearbeiten — aus dem veröffentlichten JSON Schema neu generieren.

Schema-ID: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json

Die Datei metadata.yaml, die in jeden Cache-Slot für Quellartefakte neben blob.tgz geschrieben wird. Verzeichnet das Identitätstupel {kind, url, version, digest, mediatype, pulled_at}, sodass die Inspektion des Caches und die Integritätsprüfung zur Build-Zeit einen einzigen kanonischen Datensatz haben. Die Übertragungsform ist geschlossen (additionalProperties: false), und alle sechs Felder sind erforderlich. Disziplin der Schemaentwicklung: Das Hinzufügen eines neuen optionalen Feldes ist SemVer-MINOR (additiv); das Entfernen eines Feldes oder das Verschärfen einer Einschränkung ist SemVer-MAJOR.

Typ der obersten Ebene: object

Eigenschaften

EigenschaftTypErforderlichBeschreibung
kindenumjaDie Quellart, die diesen Cache-Slot erzeugt hat. Spiegelt das Enum source_artifacts[].kind des Lockfiles; die passende Art ist das, was jeder Verbraucher zur Build-Zeit liest, um den richtigen Loader zu wählen. Zulässige Werte: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci"
urlstringjaDie verfasste URL — die Identitäts-URL, wie sie im spec.source.url des Recipe geschrieben ist. Bei helm-https-chart ist dies die Repository-Wurzel (Repository-Wurzel-Form) oder die direkte .tgz (direkte Form), genau wie verfasst. Bei git-repository die klonbare Repository-URL. Bei helm-oci-chart die Registry-Referenz. Bei compose-https-fragment die HTTPS-URL des Fragments. Der aufgelöste Artefaktort für eine helm-Quelle mit Repository-Wurzel wird separat unter resolved_url: als Herkunft verzeichnet.
resolved_urlstringneinNur Herkunft: der konkrete Artefaktort, zu dem die verfasste URL zum Zeitpunkt des Pulls aufgelöst wurde. Bei einer helm-Quelle mit Repository-Wurzel ist dies die direkte .tgz-URL, zu der der Repository-Index Chart+Version aufgelöst hat. Für Diagnosezwecke verzeichnet; nicht Teil eines Integritätsvertrags. Fehlt, wenn der aufgelöste Ort der verfassten URL entspricht.
versionstringjaDie konkrete Version, die der Resolver zum Zeitpunkt des Pulls gepinnt hat. Bei den Arten helm-* die Chart-Version. Bei git-repository der Commit, zu dem die verfasste Referenz aufgelöst wurde. Als einzelnes Pfadsegment verzeichnet, weil sie den Cache-Slot bildet, in dem diese Metadaten liegen, daher enthält sie kein /, kein \ und kein ... Muster: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringjaInhalts-Digest des zwischengespeicherten .tar.gz-Archivs in der Form sha256:. Die Prüfung zur Build-Zeit berechnet den SHA-256 von blob.tgz, vergleicht ihn mit diesem Feld UND dem Digest des Lockfile-Eintrags und bricht den Build ab, wobei eine Abweichung des Inhalts-Digests gemeldet wird, wenn einer von beiden abweicht. Muster: ^sha256:[a-f0-9]{64}$.
mediatypestringjaKanonischer Medientyp, den die Registry angekündigt hat (oder der Standard der Art für Arten ohne Registry-Metadaten). Für die diagnostische Herkunft verzeichnet.
pulled_atstringjaRFC 3339-Zeitstempel, der die reale Uhrzeit zum Zeitpunkt des Pulls verzeichnet. Nur diagnostische Herkunft — nicht Teil eines Integritätsvertrags. Das Muster hält den Wert beim Lesen der Metadaten an die RFC 3339-Form. Muster: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$.

Zusätzliche Eigenschaften sind nicht zulässig.