Схема графа Aggrega, агностичного по отношению к возможностям (IR)
Сгенерированный справочник. Не редактируйте вручную — сгенерируйте заново из опубликованной JSON Schema.
Идентификатор схемы: https://aggrega.ai/schemas/ir-v1beta1.schema.json
Развёрнутый, полностью разрешённый одномерный граф, который выдаёт Topology Builder.
Тип верхнего уровня: object
Свойства
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | да | Константа: "aggrega.ai/v1beta1" |
kind | const “IR” | да | Константа: "IR" |
metadata | IRMetadata | да | Идентичность графа: Aggregate, из которого он построен. |
spec | IRSpec | да | Сам граф: его узлы, рёбра и полезные нагрузки, индексированные по узлам. |
Дополнительные свойства не допускаются.
Определения
Maintainer
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
name | string | да | Имя сопровождающего. |
email | string | нет | Адрес электронной почты сопровождающего. |
url | string | нет | Веб-адрес сопровождающего. |
FieldProvenance
Происхождение одного листа в полезной нагрузке values или infra вложения.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
origin | string | да | Был ли лист написан автором явно или внесён проходом расширения, управляемым аннотациями. |
side | string | нет | Поверхность авторинга, на которой была объявлена аннотация; отсутствует для явных листьев. |
annotation_key | string | нет | Имя аннотации, внёсшей этот лист; отсутствует для явных листьев. |
annotation_source | string | нет | Место объявления аннотации в исходниках в виде |
overridden_annotation | FieldProvenance | нет | Вклад аннотации, уступивший этот лист явному: когда явный лист перезаписал лист, внесённый аннотацией, — подавленное происхождение, которое он заменил. В единственном числе: сохраняется всегда ровно один подавленный вклад. |
Дополнительные свойства не допускаются.
AttachmentConnection
Соединение, к которому относится вложение, — для вложения, написанного на соединении, которое проводит компонент, а не в собственном блоке вложений компонента: сокет, через который проведено соединение, и псевдоним, под которым оно записано. Эта пара называет одно из рёбер графа — ребро, источником которого является узел, несущий вложение, а сокет и псевдоним совпадают с этими, — поэтому потребитель связывает вложение с этим ребром, а через него — с целью, которой вложение предъявляется.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
socket | string | да | Сокет, через который проведено соединение: сокет ребра, к которому относится вложение. |
alias | string | да | Псевдоним, под которым записано соединение: псевдоним ребра, к которому относится вложение. |
Дополнительные свойства не допускаются.
IRFeatureEntry
Одно разрешённое вложение узла, передаваемое в feature_values_mapping. Все семейства вложений имеют эту форму — операционная Feature, Feature учётных данных, Feature идентичности, — поэтому ни одно семейство не получает проекцию с большими потерями, чем другое. Что несёт values вложения учётных данных, решает автор: учётные данные по ссылке несут указатель в хранилище секретов, учётные данные по значению несут сам материал, а компилятор передаёт дословно то, что написано, не разрешая ни то, ни другое.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
type | string | да | URI каталожной сущности Feature, которую запрашивает это вложение. |
resolved_version | string | да | Точная семантическая версия, разрешённая при компиляции. |
labels | map of string | нет | Каталожные метки присоединённой сущности Feature, передаваемые дословно в том порядке, в котором их объявляет её каталожная сущность, — никогда не фильтруемые, не нормализуемые и без удаления префиксов, поэтому потребитель читает ровно то, что написал автор каталога. Компилятор не читает ни одну из них. Отсутствует, если Feature не объявляет меток, а также если её тип не разрешается ни в одну каталожную сущность. |
catalog_annotations | map of string | нет | Каталожные аннотации присоединённой сущности Feature — metadata.annotations сущности Feature, которую называет это вложение, — передаваемые дословно в том порядке, в котором их объявляет эта сущность, никогда не фильтруемые, не нормализуемые и без удаления префиксов, поэтому потребитель читает ровно то, что написал автор каталога, включая ключи в собственном пространстве имён автора. Компилятор не читает ни одну из них. Отличается от annotation_key и annotation_source, которые называют и указывают местоположение аннотации, из-за которой это вложение вообще возникло: те два сообщают, как появилось вложение, это поле сообщает метаданные сущности, которую оно называет, а вложение, написанное в блоке features:, несёт эти аннотации, не неся ни одного из тех двух. Отсутствует, если Feature не объявляет аннотаций, а также если её тип не разрешается ни в одну каталожную сущность. |
binding | string | нет | Называет слот вложения, который заполняет это вложение, или “free”, если оно не заполняет ни одного объявленного слота. Слот объявляется в одном из двух мест, и какое из них — определяет то, где написано вложение: вложение собственного блока вложений узла заполняет слот, который хостовая сущность Component объявляет в своей featuresSchema, а вложение, написанное на соединении, заполняет слот, который сокет соединения объявляет в featuresSchema этого сокета в хостовой сущности Component. В обоих случаях сопоставление идёт по имени — вложение заполняет слот, когда Feature присоединена под именем слота, в блоке компонента или на соединении, — поэтому значение является точным ключом из набора объявленных слотов и никогда не извлекается из ключа вложения. Набор слотов сокета закрыт, поскольку вложение, написанное на соединении под именем, которого его сокет не объявляет, останавливает сборку, поэтому вложение, несущее соединение, никогда не сообщает free. Передаётся имя слота, а не простое логическое значение, потому что то, какой слот заполнен, — более полезная половина ответа. Пусто, если набор объявленных слотов хостовой сущности Component не удалось разрешить, что отличается от “free”: free — это положительный вывод о том, что ни один объявленный слот не носит это имя. |
values | object | нет | Полезная нагрузка операционной конфигурации вложения. Для учётных данных — та форма, которую объявил автор: указатель в хранилище секретов или сам материал. |
infra | object | нет | Физические размеры этого вложения для каждого экземпляра. |
inject | object | нет | Агностичная маршрутизация внедрения. Сопоставляет локальные переменные ключам provides цели. |
origin | string (enum) | нет | Отличает вложения, написанные в блоке features: (explicit), от синтетических вложений, созданных проходом расширения, управляемым аннотациями (annotation), или mixed, если листья value/infra вложения содержат смесь обоих (тогда сведения по каждому листу находятся в картах происхождения). Допустимые значения: "explicit", "annotation", "mixed" |
annotation_key | string | нет | Имя аннотации, вызвавшей синтетическое вложение. Отсутствует, если origin равно explicit. |
annotation_source | string | нет | Место объявления аннотации в исходниках в виде |
values_provenance | map of FieldProvenance | нет | Происхождение каждого листа полезной нагрузки values с ключом — путём листа через точку. |
infra_provenance | map of FieldProvenance | нет | Происхождение каждого листа полезной нагрузки infra с ключом — путём листа через точку. |
sensitive | логическая | нет | True, если это вложение обрабатывает материал, который автор объявил чувствительным: либо присоединённая Feature объявляет чувствительный лист в своей опоре values, infra или provides, либо слот, который заполняет вложение, объявляет переносимый им материал чувствительным — одноимённый слот вложения хостовой сущности Component или, для вложения, написанного на соединении, одноимённый слот, объявленный сокетом соединения. Выводится из этих объявлений по объединённому вложению, никогда не из содержимого значения или имени. Не задано, если нет ни одного из этих объявлений. |
sensitive_inject | map из map из string | нет | Ключи доставки из inject, чей указанный ключ provides присоединённая Feature объявляет чувствительным, в собственной форме inject: механизм, затем ключ доставки, а значением — указанный ключ provides. Подмножество inject. Отсутствует, если вложение не объявляет механизма доставки или не ссылается ни на один чувствительный ключ provides. |
sensitive_payload_leaves | string[] | нет | Листья полезной нагрузки values и infra этого вложения, которые прикреплённая Feature объявляет чувствительными, каждый в виде пути через точку с префиксом столпа, который занимает элемент данных: values.db покрывает db.password и не достигает соседнего листа с именем dbPassword. Ответ уровня вложения никогда не распространяется на отдельные листья: это утверждало бы ложное о листе, оставленном читаемым. Отсутствующий ключ означает, что это вложение не называет ни одного листа, который его Feature объявляет чувствительным. Он не утверждает, что полезная нагрузка нечувствительна, и не отличает вложение, у которого нет такого листа, от производителя, который вообще не сообщает эту ось; гость, читающий отсутствующий ключ как разрешение показать или вывести значение в открытом виде, прочитал его наоборот. Листья идут в том порядке, в каком их хранит полезная нагрузка, листья столпа values перед листьями столпа infra — в том же порядке, что несут сами полезные нагрузки values и infra, и именно это делает полезную нагрузку побайтно идентичной между запусками на одинаковых входных данных. Отсутствует, когда вложение не несёт ни одного листа, который его Feature объявляет чувствительным. |
connection | AttachmentConnection | нет | Соединение, которому принадлежит это вложение: присутствует у каждого вложения, написанного на одном из соединений узла, и отсутствует у каждого вложения собственного блока вложений узла. Вложение, написанное на соединении, во всех остальных отношениях является одним из вложений узла: оно индексируется своим квалифицированным именем — псевдонимом соединения и слотом, соединёнными точкой, — и берёт привязку и чувствительность из слота, который объявляет сокет соединения. Поэтому именно это поле отличает одно от другого, и оно несёт соединение как данные, а не оставляет его извлекать из ключа. Потребитель соединяет его с рёбрами графа по сокету и псевдониму: ребро, источник которого — узел, несущий это вложение, а сокет и псевдоним — эти, и есть соединение, на котором представлено вложение, а цель этого ребра — то, чему оно представлено. Вложение соединения, которое проводит вложение Feature, никогда его не несёт, потому что такое соединение не несёт вложений. |
realization | string | нет | FeatureRecipe, реализующий это вложение, в виде |
Дополнительные свойства не допускаются.
IRFeatureEntry.inject
Агностичная маршрутизация внедрения. Сопоставляет локальные переменные ключам provides цели.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
env | map of string | нет | Доставка через переменные окружения: ключи — имена локальных переменных потребителя, значения — ключи provides цели. |
file | map of string | нет | Доставка через монтирование файлов: ключи — локальные пути к файлам потребителя, значения — ключи provides цели. |
arg | map of string | нет | Доставка через аргументы командной строки: ключи — префиксы флагов потребителя, значения — ключи provides цели. |
IRBoundaryFeature
Вложение Feature уровня границы, спроецированное в IR: URI типа Feature плюс infra границы, по которой FeatureRecipe области границы отрисовывает и разрешает свой источник. Вложения уровня границы не несут полезной нагрузки values.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
type | string | да | URI каталожной Feature, прикреплённой к этой границе. |
infra | object | нет | Физические размеры для вложения границы; infra, по которой FeatureRecipe области границы вычисляет свои шаблоны и источник. |
sensitive_payload_leaves | string[] | нет | Листья полезной нагрузки infra этого вложения границы, которые прикреплённая Feature объявляет чувствительными, каждый в виде пути через точку с префиксом столпа, который занимает элемент данных. Здесь появляются только координаты infra.db покрывает db.password и не достигает соседнего листа с именем dbPassword. Отсутствующий ключ означает, что это вложение не называет ни одного листа, который его Feature объявляет чувствительным, включая случай, когда прикреплённая Feature не разрешается ни в одну схему, которую мог бы прочитать этот читатель. Он не утверждает, что полезная нагрузка infra нечувствительна, и не отличает вложение, у которого нет такого листа, от производителя, который вообще не сообщает эту ось. Потребитель, читающий отсутствующий ключ как разрешение показать или вывести значение в открытом виде, прочитал его наоборот. Листья идут в том порядке, в каком их хранит полезная нагрузка, — в том же порядке, что несёт сама полезная нагрузка infra, и именно это сохраняет граф побайтно идентичным между запусками на одинаковых входных данных. Отсутствует, когда вложение не несёт ни одного листа, который его Feature объявляет чувствительным. |
realization | string | нет | FeatureRecipe, реализующий это вложение границы, в виде |
Дополнительные свойства не допускаются.
CatalogMetadata
Корпоративный набор метаданных, явно извлечённый из сущности каталога и предоставляющий данные о жизненном цикле и владении линтерам Wasm.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
maintainers | Maintainer[] | нет | Сопровождающие, которых каталожная сущность указывает как своих владельцев. |
license | string | нет | Идентификатор лицензии SPDX, который каталожная сущность объявляет для описываемого ею программного обеспечения. |
repository | string | нет | URL Git-репозитория, который каталожная сущность называет местом хранения своих исходных файлов. |
home | string | нет | URL домашней страницы, вики или документации каталожной сущности. |
keywords | string[] | нет | Описательные ключевые слова, которые объявляет каталожная сущность. |
Дополнительные свойства не допускаются.
IRNode
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
description | string | нет | Необязательная документация, написанная разработчиком и описывающая роль этого экземпляра компонента в приложении. Передаётся из Aggregate для отрисовки и для диагностик линтинга. |
labels | map of string | да | Метки утиной типизации и онтологии сущности. |
component | string | да | Имя базовой сущности Component. |
resolved_version | string | да | Точная семантическая версия сущности Component, разрешённая при компиляции. |
sync_wave | integer | нет | Волна развёртывания, унаследованная от поля syncWave содержащей границы (по умолчанию 0; отрицательные значения допускаются). В K8s и Helm волна определяет порядок развёртывания: она становится аннотацией argocd.argoproj.io/sync-wave, а на ресурсе, который чарт уже помечает как хук Helm, она также становится helm.sh/hook-weight этого хука. В compose значение записывается как метка сервиса и упорядочивает сервисы файла, в который оно рендерится, через depends_on между ними. В cloudformation оно упорядочивает выделение ресурсов стека, в который собирается группа диспетчеризации: каждый ресурс волны объявляется зависимым от ресурсов предыдущей волны. Это порядок их создания и, в обратном направлении, порядок удаления, но никогда не готовность, поскольку шаблон стека не выражает понятия готовности ресурса. В terraform оно упорядочивает блоки модулей корневой конфигурации, в которую собирается граница: каждый модуль волны объявляется зависимым от модулей предыдущей волны. Это порядок, в котором движок выполняет свои действия, но никогда не готовность, поскольку конфигурация не выражает понятия готовности ресурса. Значение также передаётся вместе с происхождением сборки узла. |
boundary_path | string | нет | Путь границы Release, в которую помещён этот узел: имена границ от самой внешней внутрь, соединённые через / (например, ‘data/inner’ для компонента, помещённого в границу inner, объявленную внутри границы data). Имя границы не может содержать /, поэтому путь однозначно разбивается обратно на границы. Узел импортированной сущности Aggregate, которую Release направляет в границу, несёт путь этой границы. Позволяет плагинам рендеринга генерировать уникальные идентификаторы с учётом границ. |
subsystem_path | string | нет | Путь подсистемы Aggregate, в которой объявлен компонент этого узла: имена подсистем от самой внешней внутрь, соединённые через . (например, ‘backend.storage’ для компонента, объявленного в подсистеме storage, вложенной в подсистему backend). Имя подсистемы не может содержать ., поэтому путь однозначно разбивается обратно на подсистемы. Компонент сущности Aggregate, объявляющей components верхнего уровня, несёт синтезированную подсистему default, помеченную synthesized_subsystem. Путь задаётся относительно сущности Aggregate, объявляющей компонент: узел, вносимый импортированной сущностью Aggregate, несёт свой путь внутри этой сущности Aggregate без имени, под которым она импортирована (например, ‘tier’ для компонента в подсистеме tier импортированной сущности Aggregate), поэтому узлы из разных сущностей Aggregates могут иметь один путь. Различить их позволяют ID узла, начинающийся с имени импорта, и source_file. |
synthesized_subsystem | логическая | нет | True, если подсистема этого узла синтезирована компилятором — это подсистема default, создаваемая для сущности Aggregate, которая объявляет components верхнего уровня вместо именованных subsystems. Производное происхождение, никогда не задаётся автором: отличает синтезированную default от подсистемы, которую пользователь явно назвал default. Не зависит от synthesized_boundary (узел может быть синтезирован по любой из осей или по обеим). Отсутствует (false) для каждой подсистемы, заданной автором. |
synthesized_boundary | логическая | нет | True, если граница этого узла синтезирована компилятором — это граница default, создаваемая для сущности Release, которая объявляет components верхнего уровня вместо именованных boundaries. Производное происхождение, никогда не задаётся автором: отличает синтезированную default от границы, которую пользователь явно назвал default, и направляет артефакты узла плоско в dist/ вместо dist/boundaries/default/. Отсутствует (false) для каждой границы, заданной автором. |
catalog_metadata | CatalogMetadata | нет | Корпоративный набор метаданных, явно извлечённый из сущности каталога и предоставляющий данные о жизненном цикле и владении линтерам Wasm. |
catalog_annotations | map of string | нет | Неизменяемые внутренние характеристики компонента, задаваемые архитектором платформы в домене 2. |
release_annotations | map of string | нет | Строки физической топологии и эксплуатационные реалии, каскадно наследуемые от границ в Release. |
aggregate_annotations | map of string | нет | Когнитивные метаданные, намерения разработчика и FinOps, каскадно наследуемые от подсистем в Aggregate. |
self_inject | object | нет | Блок self-inject уровня Component, перенесённый из Aggregate; агностичная маршрутизация внедрения, которую узел объявляет для самого себя. Непрозрачен на этом уровне схемы; плагин политик, который его читает, сам разбирает байты. |
source_file | string | нет | Путь к файлу Aggregate, в котором был задан этот узел, относительно рабочего пространства. Узлы корневого уровня несут путь корневой сущности Aggregate; узлы подагрегатов несут путь к файлу импортированной сущности Aggregate. Путь задаётся относительно корня рабочего пространства (каталога, содержащего .aggrega-config.yaml), поэтому граф побайтово идентичен на машинах, чьи рабочие пространства находятся по разным абсолютным путям. Потребители, фильтрующие диагностику по файлам, перед сравнением разрешают поле относительно того же корня рабочего пространства. Отсутствует, если граф был собран без корня рабочего пространства. |
uses | object | нет | Блок uses узла в точности в том виде, в каком он задан: каждое имя сокета сопоставляется либо со списком имён целевых экземпляров, либо с картой записей соединений с ключами-псевдонимами, в порядке их объявления автором. Это блок в записанном виде — факт, отличный от разрешённых соединений в edges: сокет, заполненный автором, появляется здесь, даже если он не породил соединения, поэтому читатель может отличить сокет, заполненный автором, от сокета, который достигает цели. Отсутствует, если узел не задаёт блок uses. Непрозрачен на этом уровне схемы; плагин политики, который его читает, сам разбирает байты. |
sensitive_payload_leaves | string[] | нет | Листья полезной нагрузки values и infra этого узла, которые его сущность Component объявляет чувствительными, каждый в виде пути через точку с префиксом столпа, который занимает значение: values.db покрывает db.password и не достигает соседнего листа с именем dbPassword. Отсутствие ключа означает, что этот узел не называет ни одного листа, который его сущность Component объявляет чувствительным, включая случай, когда сущность Component узла не разрешается ни в одну схему, которую мог бы прочитать этот читатель. Это не утверждает, что полезная нагрузка узла нечувствительна, и не отличает узел, у которого нет такого листа, от производителя, который вообще не сообщает эту ось. Потребитель, читающий отсутствие ключа как разрешение показать или вывести значение в открытом виде, понял его наоборот. Листья идут в том порядке, в каком их содержит полезная нагрузка, листья столпа values перед листьями столпа infra; это тот же порядок, в котором их несут сами эти полезные нагрузки, и именно он сохраняет граф побайтово идентичным между запусками на одинаковых входных данных. Отсутствует, если узел не несёт ни одного листа, который его сущность Component объявляет чувствительным. |
Дополнительные свойства не допускаются.
IREdge
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
source | string | да | ID потребляющего узла, в котором начинается соединение. |
target | string | да | ID узла, которого достигает соединение. |
socket | string | нет | Категория usesSchema, к которой относится это ребро (например, ‘databases’, ‘tools’). |
alias | string | нет | Заданный разработчиком псевдоним этого соединения (например, ‘primary_db’). |
socket_declaration | string (enum) | да | Происхождение сокета: declared, когда сущность каталога, которой принадлежит сокет, перечисляет его в usesSchema (потребляющая сущность Component или, для ребра, созданного сущностью Feature, исходная Feature); ad-hoc, когда автор сущности Aggregate назвал сокет, не объявленный в каталоге. Это третья ось, не зависящая от авторства ребра: она говорит, откуда взялся сокет, а не кто провёл ребро, поэтому ребро, созданное в Release и ведущее в объявленный сокет, и ребро, созданное в Aggregate и ведущее в сокет ad-hoc, различаются по двум осям независимо. Объявленный сокет несёт свою запись usesSchema, включая селектор, ограничивающий цели, которых может достичь ребро; у сокета ad-hoc нет записи в каталоге и, следовательно, нет селектора, поэтому то, что может переносить ребро, ограничено только объявленными provides цели. Присутствует всегда, поэтому потребителю никогда не приходится считать отсутствующее значение значением declared, а политика может требовать, чтобы каждое ребро было declared. Отличается от маркера привязки вложения, который отвечает на вопрос той же формы о другом предмете. Допустимые значения: "declared", "ad-hoc" |
origin_feature | string | нет | Если это ребро было самостоятельно объявлено сущностью Feature (включая Features учётных данных с меткой feature.aggrega.ai/kind: secret), здесь указывается URI типа Feature. Позволяет Wasm-плагинам изолировать собственную топологию. |
origin_feature_instance | string | нет | Имя экземпляра для конкретного вложения той Feature, которая объявила это ребро. Находит разрешённые provides сущности FeatureRecipe уровня границы по экземпляру, различая два вложения одного типа Feature на одной границе. |
origin_release | логическая | нет | True, если это ребро создано сущностью Release, подключившей объявленный, но не привязанный сокет к существующему компоненту. Отмечает АВТОРСТВО ребра, а не конфигурацию: ребро, объявленное разработчиком, для которого Release лишь предоставил infra, остаётся ребром происхождения Aggregate (origin_release не задан; его infra из Release появляется в карте infra ребра). origin_feature задан => происхождение Feature; origin_release равен true => происхождение Release; ни то, ни другое => происхождение Aggregate. |
values | object | нет | Разрешённые значения разработчика для этого соединения (из ребра Aggregate), проверенные при разрешении по valueSchema, объявленной исходным сокетом (сокетом на потребляющем компоненте, который является источником ребра), и спроецированные в контекст рендеринга потребляющего узла по пути .context.uses. |
infra | object | нет | Разрешённые infra для этого соединения, предоставленные записью ребра в Release, проверенные при разрешении по infraSchema, объявленной исходным сокетом (сокетом на потребляющем компоненте, который является источником ребра), и спроецированные по пути .context.uses. |
inject | object | нет | Агностичная маршрутизация внедрения. Сопоставляет локальные переменные ключам provides цели. |
sensitive_payload_leaves | string[] | нет | Листья в values и infra этого ребра, которые сокет, относительно которого они записаны, объявляет чувствительными, каждый в виде пути через точку с префиксом столпа, который занимает элемент данных: values.db покрывает db.password и не достигает соседнего листа с именем db_password. Поверхность, которая скрывает в графе значения, объявленные чувствительными, скрывает эти листья в values и infra этого ребра, а также в записи uses потребляющего узла для того же соединения, которая несёт значения в том виде, в каком их написал автор. Отсутствующий ключ означает, что это ребро не называет ни одного листа, который контракт его сокета объявляет чувствительным, включая случай, когда сокет не объявляет контракта, который можно было бы здесь прочитать. Он не утверждает, что конфигурация нечувствительна, и потребитель, читающий отсутствующий ключ как разрешение показать или вывести значение в открытом виде, прочитал его наоборот. Листья идут в том порядке, в каком их хранят полезные нагрузки, листья столпа values перед листьями столпа infra, и именно это сохраняет граф побайтно идентичным между запусками на одинаковых входных данных. Отсутствует, когда ребро не несёт ни одного листа, который контракт его сокета объявляет чувствительным. |
Дополнительные свойства не допускаются.
IREdge.inject
Агностичная маршрутизация внедрения. Сопоставляет локальные переменные ключам provides цели.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
env | map of string | нет | Доставка через переменные окружения: ключи — имена локальных переменных потребителя, значения — ключи provides цели. |
file | map of string | нет | Доставка через монтирование файлов: ключи — локальные пути к файлам потребителя, значения — ключи provides цели. |
arg | map of string | нет | Доставка через аргументы командной строки: ключи — префиксы флагов потребителя, значения — ключи provides цели. |
IRMetadata
Идентичность графа: Aggregate, из которого он построен.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
aggregate_name | string | да | metadata.name сущности Aggregate. |
Дополнительные свойства не допускаются.
IRProvenance
Метаданные трассируемости для диагностики и аудита.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
schema_version | string | да | Версия схемы IR, которой соответствует граф, — aggrega.ai/v1beta1, то же значение, что несёт apiVersion графа. |
compiler_version | string | да | Обязательная отметка соответствия. Определяет по версии бинарный файл aggrega, который собрал этот граф. |
aggregate_version | string | да | Точная семантическая версия корневого намерения Aggregate, использованного при компиляции. |
manifest_version | string | да | Точная семантическая версия lock-файла Manifest, использованного при компиляции. |
release_version | string | да | Точная семантическая версия файла маршрутизации Release, использованного при компиляции. |
Дополнительные свойства допускаются.
IRSpec
Сам граф: его узлы, рёбра и полезные нагрузки, индексированные по узлам.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
nodes | map of IRNode | да | Словарь всех узлов графа с ключами по их абсолютному ID. Чисто топологический. Ключи: одна или несколько букв, цифр, знаков подчёркивания, точек или дефисов. Шаблон: ^[a-zA-Z0-9_.-]+$. |
edges | IREdge[] | да | Явные логические сетевые пути и зависимости между узлами. |
values_mapping | object | да | Единый источник истины для непрозрачных сквозных когнитивных полезных нагрузок, сопоставленных по ID узла. |
infra_mapping | object | да | Полезная нагрузка физического масштабирования, внедрённая из Release, сопоставленная по ID узла. |
feature_values_mapping | map of map of IRFeatureEntry | да | Нормализованная карта ID узлов на конфигурации прикреплённых к ним Features. Одна корзина содержит все вложения узла, что бы они ни создавали, — операционные Features, Features учётных данных, Features идентификации — с ключами по имени экземпляра, которое автор дал каждому вложению. Вложение, записанное на одном из соединений узла, имеет ключом своё квалифицированное имя — псевдоним соединения и слот, соединённые точкой, — и указывает своё соединение в собственном поле connection. Ключи: одна или несколько букв, цифр, знаков подчёркивания, точек или дефисов. Шаблон: ^[a-zA-Z0-9_.-]+$. |
boundary_features | map of map of IRBoundaryFeature | нет | Вложения Feature каждой границы с ключами сначала по пути границы, затем по имени экземпляра. Присутствует, только если в графе есть вложения Feature уровня границы. Ключи: одна или несколько букв, цифр, знаков подчёркивания, точек, косых черт или дефисов. Шаблон: ^[a-zA-Z0-9_./-]+$. |
provenance | IRProvenance | да | Метаданные трассируемости для диагностики и аудита. |
Дополнительные свойства не допускаются.
IRGraph
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | да | Константа: "aggrega.ai/v1beta1" |
kind | const “IR” | да | Константа: "IR" |
metadata | IRMetadata | да | Идентичность графа: Aggregate, из которого он построен. |
spec | IRSpec | да | Сам граф: его узлы, рёбра и полезные нагрузки, индексированные по узлам. |
Дополнительные свойства не допускаются.