Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Схема контекста шаблонов путей 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

Свойства

СвойствоТипОбязательноОписание
capabilitystringнетДоступно в directory: И subDirectory:. Возможность рендеринга, которую Recipe вносящего компонента объявляет в spec.capability, без закрепления версии — например, ‘helm’, ‘helm-chart’ или ‘compose’. По умолчанию subDirectory: равно {{ .capability }}, благодаря чему артефакты каждой возможности попадают в собственную подпапку внутри directory границы. В шаблоне directory: значение вычисляется для каждого компонента, поэтому граница, поддерево которой вносит более одной возможности, даёт по одному каталогу на возможность; отдельный обход по границам, публикующий .parent_boundary.directory, выполняется до привязки каких-либо компонентов и оставляет это значение пустым.
boundary_namestringнетДоступно в directory: И subDirectory:. Ключ карты в release.spec.boundaries..
parametersobjectнетДоступно в directory: И subDirectory:. Типизированная карта параметров из Release. Шаблоны путей получают доступ к .parameters как намеренное исключение из однопроходного жизненного цикла параметров — шаблоны значений НЕ получают .parameters; значения, зависящие от окружения, попадают в шаблоны значений через уже интерполированный YAML сущности Aggregate.
component_idstringнетДоступно ТОЛЬКО в subDirectory:. Идентичность размещаемого участника. Для компонента — его уплощённый идентификатор экземпляра на уровне компонента (например, ‘backend’ или ‘data-layer.main-db’). Для сущности Feature, присоединённой на границе, сущность FeatureRecipe которой выполняется один раз для границы (executionScope: boundary), — составная идентичность компонента, которую каждый ресурс, выпускаемый этим присоединением, несёт в своей метке aggrega.ai/component-id (например, ‘bfr—app—shared’ для присоединения ‘shared’ на границе ‘app’), сокращённая там, где плагин рендеринга присоединения ограничивает имена, чтобы называемый ею каталог совпадал с этой меткой. Не имеет смысла на уровне границы и отклоняется проверкой при разборе в шаблонах directory:.
parent_boundaryobjectнетДоступно в directory: И subDirectory:. Уже вычисленные значения родительской границы. Заполняются обходом в глубину, при котором шаблоны каждой границы вычисляются с вычисленными значениями её родителя; дочерние границы никогда не видят здесь собственных значений. У границы верхнего уровня нет родителя, поэтому чтение ключа под parent_boundary в ней останавливает сборку с указанием границы, поля шаблона и отсутствующего ключа.
manifestobjectнетДоступно в directory: И subDirectory:. Содержит вычисленные метаданные Recipe, определяемые для каждого компонента.

Дополнительные свойства не допускаются.

path-template-context.parent_boundary

Доступно в directory: И subDirectory:. Уже вычисленные значения родительской границы. Заполняются обходом в глубину, при котором шаблоны каждой границы вычисляются с вычисленными значениями её родителя; дочерние границы никогда не видят здесь собственных значений. У границы верхнего уровня нет родителя, поэтому чтение ключа под parent_boundary в ней останавливает сборку с указанием границы, поля шаблона и отсутствующего ключа.

СвойствоТипОбязательноОписание
directorystringнетВычисленная строка directory родителя.
boundary_namestringнетИмя родителя (ключ карты в release.spec.boundaries).
parametersobjectнетКарта параметров Release — та же карта, что несёт .parameters.
annotationsmap of stringнетАннотации родительской границы после разрешения каскада.

Дополнительные свойства не допускаются.

path-template-context.manifest

Доступно в directory: И subDirectory:. Содержит вычисленные метаданные Recipe, определяемые для каждого компонента.

СвойствоТипОбязательноОписание
recipe_namestringнетИмя вычисленной сущности Recipe из поиска на уровне компонента.

Дополнительные свойства не допускаются.