Aggrega-Schema für das Lockfile pro Release
Generierte Referenz. Nicht von Hand bearbeiten — aus dem veröffentlichten JSON Schema neu generieren.
Schema-ID: https://aggrega.ai/schemas/lockfile-v1beta1.schema.json
Maschinell erzeugtes Lockfile, das jeden aus einem Release aufgelösten URI für deterministische künftige Builds pinnt. Liegt unter <release-stem>.lock neben <release-stem>.yaml; erzeugt von aggrega pull --release <release>; verbraucht von aggrega build --release <release>. Zwei Herkunftsformen verzeichnen zwei unterschiedliche Beziehungen im Abhängigkeitsgraphen: referenced_from (Liste von Strings) erscheint an entities als gepunktete Pfade zu Authoring-Stellen, die verzeichnen, von wo im Release / Aggregate / Manifest / .aggrega-config.yaml jeder URI aufgenommen wurde, und an plugins als die Referenz jeder Plugin-Entität, über die ein Artefakt erreicht wurde; consumers (Liste von {consumer_uri, fragments}-Datensätzen) erscheint an schema_libraries, mapping_libraries, workload_libraries und artifact_libraries, um zu verzeichnen, welche Katalogentität auf welche <entry-name>-Fragmente einer Bibliothek verweist — die strukturierte Form macht Diffs der von einer Bibliotheksversionserhöhung betroffenen Verbraucher nachvollziehbar, ohne das Release erneut aufzulösen. Disziplin der Schemaentwicklung: Das Hinzufügen eines neuen Abschnitts auf oberster Ebene ist SemVer-MINOR (additiv); das Hinzufügen eines neuen Felds innerhalb eines bestehenden Abschnitts ist SemVer-MINOR; das Entfernen eines Schlüssels oder das Verschärfen einer Einschränkung ist SemVer-MAJOR.
Typ der obersten Ebene: object
Eigenschaften
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
entities | object[] | nein | Katalogentitäten, die von diesem Release aus erreichbar sind: Component, Feature, Recipe, FeatureRecipe, Plugin, Aggregate, das eigene Aggregate und Manifest des Release sowie das Manifest, das dieses Manifest erweitert. Jeder Eintrag wird durch sein kind zusammen mit seinem kanonischen URI identifiziert, sodass zwei Entitäten unterschiedlicher Art, die sich einen Namen teilen — etwa ein Aggregate und ein Manifest, die beide imported/flow heißen —, zwei Einträge sind, von denen jeder an seinem eigenen Digest geprüft wird. Jeder verzeichnet die aufgelöste Version, den Digest dessen, was die Entität trägt, und die Ursprünge an Authoring-Stellen (referenced_from), die den URI in den Abhängigkeitsabschluss des Release aufgenommen haben. Ein Lockfile, dessen Einträge kein kind tragen, ist veraltet: aggrega pull --release <release> schreibt es neu. Standardwert: [] |
external_inputs | ExternalInput[] | nein | Entfernte Eingaben, zum Zeitpunkt der Beschaffung in den inhaltsadressierten Eingabespeicher gepinnt — Inhalt, den das Rendern eines Provider-Plugins von außerhalb des Workspace verbraucht, etwa entfernte Schemadokumente oder nicht vendorisierte Chart-Abhängigkeiten. Jeder Eintrag pinnt eine URL an den Digest, der ihre Bytes im Speicher benennt. Der Build liefert gepinnte Eingaben aus dem Speicher und liest diesen Abschnitt ohne Netzwerkzugriff. Standardwert: [] |
generated_at | string | ja | RFC-3339-Zeitstempel des Pulls, der dieses Lockfile erzeugt hat; das Muster hält den Wert beim Laden des Lockfiles auf diese Form. Diagnostische Herkunft — verzeichnet den Zeitpunkt der Auflösung nach der Systemuhr. Ändert sich absichtlich zwischen Pulls; nicht Teil der Byteidentitätsgarantie des Lockfiles. Muster: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
mapping_libraries | LibraryEntry[] | nein | MappingLibrary-Einträge, die der Abhängigkeitsabschluss des Release über die Stellen valuesMapping: { $import: ... } in Recipe / FeatureRecipe erreicht. Die consumers-Liste jedes Eintrags verzeichnet, welche Katalogentität auf welche <entry-name>-Fragmente der Bibliothek verweist — ein strukturierter Datensatz, der Diffs der Auswirkungen einer Bibliotheksversionserhöhung nachvollziehbar macht, ohne das Release erneut aufzulösen. Standardwert: [] |
mutators | object[] | nein | Aufgelöste Governance-Anbindungen mit Transformationsrolle, in verfasster Reihenfolge. Ein Plugin mit Transformationsrolle (label-transform, das Knoten-Labels umschreibt; oder annotation-transform, das vor der Expansion Annotationen injiziert) formt die Bytes der gerenderten Ausgabe, daher ist die Anbindungsmenge — die geordnete Liste sowie pro Anbindung die Rolle, die Plugin-Koordinate und die exportierte Funktion — eine byte-bestimmende Eingabe, die hier gepinnt wird. Der Build liest diesen Abschnitt — nie .aggrega-config.yaml —, um Menge, Reihenfolge, Rolle und exportierte Funktion zu rekonstruieren, sodass die Build-Ausgabe invariant gegenüber einer Änderung an plugins.governance nach dem Pull ist (erst beim nächsten Pull übernommen). Die Reihenfolge ist SEMANTISCH: Jeder Transformationsausführer wendet die Anbindungen seiner Rolle in Listenreihenfolge an, daher wird diese Liste im Gegensatz zu den nach URI sortierten Abschnitten plugins / providers nie umsortiert. Der Inhalts-Digest des Plugins wird hier NICHT dupliziert: Er hat seine einzige Quelle in den Abschnitten plugins und entities, auf die dieser Datensatz über die Identität verweist. Standardwert: [] |
plugins | object[] | nein | Wasm-Plugins, deren Bytes die gerenderte Ausgabe formen, jeweils gepinnt durch den Inhalts-Digest ihrer .wasm: ein Governance-Plugin, das in einer Transformationsrolle (label-transform, annotation-transform) unter .aggrega-config.yaml plugins.governance angebunden ist, sowie alle eingebetteten Plugin-URIs aus referenzierten Recipes / FeatureRecipes / Providers. Ein Governance-Plugin, das in einer Verdikt-Rolle (ir-verdict, render-verdict) angebunden ist, und eine plugins.linter-Anbindung geben ein Verdikt zurück und formen keine Ausgabebytes, daher wird keines von beiden gepinnt: Keines erscheint hier oder unter entities, und die Regeldateien, die eine Verdikt-Anbindung liest, werden unter verdict_inputs verzeichnet. Standardwert: [] |
providers | object[] | nein | Aufgelöste Provider-Auswahlen pro Fähigkeit. Jeder Eintrag pinnt eine Fähigkeit (z. B. helm) an die digestfreie OCI-Identität des Provider-Rendering-Plugins, das sie rendert, beim Pull aufgelöst aus der Liste plugins.providers in .aggrega-config.yaml (wenn die Fähigkeit mehrdeutig bedient wird) oder aus dem einzigen bedienenden Plugin (wenn eindeutig). Der Build liest diesen Abschnitt — nie .aggrega-config.yaml —, um den Provider auszuwählen, sodass die Build-Ausgabe invariant gegenüber Änderungen an der Workspace-Konfiguration nach dem Pull ist. Der Inhalts-Digest des Plugins wird hier NICHT dupliziert: Er hat seine einzige Quelle in den Abschnitten plugins und entities, auf die dieser Datensatz über die Identität verweist. Die Koexistenz von Versionen bleibt erhalten: Dieser Datensatz wählt das Plugin-Repository pro Fähigkeit aus; die konkreten Versionen stehen in entities (ein Eintrag pro aufgelöster Plugin-Version), und der Versions-Pin spec.capability jedes Recipe wählt beim Rendern unter ihnen aus. Standardwert: [] |
release | string | ja | Pfad zu dem Release, dem dieses Lockfile entspricht, relativ zum eigenen Verzeichnis des Lockfiles aufgelöst (z. B. ./release-prod.yaml). Die Namenskonvention pro Release legt <release-stem>.lock neben <release-stem>.yaml; der relative Pfad macht das Lockfile selbstbeschreibend, ohne maschinenspezifische absolute Pfade. Dies benennt das Release; was das Release bei seiner Auflösung enthielt, wird unter release_documents verzeichnet. |
release_documents | object[] | nein | Die Release-Dateien, die die Auflösung gelesen hat, jeweils verzeichnet durch den Inhalts-Digest ihrer Bytes: zuerst das Release, zu dem dieses Lockfile gehört, dann jedes Release, das es erweitert, in der Reihenfolge, in der die extends-Kette durchlaufen wird. Alles, was ein Release anfordert, wird aus dem aufgelöst, was es enthält, sodass ein nach dem Pull bearbeitetes Release nicht mehr zu seinem verzeichneten Digest passt und ein Build — oder aggrega pull --verify — unter Nennung der Datei abbricht, mit aggrega pull --release <release> als Abhilfe, bevor irgendetwas gerendert wird. Der Digest deckt die Bytes ab, wie sie sind, ohne dass etwas wegnormalisiert wird, nach derselben Regel, der die Pins von Aggregate und Manifest folgen: Eine Änderung an einem Kommentar oder an Leerraum zählt als Änderung. Ein Lockfile ohne diesen Abschnitt verzeichnet keine Release-Datei, und ein Build, der ein solches Lockfile hat, meldet das Release als nicht verzeichnet. Eine Datei, die das Release über parameters importiert, wird hier nicht verzeichnet. |
schema_libraries | LibraryEntry[] | nein | SchemaLibrary-Einträge, die der Abhängigkeitsabschluss des Release über die Stellen $ref und $import: in den Inhalten schema: / usesSchema: / featuresSchema: von Entitäten erreicht. Die consumers-Liste jedes Eintrags verzeichnet, welche Katalogentität auf welche <entry-name>-Fragmente der Bibliothek verweist — ein strukturierter Datensatz, der Diffs der Auswirkungen einer Bibliotheksversionserhöhung nachvollziehbar macht, ohne das Release erneut aufzulösen. Standardwert: [] |
source_artifacts | SourceArtifactEntry[] | nein | Quellartefakte, die beim Pull aus den Feldern spec.source von Recipe / FeatureRecipe abgerufen werden. Jeder Eintrag identifiziert eine eindeutige Identität {kind, url, chart, pinned_version} mit Inhalts-Digest, Medientyp und den strukturierten Rückverweisen referenced_by:, die jede Katalogentität nennen, die zu diesem Artefakt aufgelöst wurde. url ist die verfasste Identitäts-URL; der aufgelöste Artefaktort für eine helm-Quelle mit Repository-Wurzel wird separat unter resolved_url: als Herkunft verzeichnet. Mehrere Recipes, die denselben Chart in derselben Version pinnen, werden zu einem einzigen Eintrag mit mehreren referenced_by:-Datensätzen dedupliziert. Das Enum der Arten deckt die vier Quellarten ab, die aufgelöst werden, sowie terraform-module-oci, das kein Quelladapter bedient: Ein Recipe oder FeatureRecipe, das es nennt, wird beim Lesen abgelehnt, sodass kein Pull einen Eintrag dieser Art verzeichnet. Standardwert: [] |
toolchain | object | nein | Versionen der Toolchain, die dieses Lockfile erzeugt hat: die eigene Version des Compilers und die Version jedes Core-Plugins, das der Compiler mitbringt. Verzeichnet, damit ein Lockfile im Nachhinein beantwortet, welcher Compiler und welche Core-Plugins einen Build aufgelöst und gerendert haben — eine Frage, die die gepinnten Abschnitte nicht immer beantworten können, weil ein Core-Provider-Plugin, das aus dem Compiler-Binary heraus bedient wird, ungepinnt bleibt und daher keine eigene verzeichnete Version trägt. Nur Versionen: Der Stempel verzeichnet nie, woher die Bytes eines Plugins stammen, sodass zwei Maschinen, die denselben Abhängigkeitsabschluss mit demselben Compiler gepinnt haben, denselben Stempel schreiben. Nichts vergleicht diesen Abschnitt, warnt seinetwegen oder lehnt seinetwegen einen Build ab, und sein Fehlen in einem Lockfile bleibt stumm: Die Toolchain ist nicht Teil des Abhängigkeitsabschlusses, den das Lockfile pinnt. Aus demselben Grund ist der Abschnitt vom Byteidentitätsvergleich zwischen zwei Pulls derselben Eingaben ausgenommen, gleichrangig mit generated_at. |
verdict_inputs | object[] | nein | Externe Regeleingaben, die eine Governance-Anbindung mit Verdikt-Rolle (ir-verdict / render-verdict) zur Kompilierzeit liest — eine Kyverno- / Rego-Regeldatei, die über das with.sources der Anbindung bereitgestellt wird. Als Inhalts-Digest pro Quelle verzeichnet, für Audits und für die Sichtbarkeit von Drift über Pulls hinweg: Der Digest, der ein Verdikt geprägt hat, ist über Pulls hinweg vergleichbar, sodass eine geänderte Regeldatei als Lockfile-Diff sichtbar wird. Dieser Abschnitt ist HERKUNFT, keine Build-Eingabe: Anders als mutators.sources trägt er kein content, und der Build liest ihn NICHT — ein Verdikt-Plugin wird zwischengespeichert statt gepinnt und liest seine Regeleingaben live (das Verdikt prägt keine Ausgabebytes, daher schließt nichts, was das Lockfile für deterministische Ausgabe pinnt, es ein). Da ein Verdikt-Plugin nicht gepinnt ist, fehlt es in den Abschnitten entities / plugins; dieser Datensatz identifiziert die Anbindung daher über ihren verfassten URI und steht für sich, statt in diese Abschnitte zu verweisen. Das Verzeichnen des Digests macht die Eingaben, die eine Entscheidung über Annahme oder Ablehnung bestimmt haben, prüfbar und reproduzierbar, ohne sie in den Build zu pinnen. Standardwert: [] |
version | const 1 | ja | Version des Lockfile-Schemas: 1. Eine SemVer-MAJOR-Änderung am Schema erhöht sie. Konstante: 1 |
workload_libraries | LibraryEntry[] | nein | WorkloadLibrary-Einträge, die der Abhängigkeitsabschluss des Release über die Stellen workload: { $import: ... } in Recipe erreicht. Die consumers-Liste jedes Eintrags verzeichnet, welche Katalogentität auf welche <entry-name>-Fragmente der Bibliothek verweist — ein strukturierter Datensatz, der Diffs der Auswirkungen einer Bibliotheksversionserhöhung nachvollziehbar macht, ohne das Release erneut aufzulösen. Standardwert: [] |
artifact_libraries | LibraryEntry[] | nein | ArtifactLibrary-Einträge, die der Abhängigkeitsabschluss des Release über die Stellen artifacts.<name>: { $import: ... } in Recipe / FeatureRecipe erreicht. Die consumers-Liste jedes Eintrags verzeichnet, welche Katalogentität auf welche <entry-name>-Bündel der Bibliothek verweist — ein strukturierter Datensatz, der Diffs der Auswirkungen einer Bibliotheksversionserhöhung nachvollziehbar macht, ohne das Release erneut aufzulösen. Standardwert: [] |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.entities[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
kind | string (enum) | ja | Art der Katalogentität, gelesen an der Stelle, an der das Release, sein Aggregate oder sein Manifest sie nennt: component und feature für einen Component- oder Feature-Typ, den das Aggregate, das Release oder ein Manifest-Mapping nennt, recipe und feature_recipe für eine Realisierung, die ein Manifest-Mapping bindet, plugin für eine Plugin-Entität, aggregate für das eigene Aggregate des Release und jedes Aggregate, das es einbindet, und manifest für das eigene Manifest des Release und das Manifest, das es erweitert. Zusammen mit uri identifiziert sie den Eintrag: Ein Build vergleicht jeden Eintrag mit der Entität derselben Art und desselben URI, sodass eine Änderung an einer von zwei gleichnamigen Entitäten unterschiedlicher Art bemerkt wird. Zulässige Werte: "aggregate", "component", "feature", "feature_recipe", "manifest", "plugin", "recipe" |
uri | string | ja | Kanonischer URI der Katalogentität (z. B. hub.aggrega.ai/component/core/compute/api-server). |
resolved_version | string | ja | Konkrete Version, die der Resolver zum Zeitpunkt des Pulls ausgewählt hat — die eigene Version einer Katalogentität (z. B. 1.2.3) oder leer für eine Entität auf oberster Ebene, die über einen Pfad statt über eine Version aufgelöst wird. Als einzelnes Pfadsegment verzeichnet, weil sie eines benennt, daher enthält sie kein /, kein \ und kein ..: Der Wert bildet den Cache-Slot, aus dem der Build diese Entität zurückliest, und ein Wert, der aus dem Cache-Verzeichnis heraustritt, würde einen Ort außerhalb davon benennen. Muster: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | ja | Digest dessen, was eine Veröffentlichung der Entität trägt, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen: der SHA-256 über das Dokument der Entität und jede Datei, die sie daneben deklariert, nach Pfad sortiert, wobei jede ihren Pfad und den SHA-256 ihrer Bytes beiträgt. Eine Entität, die keine Datei deklariert, zählt als ihr einziges Dokument. Nichts anderes geht ein — weder wie ein Archiv komprimiert wurde noch ein Zeitstempel noch irgendein Berechtigungsbit, das Ausführungsbit eingeschlossen —, sodass die Entität denselben Digest verzeichnet, ob sie aus einem Katalogverzeichnis gelesen oder aus einer Registry abgerufen wird, und auf jedem Checkout derselben Dateien, auf jedem System. Muster: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | nein | OCI-Manifestdigest des aufgelösten Artefakts, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Die Signatur bezieht sich verbindlich auf diesen Digest, und die Manifestdatei nennt den Digest der veröffentlichten Bytes, gegen den ein Abruf und ein Lesen aus dem Cache geprüft werden, bevor die Entität an ihrem digest oben gemessen wird. Nur für eine aus einer Registry aufgelöste Entität vorhanden. Muster: ^sha256:[a-f0-9]{64}$. |
referenced_from | string[] | nein | Ursprünge an Authoring-Stellen — gepunktete Pfade in Release- / Aggregate- / Manifest-YAML (z. B. aggregate.spec.components.api.type), die verzeichnen, warum dieser URI im Abhängigkeitsabschluss des Release liegt. Standardwert: [] |
signature | VerifiedSignature | nein | Fakt der verifizierten Signatur, verzeichnet, als die Signatur dieser Entität zum Zeitpunkt des Pulls verifiziert wurde, gegen die Vertrauensrichtlinie der auflösenden Registry. |
deprecation | DeprecationRecord | nein | Verifizierte rückwirkende Deprecation-Markierung, verzeichnet, als zum Zeitpunkt des Pulls eine signierte, vertrauenswürdige Deprecation-Markierung an diesem Artefakt entdeckt wurde. Eine Markierung ist ein signierter OCI-Referrer des Artefakts, das sie als veraltet kennzeichnet, nach der Veröffentlichung angehängt, ohne das Artefakt erneut zu veröffentlichen. Verzeichnet den Schweregrad und die Meldung der Markierung sowie den verifizierten Signierer, der sie verfasst hat. Der Build liest diesen Fakt und setzt die Deprecation-Richtlinie allein anhand des Lockfiles durch; er entdeckt oder verifiziert die Markierung nie erneut. |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.mutators[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
plugin | string | ja | Aufgelöste Plugin-Koordinate des Plugins mit Transformationsrolle — die <pluginType>/<name>-Identität einer Plugin-Entität (z. B. governance/tag-injector). Verknüpft über die Identität mit den Abschnitten plugins und entities für den gepinnten Digest und die Versionsmenge. |
role | string (enum) | ja | Die Transformationsrolle, an die diese Anbindung gebunden ist, unverändert aus dem verfassten plugins.governance-Eintrag verzeichnet, sodass ein Build die Anbindung genau in dieser Rolle ausführt, statt eine abzuleiten: label-transform schreibt beim Aufbau der Topologie Knoten-Labels um; annotation-transform fügt vor der Erweiterung, während der Auflösung, Annotationen ein. Zulässige Werte: "label-transform", "annotation-transform" |
function | string | nein | Export-Überschreibung, die die Anbindung nennt. Fehlt sie, wird der Standard-Export der Rolle gewählt (mutate für label-transform, transform_annotations für annotation-transform). |
settings | object | nein | Frei geformtes Einstellungsobjekt, das die Anbindung deklariert hat, wie verfasst gepinnt und unverändert an das Plugin übergeben. Der Build liest Einstellungen von hier — nie aus der Live-Konfiguration —, sodass eine Einstellungsänderung nach dem Pull die Build-Ausgabe nicht verschiebt. Fehlt, wenn die Anbindung keine deklariert. |
sources | object[] | nein | Inhaltsadressierte Pins der deklarierten Quelldateien der Anbindung, in der Reihenfolge der Basisnamen. Der Build rekonstruiert die Quelle, die das Plugin liest, aus dem verzeichneten Inhalt jedes Pins statt aus einem Live-Lesen auf dem Host, sodass die Build-Ausgabe gegenüber einer Änderung der Quelldatei nach dem Pull unveränderlich bleibt. Fehlt, wenn die Anbindung keine deklariert. |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.mutators[].sources[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
content | string | ja | Der Inhalt der Quelldatei, unverändert mitgeführt, sodass der Build die Quelleingabe des Plugins aus dem Lockfile rekonstruiert. |
digest | string | ja | Die Inhaltsadresse des verzeichneten Inhalts, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Ein erneuter Pull vergleicht die zugrunde liegende Datei mit diesem Digest, um Drift zu erkennen. Muster: ^sha256:[a-f0-9]{64}$. |
path | string | ja | Der Basisname der Quelldatei — nie ein absoluter Host-Pfad, sodass der Pin portabel und deterministisch ist. |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.plugins[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
uri | string | ja | Bloße Identität des .wasm-Artefakts des Wasm-Plugins — der Pfad <pluginType>/<name> (z. B. governance/aggrega-security-baseline). Das erste Segment ist die Art des Plugins (provider, linter, pipeline-step, governance, cli, parser, importer); das Segment danach ist der Name des Plugins. Art und Name bilden zusammen die Identität des Plugins — derselbe Name unter zwei Arten sind zwei Plugins. Der physische Abrufort wird aus dieser Identität und der konfigurierten Registry abgeleitet und nie im Lockfile mitgeführt. |
resolved_version | string | ja | Der Inhalts-Digest, zu dem das Wasm-Artefakt aufgelöst wurde, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Ein Plugin-Artefakt ist inhaltsadressiert statt nach Version benannt — eine .wasm reist inline in der Manifestdatei ihres Plugins mit und wird über den Digest ihrer Bytes gepinnt —, daher verzeichnet dieses Feld diesen Digest, der auch der digest unten ist. Es bildet den Cache-Slot, aus dem der Build das Artefakt zurückliest, daher enthält es kein /, kein \ und kein .., was die sha256:-Form bereits ausschließt. Muster: ^sha256:[a-f0-9]{64}$. |
digest | string | ja | Inhalts-Digest des aufgelösten Wasm-Artefakts, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen — die Form, in der die Inhaltsadresse überall geschrieben wird, wo sie verglichen wird. Muster: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | nein | OCI-Manifestdigest des aufgelösten Wasm-Artefakts, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Die Signatur bezieht sich verbindlich auf diesen Digest; der digest des Inhalts oben ist die portable Identität, die für den Cache-Pin und die Integritätsprüfung verwendet wird. Nur für ein aus einer Registry aufgelöstes Artefakt vorhanden. Muster: ^sha256:[a-f0-9]{64}$. |
referenced_from | string[] | nein | Warum dieses Artefakt im Abhängigkeitsabschluss des Release liegt: die Referenz jeder Plugin-Entität, über die es erreicht wurde, so wie der Abschnitt entities diese Entität verzeichnet (z. B. governance/label-injector:1.0.0). Standardwert: [] |
signature | VerifiedSignature | nein | Fakt der verifizierten Signatur, verzeichnet, als die Signatur dieses Plugins zum Zeitpunkt des Pulls verifiziert wurde, gegen dieselbe registryspezifische Vertrauensrichtlinie wie bei Katalogentitäten. |
deprecation | DeprecationRecord | nein | Verifizierte rückwirkende Deprecation-Markierung, verzeichnet, als zum Zeitpunkt des Pulls eine signierte, vertrauenswürdige Deprecation-Markierung an diesem Artefakt entdeckt wurde. Eine Markierung ist ein signierter OCI-Referrer des Artefakts, das sie als veraltet kennzeichnet, nach der Veröffentlichung angehängt, ohne das Artefakt erneut zu veröffentlichen. Verzeichnet den Schweregrad und die Meldung der Markierung sowie den verifizierten Signierer, der sie verfasst hat. Der Build liest diesen Fakt und setzt die Deprecation-Richtlinie allein anhand des Lockfiles durch; er entdeckt oder verifiziert die Markierung nie erneut. |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.providers[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
capability | string | ja | Die Fähigkeit, für die diese Bindung einen Provider wählt — der bloße Name der Fähigkeit, den ein Recipe über spec.capability bindet (z. B. helm, compose). |
plugin | string | ja | Bloße Identität des aufgelösten Provider-Rendering-Plugins (die Identität der Plugin-Entität, also ihr metadata.pluginType und ihr metadata.name, durch einen Schrägstrich verbunden, z. B. provider/helm). Verknüpft über die Identität mit den Abschnitten plugins und entities für den gepinnten Digest und die Versionsmenge. |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.release_documents[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
digest | string | ja | Der Inhalts-Digest der Bytes der Release-Datei, als die Auflösung sie gelesen hat, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Muster: ^sha256:[a-f0-9]{64}$. |
path | string | ja | Der Pfad der Release-Datei relativ zu dem Verzeichnis, das das Release enthält, zu dem dieses Lockfile gehört, mit Schrägstrichen (z. B. release-prod.yaml, ../shared/base-release.yaml) — nie ein absoluter Host-Pfad, sodass der Eintrag portabel und deterministisch ist. |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.toolchain
Versionen der Toolchain, die dieses Lockfile erzeugt hat: die eigene Version des Compilers und die Version jedes Core-Plugins, das der Compiler mitbringt. Verzeichnet, damit ein Lockfile im Nachhinein beantwortet, welcher Compiler und welche Core-Plugins einen Build aufgelöst und gerendert haben — eine Frage, die die gepinnten Abschnitte nicht immer beantworten können, weil ein Core-Provider-Plugin, das aus dem Compiler-Binary heraus bedient wird, ungepinnt bleibt und daher keine eigene verzeichnete Version trägt. Nur Versionen: Der Stempel verzeichnet nie, woher die Bytes eines Plugins stammen, sodass zwei Maschinen, die denselben Abhängigkeitsabschluss mit demselben Compiler gepinnt haben, denselben Stempel schreiben. Nichts vergleicht diesen Abschnitt, warnt seinetwegen oder lehnt seinetwegen einen Build ab, und sein Fehlen in einem Lockfile bleibt stumm: Die Toolchain ist nicht Teil des Abhängigkeitsabschlusses, den das Lockfile pinnt. Aus demselben Grund ist der Abschnitt vom Byteidentitätsvergleich zwischen zwei Pulls derselben Eingaben ausgenommen, gleichrangig mit generated_at.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
compiler_version | string | ja | Version des Compilers, der dieses Lockfile geschrieben hat, in der Form ohne v, die jede Aggrega-Oberfläche meldet (1.2.0, nicht v1.2.0). Ein mit einer Version gestempelter Build verzeichnet diese Version — ein getaggter Veröffentlichungs-Build seinen Tag —, und ein Build ohne Versionsstempel verzeichnet die Markierung (devel), sodass ein von einem ungestempelten Compiler erzeugtes Lockfile nicht für eine Veröffentlichungsausgabe gehalten wird. Als einzelnes Pfadsegment verzeichnet, daher enthält sie kein /, kein \ und kein ... Muster: ^([^/\\.]|\.[^/\\.])*\.?$. |
core_plugins | object[] | ja | Version jedes Core-Plugins, das der Compiler mitführt, ein Eintrag pro Plugin, nach Plugin-Koordinate geordnet. Ein Core-Plugin wird auf dem eigenen Tag des Compilers in derselben Version veröffentlicht, daher lauten diese Versionen gleich, ob der Compiler ein Plugin aus seinem Inneren bedient oder aus einer Registry abgerufen hat — was den Stempel frei von maschinenspezifischen Details hält. Leer für einen Build, der keine Core-Plugins mitführt. Standardwert: [] |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.toolchain.core_plugins[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
plugin | string | ja | Koordinate des Core-Plugins — die <pluginType>/<name>-Identität einer Plugin-Entität (z. B. provider/helm), dieselbe Identität, über die die Abschnitte providers und mutators ein Plugin benennen. |
version | string | ja | Version dieses Core-Plugins, in der Form ohne v, die jede Aggrega-Oberfläche meldet. Als einzelnes Pfadsegment verzeichnet, daher enthält sie kein /, kein \ und kein ... Muster: ^([^/\\.]|\.[^/\\.])*\.?$. |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.verdict_inputs[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
plugin | string | ja | Der verfasste Plugin-URI der Verdikt-Anbindung, wie in .aggrega-config.yaml plugins.governance geschrieben (z. B. governance/aggrega-security-baseline:1.0.0). Identifiziert, zu welcher Anbindung die verzeichneten Regeleingaben gehören; ein Verdikt-Plugin wird zwischengespeichert statt gepinnt, daher hat es keinen Eintrag in den Abschnitten plugins / entities, mit dem es verknüpft werden könnte. |
role | string (enum) | ja | Die Verdikt-Rolle, an die diese Anbindung gebunden ist — ir-verdict (bei der statischen Analyse, über den IR-Graphen) oder render-verdict (beim Rendern, über die gerenderten Artefakte). Unterscheidet dasselbe Plugin, das in beiden Verdikt-Phasen angebunden ist, jeweils möglicherweise mit eigenen Regeleingaben. Zulässige Werte: "ir-verdict", "render-verdict" |
sources | object[] | nein | Inhalts-Digests der deklarierten Regeleingabedateien der Anbindung, in der Reihenfolge der Basisnamen. Fehlt, wenn die Anbindung keine Quellen deklariert. |
Zusätzliche Eigenschaften sind nicht zulässig.
lockfile.verdict_inputs[].sources[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
digest | string | ja | Die Inhaltsadresse der Bytes der Regeleingabedatei zum Zeitpunkt des Pulls, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Ein erneuter Pull berechnet sie neu, sodass eine geänderte Regeldatei als Lockfile-Diff sichtbar wird. Muster: ^sha256:[a-f0-9]{64}$. |
path | string | ja | Der Basisname der Regeleingabedatei — nie ein absoluter Host-Pfad, sodass der Eintrag portabel und deterministisch ist. |
Zusätzliche Eigenschaften sind nicht zulässig.
Definitionen
DeprecationRecord
Verifizierte rückwirkende Deprecation-Markierung, verzeichnet, als zum Zeitpunkt des Pulls eine signierte, vertrauenswürdige Deprecation-Markierung an diesem Artefakt entdeckt wurde. Eine Markierung ist ein signierter OCI-Referrer des Artefakts, das sie als veraltet kennzeichnet, nach der Veröffentlichung angehängt, ohne das Artefakt erneut zu veröffentlichen. Verzeichnet den Schweregrad und die Meldung der Markierung sowie den verifizierten Signierer, der sie verfasst hat. Der Build liest diesen Fakt und setzt die Deprecation-Richtlinie allein anhand des Lockfiles durch; er entdeckt oder verifiziert die Markierung nie erneut.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
message | string | ja | Menschenlesbare Deprecation-Meldung, die die Markierung trägt — typischerweise ein Hinweis zur Migration. |
severity | string (enum) | ja | Schweregrad der Markierung, geordnet warning < error < retracted. Der Build bricht ab, wenn dieser Schweregrad den konfigurierten Abbruch-Schwellenwert erreicht oder überschreitet, und gibt andernfalls einen Hinweis aus. Zulässige Werte: "warning", "error", "retracted" |
signer | VerifiedSignature | nein | Verifizierter Signierer der Markierung, auf dieselbe Weise verzeichnet wie der Signierer einer Artefaktsignatur: das Zertifikatssubjekt bzw. der Zertifikatsaussteller bei Keyless, oder der Fingerabdruck des gepinnten Schlüssels bei schlüsselbasiertem Signieren. Eine Markierung ist ein eigenständiges signiertes Artefakt, daher hat ihr Signierer dieselbe Form wie eine Artefaktsignatur — und der bundle_digest hier nennt das eigene Signatur-Bundle der Markierung statt das des als veraltet gekennzeichneten Artefakts. |
Zusätzliche Eigenschaften sind nicht zulässig.
ExternalInput
Eine einzelne gepinnte externe Eingabe: die URL, die ein Rendering angefordert hat, der SHA-256-Pin, der ihre Bytes im inhaltsadressierten Eingabespeicher benennt (sha256/<digest>), die Payload-Größe und die Herkunft der Verbraucher, die sie benötigt haben. Der Pin ist maßgeblich — eine gepinnte URL wird immer aus dem Speicher bedient, und ein Nachfüllen des Speichers wird gegen diesen Digest geprüft, bevor die Bytes ein Rendering erreichen.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
required_by | string[] | ja | Herkunft — die Render-Stellen, die diese Eingabe angefordert haben. Vom Lockfile-Schreiber sortiert und dedupliziert. |
sha256 | string | ja | SHA-256-Pin in kleingeschriebenem Hexadezimal. Bei einer https-Eingabe der Digest der Payload-Bytes; bei einer oci-Eingabe der Manifestdigest, zu dem die Referenz aufgelöst wurde. Benennt den Speicher-Blob unter sha256/<digest>. Muster: ^[0-9a-f]{64}$. |
size | integer | ja | Größe der gepinnten Payload in Bytes. Eine Byteanzahl ist nie negativ. Minimum: 0. |
url | string | ja | Die Eingabe-URL, wie an der Render-Stelle verfasst — der Suchschlüssel, der eine Anfrage zur Render-Zeit ihrem Pin zuordnet. |
Zusätzliche Eigenschaften sind nicht zulässig.
LibraryEntry
Gemeinsame Form, die die Einträge von schema_libraries, mapping_libraries, workload_libraries und artifact_libraries teilen. Die consumers-Liste erfasst die Beziehung im Katalog-Graphen — welche Katalogentität auf welche <entry-name>-Fragmente dieser Bibliothek verweist — und unterstützt strukturierte Diffs der Auswirkungen, wenn sich der Digest der Bibliothek ändert. Eine Bibliothek ist ein OCI-Artefakt wie jedes andere, daher verzeichnet sie dieselben verifizierten Fakten wie eine Katalogentität: den Manifestdigest, auf den sich ihre Signatur verbindlich bezieht, die verifizierte Signatur selbst und jede verifizierte rückwirkende Deprecation-Markierung, die zum Zeitpunkt des Pulls entdeckt wurde.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
uri | string | ja | Kanonischer URI der Bibliotheksentität. |
resolved_version | string | ja | Konkrete Version, die zum Zeitpunkt des Pulls aufgelöst wurde (Minimalversionsauswahl über den Abhängigkeitsgraphen der Bibliotheken) — die eigene Version der Bibliothek. Als einzelnes Pfadsegment verzeichnet, weil sie den Cache-Slot bildet, aus dem der Build die Bibliothek zurückliest, daher enthält sie kein /, kein \ und kein ..: Ein Wert, der aus dem Cache-Verzeichnis heraustritt, würde einen Ort außerhalb davon benennen. Muster: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | ja | Inhalts-Digest des aufgelösten Bibliotheksartefakts, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen — die Form, in der die Inhaltsadresse überall geschrieben wird, wo sie verglichen wird. Muster: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | nein | OCI-Manifestdigest des aufgelösten Bibliotheksartefakts, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Die Signatur bezieht sich verbindlich auf diesen Digest; der digest des Inhalts oben ist die portable Identität, die für den Cache-Pin und die Integritätsprüfung verwendet wird. Nur für eine aus einer Registry aufgelöste Bibliothek vorhanden. Muster: ^sha256:[a-f0-9]{64}$. |
signature | VerifiedSignature | nein | Fakt der verifizierten Signatur, verzeichnet, als die Signatur dieser Bibliothek zum Zeitpunkt des Pulls verifiziert wurde, gegen dieselbe registryspezifische Vertrauensrichtlinie wie bei Katalogentitäten. |
deprecation | DeprecationRecord | nein | Verifizierte rückwirkende Deprecation-Markierung, die zum Zeitpunkt des Pulls an dieser Bibliothek entdeckt wurde. Der Build meldet sie und bricht ab, wo der Workspace einen Abbruch-Schwellenwert konfiguriert hat, den der verzeichnete Schweregrad erreicht — sodass eine Bibliothek, die nach dem Pinnen der Version zurückgezogen wurde, bei jedem Build angekündigt wird statt nur bei der Versionsauswahl, die eine explizit gepinnte Version umgeht. |
consumers | object[] | nein | Datensätze darüber, welche Katalogentität auf diese Bibliothek verweist und auf welche <entry-name>-Fragmente. Erfasst den Fan-in: viele Verbraucher pro Bibliothek, von denen jeder möglicherweise auf viele Fragmente verweist. Jeder Datensatz trägt den URI des Verbrauchers sowie die Menge der Fragmente, die dieser Verbraucher einbezieht. Standardwert: [] |
Zusätzliche Eigenschaften sind nicht zulässig.
LibraryEntry.consumers[]
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
consumer_uri | string | ja | Kanonischer URI der Katalogentität, die auf diese Bibliothek verweist: eine Component oder ein Feature bei einer Schema-Bibliothek, ein Recipe oder ein FeatureRecipe bei einer Mapping-, Arbeitslast- oder Artefakt-Bibliothek, oder eine andere Bibliothek derselben Art, deren Einträge auf diese verweisen. |
fragments | string[] | ja | Menge der <entry-name>-Fragmente, auf die dieser Verbraucher innerhalb der Bibliothek verweist (z. B. ["#/schemas/PortSpec", "#/schemas/EndpointSpec"]). Die Reihenfolge wird vom Schreiber lexikografisch kanonisiert. |
Zusätzliche Eigenschaften sind nicht zulässig.
SourceArtifactEntry
Ein einzelner Pin eines Quellartefakts: die Identität {kind, url, chart, module_subdir, pinned_version}, der Inhalts-Digest, der den Pull verifiziert, der kanonische Medientyp und die strukturierten Rückverweise auf jede Katalogentität, die zu diesem Artefakt aufgelöst wurde. chart und module_subdir sind die beiden Selektorbegriffe — jeder benennt, was die URL allein nicht benennt, für die Arten, die einen benötigen.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
kind | enum | ja | Die Quellart. Bestimmt, welcher Adapter das Artefakt aufgelöst hat und welcher Medientyp erwartet wird. terraform-module-oci gehört zur Menge, und kein Quelladapter bedient es: Ein Recipe oder FeatureRecipe, das es nennt, wird beim Lesen abgelehnt. 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 in spec.source.url des Recipe geschrieben ist. Für helm-https-chart ist dies die Repository-Wurzel (Repository-Wurzel-Form) oder die direkte .tgz (direkte Form), genau wie verfasst; der Build rekonstruiert dieselbe URL offline, daher ist sie die stabile Identität, nach der der Pin geschlüsselt ist. Für git-repository die klonbare Repository-URL. Für helm-oci-chart die Registry-Referenz. Für 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. |
chart | string | nein | Der Chart-Name für eine helm-Quelle mit Repository-Wurzel (spec.source.chart des Recipe), Teil der Identität {kind, url, chart, module_subdir, pinned_version}, sodass zwei Charts, die aus einer Repository-Wurzel in derselben Version bedient werden, auf unterschiedliche Einträge gepinnt werden. Fehlt bei einer direkten .tgz-, OCI-, compose- oder git-Quelle, von denen keine einen Chart innerhalb der URL auswählt. |
module_subdir | string | nein | Das Verzeichnis innerhalb eines aus git bezogenen Repositorys, das das Artefakt ist (spec.source.module_subdir des Recipe), Teil der Identität {kind, url, chart, module_subdir, pinned_version}, sodass zwei Verzeichnisse eines Repositorys beim selben Commit auf unterschiedliche Einträge gepinnt werden. Fehlt, wenn das gesamte Repository das Artefakt ist, sowie bei jeder Art, die ihr Artefakt über eine URL erreicht statt durch Absteigen in einen Klon. |
pinned_version | string | ja | Die konkrete Version, die zum Zeitpunkt des Pulls gepinnt wurde. Bei helm-*-Arten die Chart-Version. Bei git-repository der Commit, zu dem die verfasste Referenz aufgelöst wurde (NICHT die ursprüngliche Tag-/Branch-Referenz — diese wird unter requested_ref: an jedem referenced_by:-Eintrag verzeichnet, sobald das Recipe ein spec.source.ref: verfasst hat). Ein Build findet diesen Eintrag anhand dessen, was das Recipe geschrieben hat: das verfasste ref:, wo es eines gibt, abgeglichen mit dem verzeichneten requested_ref:, und andernfalls dieser gepinnte Wert — sodass ein Recipe, das einen Tag nennt, zu dem Commit aufgelöst wird, an dem dieser Tag gepinnt wurde, ohne dass der Commit je im Recipe erscheint. Als einzelnes Pfadsegment verzeichnet, weil sie den Cache-Slot bildet, aus dem der Build das Artefakt zurückliest, daher enthält sie kein /, kein \ und kein ... Muster: ^([^/\\.]|\.[^/\\.])*\.?$. |
resolved_url | string | nein | Nur Herkunft: der konkrete Artefaktort, zu dem die verfasste URL zum Zeitpunkt des Pulls aufgelöst wurde. Für eine helm-Quelle mit Repository-Wurzel ist dies die direkte .tgz-URL, zu der der Repository-Index Chart+Version aufgelöst hat; sie wird zur Diagnose verzeichnet und ist NICHT Teil der Artefaktidentität. Fehlt, wenn der aufgelöste Ort der verfassten URL entspricht (eine direkte .tgz-, OCI-, compose- oder git-Quelle). |
digest | string | ja | Inhalts-Digest des aufgelösten .tar.gz-Archivs, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Die Verifizierung zur Build-Zeit liest die Bytes des Cache-Slots, berechnet den Digest neu und vergleicht ihn mit diesem Feld; eine Abweichung bricht den Build ab und meldet eine Abweichung des Inhalts-Digests. Muster: ^sha256:[a-f0-9]{64}$. |
manifest_digest | string | nein | OCI-Manifestdigest des aufgelösten Artefakts, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Die Manifestdatei ist die unabhängige Vertrauenswurzel, gegen die das zwischengespeicherte Archiv geprüft wird; der digest des Inhalts oben ist die portable Identität, die für den Cache-Pin und die Integritätsprüfung verwendet wird. Nur für eine über OCI verteilte Quelle (ein helm-oci-chart) vorhanden. Muster: ^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. |
referenced_by | SourceArtifactReference[] | ja | Katalogentitäten, die zu diesem Artefakt aufgelöst wurden, für deterministische Ausgabe nach (uri, field) sortiert. Ein Eintrag existiert nur, weil ein Recipe oder FeatureRecipe ihn per Pull bezogen hat, daher ist die Liste nie leer. Mindestens 1 Eintrag. |
Zusätzliche Eigenschaften sind nicht zulässig.
SourceArtifactReference
Ein einzelner Rückverweis Katalogentität → Quellartefakt. entity + uri identifizieren zusammen die Katalogentität; field benennt den quellseitigen Pfad innerhalb der Spec der Entität, an dem das Artefakt deklariert wurde. Das optionale requested_ref: bewahrt das verfasste spec.source.ref: des Recipe und wird geschrieben, sobald das Recipe eines verfasst hat (git-repository-Tags/-Branches → Commit-SHA).
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
entity | enum | ja | Die Art der Katalogentität, die diesen Rückverweis enthält. Zulässige Werte: "recipe", "feature_recipe" |
uri | string | ja | Kanonischer URI des Recipe oder FeatureRecipe (z. B. hub.aggrega.ai/recipe/helm/mariadb-bitnami:1.0.0). |
field | string | ja | Quellseitiger Pfad innerhalb der Spec der Entität, an dem das Artefakt deklariert wurde. Der Wert ist spec.source. |
requested_ref | string | nein | Optional — das verfasste spec.source.ref: des Recipe, geschrieben, sobald das Recipe eines verfasst hat. Für ein git-repository-Recipe, das ref: v1.0.0 verfasst, bewahrt dies "v1.0.0", während pinned_version: den Commit enthält, zu dem diese Referenz aufgelöst wurde. Fehlt, wenn das Recipe kein ref: verfasst, was für jede Art gilt, deren Resolver die verfasste Version unverändert pinnt (helm-, compose-). Es erfüllt zwei Aufgaben zugleich, und dass es bedingungslos verzeichnet wird, verhindert, dass sie einander ausschließen. Ein Build nutzt es als Verknüpfungsschlüssel, um diesen Eintrag von einem Recipe aus zu finden, das die Referenz statt des Commits nennt. Und ein pull, der kein Upgrade ist, hält jede verzeichnete Referenz an ihrer gepinnten Version fest: Eine Referenz, die sich an ihrem Remote verschoben hat, bricht den Lauf ab, statt übernommen zu werden. |
Zusätzliche Eigenschaften sind nicht zulässig.
VerifiedSignature
Fakt der verifizierten Signatur, verzeichnet, als die Signatur eines Artefakts zum Zeitpunkt des Pulls verifiziert wurde, gegen die Vertrauensrichtlinie der auflösenden Registry. Jedes signierbare Artefakt verzeichnet ihn auf dieselbe Weise — eine Katalogentität, eine Bibliothek, ein Wasm-Plugin —, weil alle über einen einzigen Pfad verifiziert werden statt über einen pro Art. Verzeichnet den Verifizierungsmodus, die Keyless-Identität bzw. den Keyless-Aussteller, die übereinstimmten (bei Keyless), und den inhaltsadressierten Digest des Signatur-Bundles im Inhaltscache. Der Build führt die Verifizierung nicht erneut aus. Bevor irgendetwas gerendert wird, liest er diesen Fakt an jedem Eintrag, aus dem er baut, in jedem Abschnitt: Er hasht das zwischengespeicherte Bundle erneut und vergleicht das Ergebnis mit bundle_digest, wobei er abbricht, wo der Blob fehlt oder abweicht; und für einen Eintrag, den der Inhaltscache bedient hat, liest er aus diesem Bundle, für welches Artefakt die Signatur erstellt wurde, und bricht ab, wo sie für ein anderes Artefakt erstellt wurde als das, das der Build für den Eintrag gelesen hat — sodass eine von einem Eintrag auf einen anderen kopierte signature abgelehnt wird, unabhängig davon, was die Signaturanforderung besagt. Ein Build verifiziert keine Signatur, daher wird ein von Hand in den Cache geschriebenes Bundle, das auf das eigene Artefakt des Eintrags ausgestellt ist, nicht von einem unterschieden, das ein Pull verifiziert hat. Und wo die Vertrauenskonfiguration des Workspace eine Signatur für einen Eintrag verlangt, den der Inhaltscache bedient hat — die Anforderung, die pull anwendet, wenn er das Artefakt abruft, sodass die Ausnahmen und eine advisory-Registry, die einen Pull ein Artefakt ohne Signatur zulassen lassen, auch den Build dessen Eintrag zulassen lassen —, bricht ein Eintrag, der keinen Fakt trägt, den Build ab. Ein Eintrag, der aus einem Katalogverzeichnis, aus der Kopie im Compiler-Binary oder von neben dem Release gelesen wird, wird nie an dieser Anforderung gemessen.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
bundle_digest | string | ja | SHA-256-Digest des zwischengespeicherten Signatur-Bundle-Blobs, in der Form sha256:, gefolgt von 64 kleingeschriebenen Hexadezimalzeichen. Er benennt den Cache-Blob, bildet daher einen Pfad und enthält kein /, kein \ und kein .. — was die sha256:-Form bereits ausschließt —, und an einem Eintrag jedes Abschnitts ist er das, wogegen ein Build diesen Blob erneut hasht. Muster: ^sha256:[a-f0-9]{64}$. |
identity | string | nein | Verifizierter Signierer der Signatur: das Subjekt des Signaturzertifikats bei einer Keyless-Signatur oder keyed:sha256:, gefolgt vom SHA-256 des PEM-Texts des gepinnten öffentlichen Schlüssels, bei einer schlüsselbasierten Signatur. |
issuer | string | nein | Verifizierter OIDC-Aussteller für eine Keyless-Signatur. Leer bei einer schlüsselbasierten Signatur. |
mode | string (enum) | ja | Verifizierungsmodus, der die Signatur zugelassen hat. Zulässige Werte: "keyless", "keyed" |
Zusätzliche Eigenschaften sind nicht zulässig.