Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

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

PropiedadTipoObligatoriaDescripción
capabilitystringnoDisponible 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_namestringnoDisponible en directory: Y subDirectory:. La clave del mapa en release.spec.boundaries..
parametersobjectnoDisponible 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_idstringnoDisponible 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_boundaryobjectnoDisponible 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.
manifestobjectnoDisponible 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.

PropiedadTipoObligatoriaDescripción
directorystringnoCadena del directorio evaluado del padre.
boundary_namestringnoNombre del padre (la clave del mapa en release.spec.boundaries).
parametersobjectnoEl mapa de parámetros de la Release — el mismo mapa que lleva .parameters.
annotationsmapa de stringnoLas 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.

PropiedadTipoObligatoriaDescripción
recipe_namestringnoEl nombre de la Recipe resuelta a partir de la búsqueda por componente.

No se permiten propiedades adicionales.