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
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
capability | string | nein | Verfü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_name | string | nein | Verfügbar in directory: UND subDirectory:. Der Map-Schlüssel in release.spec.boundaries. |
parameters | object | nein | Verfü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_id | string | nein | NUR 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_boundary | object | nein | 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. |
manifest | object | nein | Verfü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.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
directory | string | nein | Ausgewertete Verzeichniszeichenkette der übergeordneten Boundary. |
boundary_name | string | nein | Name der übergeordneten Boundary (der Map-Schlüssel in release.spec.boundaries). |
parameters | object | nein | Die Parameter-Map des Release — dieselbe Map, die .parameters trägt. |
annotations | Map von string | nein | Die 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.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
recipe_name | string | nein | Der Name des aufgelösten Recipe aus der Suche pro Komponente. |
Zusätzliche Eigenschaften sind nicht zulässig.