Схема контекста шаблонов путей Aggrega
Сгенерированный справочник. Не редактируйте вручную — сгенерируйте заново из опубликованной JSON Schema.
Идентификатор схемы: https://aggrega.ai/schemas/path-template-context-v1beta1.schema.json
Разрешённый список переменных, используемый шаблонами Go, которые вычисляются для Release.spec.boundaries[].directory и Release.spec.boundaries[].subDirectory (а также для переопределения subDirectory на уровне компонента), когда Aggrega собирает Release. Шаблоны путей используют missingkey=error (в отличие от глобального режима missingkey=zero для шаблонов значений) и проверку на этапе разбора: каждая ссылка на поле в шаблоне пути должна присутствовать в этом списке для соответствующего контекста (directory: или subDirectory:); неизвестные поля вызывают ошибку Loud Guardrail на этапе разбора, а не на этапе рендеринга. Отличие от шаблонов значений объясняется на странице «Переменные шаблонов путей» справочника по языку.
Тип верхнего уровня: object
Свойства
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
capability | string | нет | Доступно в directory: И subDirectory:. Возможность рендеринга, которую Recipe вносящего компонента объявляет в spec.capability, без закрепления версии — например, ‘helm’, ‘helm-chart’ или ‘compose’. По умолчанию subDirectory: равно {{ .capability }}, благодаря чему артефакты каждой возможности попадают в собственную подпапку внутри directory границы. В шаблоне directory: значение вычисляется для каждого компонента, поэтому граница, поддерево которой вносит более одной возможности, даёт по одному каталогу на возможность; отдельный обход по границам, публикующий .parent_boundary.directory, выполняется до привязки каких-либо компонентов и оставляет это значение пустым. |
boundary_name | string | нет | Доступно в directory: И subDirectory:. Ключ карты в release.spec.boundaries. |
parameters | object | нет | Доступно в directory: И subDirectory:. Типизированная карта параметров из Release. Шаблоны путей получают доступ к .parameters как намеренное исключение из однопроходного жизненного цикла параметров — шаблоны значений НЕ получают .parameters; значения, зависящие от окружения, попадают в шаблоны значений через уже интерполированный YAML сущности Aggregate. |
component_id | string | нет | Доступно ТОЛЬКО в subDirectory:. Идентичность размещаемого участника. Для компонента — его уплощённый идентификатор экземпляра на уровне компонента (например, ‘backend’ или ‘data-layer.main-db’). Для сущности Feature, присоединённой на границе, сущность FeatureRecipe которой выполняется один раз для границы (executionScope: boundary), — составная идентичность компонента, которую каждый ресурс, выпускаемый этим присоединением, несёт в своей метке aggrega.ai/component-id (например, ‘bfr—app—shared’ для присоединения ‘shared’ на границе ‘app’), сокращённая там, где плагин рендеринга присоединения ограничивает имена, чтобы называемый ею каталог совпадал с этой меткой. Не имеет смысла на уровне границы и отклоняется проверкой при разборе в шаблонах directory:. |
parent_boundary | object | нет | Доступно в directory: И subDirectory:. Уже вычисленные значения родительской границы. Заполняются обходом в глубину, при котором шаблоны каждой границы вычисляются с вычисленными значениями её родителя; дочерние границы никогда не видят здесь собственных значений. У границы верхнего уровня нет родителя, поэтому чтение ключа под parent_boundary в ней останавливает сборку с указанием границы, поля шаблона и отсутствующего ключа. |
manifest | object | нет | Доступно в directory: И subDirectory:. Содержит вычисленные метаданные Recipe, определяемые для каждого компонента. |
Дополнительные свойства не допускаются.
path-template-context.parent_boundary
Доступно в directory: И subDirectory:. Уже вычисленные значения родительской границы. Заполняются обходом в глубину, при котором шаблоны каждой границы вычисляются с вычисленными значениями её родителя; дочерние границы никогда не видят здесь собственных значений. У границы верхнего уровня нет родителя, поэтому чтение ключа под parent_boundary в ней останавливает сборку с указанием границы, поля шаблона и отсутствующего ключа.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
directory | string | нет | Вычисленная строка directory родителя. |
boundary_name | string | нет | Имя родителя (ключ карты в release.spec.boundaries). |
parameters | object | нет | Карта параметров Release — та же карта, что несёт .parameters. |
annotations | map of string | нет | Аннотации родительской границы после разрешения каскада. |
Дополнительные свойства не допускаются.
path-template-context.manifest
Доступно в directory: И subDirectory:. Содержит вычисленные метаданные Recipe, определяемые для каждого компонента.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
recipe_name | string | нет | Имя вычисленной сущности Recipe из поиска на уровне компонента. |
Дополнительные свойства не допускаются.