Esquema del contexto de las plantillas de ruta de Aggrega
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/path-template-context-v1beta1.schema.json
La lista de variables permitidas que consumen las plantillas Go evaluadas frente a Release.spec.boundaries[].directory y Release.spec.boundaries[].subDirectory (y a la anulación de subDirectory por componente) cuando Aggrega compila la Release. Las plantillas de ruta usan missingkey=error (a diferencia del régimen global missingkey=zero de las plantillas de valor) más la validación en tiempo de análisis: toda referencia a un campo en una plantilla de ruta debe aparecer en esta lista de variables permitidas para el contexto correspondiente (directory: frente a subDirectory:); los campos desconocidos producen un error Loud Guardrail en tiempo de análisis, nunca en tiempo de renderizado. La página sobre las variables de las plantillas de ruta de la referencia del lenguaje enseña la diferencia con las plantillas de valor.
Tipo de nivel superior: object
Propiedades
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
capability | string | no | Disponible en directory: Y subDirectory:. La capacidad de renderizado que la Recipe del componente contribuyente declara en spec.capability, sin ninguna fijación de versión — por ejemplo ‘helm’, ‘helm-chart’ o ‘compose’. subDirectory: toma por defecto {{ .capability }}, que es lo que coloca los artefactos de cada capacidad en su propia subcarpeta bajo el directorio del límite. En una plantilla directory: el valor se resuelve por componente, así que un límite cuyo subárbol aporta más de una capacidad se evalúa en un directorio por capacidad; el recorrido separado por límite que publica .parent_boundary.directory se ejecuta antes de que se vincule ningún componente y deja este valor vacío. |
boundary_name | string | no | Disponible en directory: Y subDirectory:. La clave del mapa en release.spec.boundaries. |
parameters | object | no | Disponible en directory: Y subDirectory:. Mapa tipado de parámetros procedente de la Release. Las plantillas de ruta reciben acceso a .parameters como excepción deliberada al ciclo de vida de una sola pasada de parameters — las plantillas de valor NO reciben .parameters; los valores que dependen del entorno llegan a las plantillas de valor a través del YAML del Aggregate ya interpolado. |
component_id | string | no | Disponible SOLO en subDirectory:. La identidad del contribuidor que se coloca. Para un componente, su ID de instancia aplanado por componente (p. ej., ‘backend’ o ‘data-layer.main-db’). Para una Feature vinculada a una frontera cuya FeatureRecipe se ejecuta una sola vez para la frontera (executionScope: boundary), la identidad de componente compuesta que lleva en su etiqueta aggrega.ai/component-id cada recurso que emite esa vinculación (p. ej., ‘bfr—app—shared’ para una vinculación ‘shared’ en la frontera ‘app’), acortada donde el plugin de renderizado de la vinculación limita los nombres, de modo que el directorio que nombra coincida con esa etiqueta. Sin significado a nivel de frontera y rechazado por la validación en tiempo de análisis en las plantillas directory:. |
parent_boundary | object | no | Disponible en directory: Y subDirectory:. Los valores ya resueltos del límite padre. Se rellena mediante un recorrido en profundidad que evalúa las plantillas de cada límite con los valores resueltos de su padre; los hijos nunca ven aquí sus propios valores. Un límite de nivel superior no tiene padre, así que una clave leída bajo parent_boundary en ese caso detiene la compilación, nombrando el límite, el campo de la plantilla y la clave que falta. |
manifest | object | no | Disponible en directory: Y subDirectory:. Lleva los metadatos de la Recipe resuelta tal como se evalúan por componente. |
No se permiten propiedades adicionales.
path-template-context.parent_boundary
Disponible en directory: Y subDirectory:. Los valores ya resueltos del límite padre. Se rellena mediante un recorrido en profundidad que evalúa las plantillas de cada límite con los valores resueltos de su padre; los hijos nunca ven aquí sus propios valores. Un límite de nivel superior no tiene padre, así que una clave leída bajo parent_boundary en ese caso detiene la compilación, nombrando el límite, el campo de la plantilla y la clave que falta.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
directory | string | no | Cadena del directorio evaluado del padre. |
boundary_name | string | no | Nombre del padre (la clave del mapa en release.spec.boundaries). |
parameters | object | no | El mapa de parámetros de la Release — el mismo mapa que lleva .parameters. |
annotations | mapa de string | no | Las anotaciones del límite padre una vez resuelta la cascada. |
No se permiten propiedades adicionales.
path-template-context.manifest
Disponible en directory: Y subDirectory:. Lleva los metadatos de la Recipe resuelta tal como se evalúan por componente.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
recipe_name | string | no | El nombre de la Recipe resuelta a partir de la búsqueda por componente. |
No se permiten propiedades adicionales.