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

Aggrega-Schema für den Pfadvorlagen-Kontext

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

Schema-ID: https://aggrega.ai/schemas/path-template-context-v1beta1.schema.json

Die Allowlist der Variablen, die von Go-Vorlagen verbraucht wird, die gegen Release.spec.boundaries[].directory und Release.spec.boundaries[].subDirectory (und die komponentenspezifische subDirectory-Überschreibung) ausgewertet werden, wenn Aggrega das Release baut. Pfadvorlagen verwenden missingkey=error (anders als das globale Regime missingkey=zero für Wertvorlagen) sowie eine Validierung zur Parse-Zeit: Jede Feldreferenz in einer Pfadvorlage muss in dieser Allowlist für den jeweiligen Kontext erscheinen (directory: gegenüber subDirectory:); unbekannte Felder erzeugen einen Loud-Guardrail-Fehler zur Parse-Zeit, nie zur Render-Zeit. Die Seite über Pfadvorlagen-Variablen in der Sprachreferenz erklärt den Unterschied zu Wertvorlagen.

Typ der obersten Ebene: object

Eigenschaften

EigenschaftTypErforderlichBeschreibung
capabilitystringneinVerfügbar in directory: UND subDirectory:. Die Rendering-Fähigkeit, die das Recipe der beitragenden Komponente in spec.capability deklariert, ohne jeden Versions-Pin — zum Beispiel ‘helm’, ‘helm-chart’ oder ‘compose’. subDirectory: hat standardmäßig den Wert {{ .capability }}, was die Artefakte jeder Fähigkeit in einem eigenen Unterordner unterhalb des Verzeichnisses der Boundary ablegt. In einer Vorlage für directory: wird der Wert pro Komponente aufgelöst, sodass eine Boundary, deren Teilbaum mehr als eine Fähigkeit beiträgt, zu einem Verzeichnis pro Fähigkeit ausgewertet wird; der separate Durchlauf pro Boundary, der .parent_boundary.directory veröffentlicht, läuft, bevor irgendeine Komponente gebunden ist, und lässt diesen Wert leer.
boundary_namestringneinVerfügbar in directory: UND subDirectory:. Der Map-Schlüssel in release.spec.boundaries..
parametersobjectneinVerfügbar in directory: UND subDirectory:. Typisierte Parameter-Map aus dem Release. Pfadvorlagen erhalten Zugriff auf .parameters als bewusste Ausnahme vom Single-Pass-Lebenszyklus von parameters — Wertvorlagen erhalten .parameters NICHT; umgebungsabhängige Werte fließen über das bereits interpolierte Aggregate-YAML in Wertvorlagen ein.
component_idstringneinNUR in subDirectory: verfügbar. Die Identität des Beitragenden, der platziert wird. Für eine Komponente ihre abgeflachte Instanz-ID pro Komponente (z. B. ‘backend’ oder ‘data-layer.main-db’). Für ein an einer Boundary angebundenes Feature, dessen FeatureRecipe einmal für die Boundary läuft (executionScope: boundary), die zusammengesetzte Komponentenidentität, die jede von dieser Anbindung emittierte Ressource in ihrem Label aggrega.ai/component-id trägt (z. B. ‘bfr—app—shared’ für eine Anbindung ‘shared’ an der Boundary ‘app’), gekürzt, wo das Rendering-Plugin der Anbindung Namen begrenzt, sodass das Verzeichnis, das sie benennt, diesem Label entspricht. Auf Boundary-Ebene bedeutungslos und in Templates für directory: von der Validierung zur Parse-Zeit abgelehnt.
parent_boundaryobjectneinVerfügbar in directory: UND subDirectory:. Die bereits aufgelösten Werte der übergeordneten Boundary. Befüllt über einen Tiefendurchlauf, der die Vorlagen jeder Boundary mit den aufgelösten Werten ihrer übergeordneten Boundary auswertet; untergeordnete Boundaries sehen hier nie ihre eigenen Werte. Eine Boundary auf oberster Ebene hat keine übergeordnete, daher bricht ein dort unter parent_boundary gelesener Schlüssel den Build ab und nennt die Boundary, das Vorlagenfeld und den fehlenden Schlüssel.
manifestobjectneinVerfügbar in directory: UND subDirectory:. Trägt die Metadaten des aufgelösten Recipe, wie pro Komponente ausgewertet.

Zusätzliche Eigenschaften sind nicht zulässig.

path-template-context.parent_boundary

Verfügbar in directory: UND subDirectory:. Die bereits aufgelösten Werte der übergeordneten Boundary. Befüllt über einen Tiefendurchlauf, der die Vorlagen jeder Boundary mit den aufgelösten Werten ihrer übergeordneten Boundary auswertet; untergeordnete Boundaries sehen hier nie ihre eigenen Werte. Eine Boundary auf oberster Ebene hat keine übergeordnete, daher bricht ein dort unter parent_boundary gelesener Schlüssel den Build ab und nennt die Boundary, das Vorlagenfeld und den fehlenden Schlüssel.

EigenschaftTypErforderlichBeschreibung
directorystringneinAusgewertete Verzeichniszeichenkette der übergeordneten Boundary.
boundary_namestringneinName der übergeordneten Boundary (der Map-Schlüssel in release.spec.boundaries).
parametersobjectneinDie Parameter-Map des Release — dieselbe Map, die .parameters trägt.
annotationsMap von stringneinDie Annotationen der übergeordneten Boundary, nachdem die Kaskade aufgelöst ist.

Zusätzliche Eigenschaften sind nicht zulässig.

path-template-context.manifest

Verfügbar in directory: UND subDirectory:. Trägt die Metadaten des aufgelösten Recipe, wie pro Komponente ausgewertet.

EigenschaftTypErforderlichBeschreibung
recipe_namestringneinDer Name des aufgelösten Recipe aus der Suche pro Komponente.

Zusätzliche Eigenschaften sind nicht zulässig.