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
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
kind | enum | ja | Die 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" |
url | string | ja | Die 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_url | string | nein | Nur 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. |
version | string | ja | Die 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: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | ja | Inhalts-Digest des zwischengespeicherten .tar.gz-Archivs in der Form sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | ja | Kanonischer 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_at | string | ja | RFC 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.