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

Схема графа Aggrega, агностичного по отношению к возможностям (IR)

Сгенерированный справочник. Не редактируйте вручную — сгенерируйте заново из опубликованной JSON Schema.

Идентификатор схемы: https://aggrega.ai/schemas/ir-v1beta1.schema.json

Развёрнутый, полностью разрешённый одномерный граф, который выдаёт Topology Builder.

Тип верхнего уровня: object

Свойства

СвойствоТипОбязательноОписание
apiVersionconst “aggrega.ai/v1beta1”даКонстанта: "aggrega.ai/v1beta1"
kindconst “IR”даКонстанта: "IR"
metadataIRMetadataдаИдентичность графа: Aggregate, из которого он построен.
specIRSpecдаСам граф: его узлы, рёбра и полезные нагрузки, индексированные по узлам.

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

Определения

Maintainer

СвойствоТипОбязательноОписание
namestringдаИмя сопровождающего.
emailstringнетАдрес электронной почты сопровождающего.
urlstringнетВеб-адрес сопровождающего.

FieldProvenance

Происхождение одного листа в полезной нагрузке values или infra вложения.

СвойствоТипОбязательноОписание
originstringдаБыл ли лист написан автором явно или внесён проходом расширения, управляемым аннотациями.
sidestringнетПоверхность авторинга, на которой была объявлена аннотация; отсутствует для явных листьев.
annotation_keystringнетИмя аннотации, внёсшей этот лист; отсутствует для явных листьев.
annotation_sourcestringнетМесто объявления аннотации в исходниках в виде :; отсутствует для явных листьев.
overridden_annotationFieldProvenanceнетВклад аннотации, уступивший этот лист явному: когда явный лист перезаписал лист, внесённый аннотацией, — подавленное происхождение, которое он заменил. В единственном числе: сохраняется всегда ровно один подавленный вклад.

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

AttachmentConnection

Соединение, к которому относится вложение, — для вложения, написанного на соединении, которое проводит компонент, а не в собственном блоке вложений компонента: сокет, через который проведено соединение, и псевдоним, под которым оно записано. Эта пара называет одно из рёбер графа — ребро, источником которого является узел, несущий вложение, а сокет и псевдоним совпадают с этими, — поэтому потребитель связывает вложение с этим ребром, а через него — с целью, которой вложение предъявляется.

СвойствоТипОбязательноОписание
socketstringдаСокет, через который проведено соединение: сокет ребра, к которому относится вложение.
aliasstringдаПсевдоним, под которым записано соединение: псевдоним ребра, к которому относится вложение.

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

IRFeatureEntry

Одно разрешённое вложение узла, передаваемое в feature_values_mapping. Все семейства вложений имеют эту форму — операционная Feature, Feature учётных данных, Feature идентичности, — поэтому ни одно семейство не получает проекцию с большими потерями, чем другое. Что несёт values вложения учётных данных, решает автор: учётные данные по ссылке несут указатель в хранилище секретов, учётные данные по значению несут сам материал, а компилятор передаёт дословно то, что написано, не разрешая ни то, ни другое.

СвойствоТипОбязательноОписание
typestringдаURI каталожной сущности Feature, которую запрашивает это вложение.
resolved_versionstringдаТочная семантическая версия, разрешённая при компиляции.
labelsmap of stringнетКаталожные метки присоединённой сущности Feature, передаваемые дословно в том порядке, в котором их объявляет её каталожная сущность, — никогда не фильтруемые, не нормализуемые и без удаления префиксов, поэтому потребитель читает ровно то, что написал автор каталога. Компилятор не читает ни одну из них. Отсутствует, если Feature не объявляет меток, а также если её тип не разрешается ни в одну каталожную сущность.
catalog_annotationsmap of stringнетКаталожные аннотации присоединённой сущности Feature — metadata.annotations сущности Feature, которую называет это вложение, — передаваемые дословно в том порядке, в котором их объявляет эта сущность, никогда не фильтруемые, не нормализуемые и без удаления префиксов, поэтому потребитель читает ровно то, что написал автор каталога, включая ключи в собственном пространстве имён автора. Компилятор не читает ни одну из них. Отличается от annotation_key и annotation_source, которые называют и указывают местоположение аннотации, из-за которой это вложение вообще возникло: те два сообщают, как появилось вложение, это поле сообщает метаданные сущности, которую оно называет, а вложение, написанное в блоке features:, несёт эти аннотации, не неся ни одного из тех двух. Отсутствует, если Feature не объявляет аннотаций, а также если её тип не разрешается ни в одну каталожную сущность.
bindingstringнетНазывает слот вложения, который заполняет это вложение, или “free”, если оно не заполняет ни одного объявленного слота. Слот объявляется в одном из двух мест, и какое из них — определяет то, где написано вложение: вложение собственного блока вложений узла заполняет слот, который хостовая сущность Component объявляет в своей featuresSchema, а вложение, написанное на соединении, заполняет слот, который сокет соединения объявляет в featuresSchema этого сокета в хостовой сущности Component. В обоих случаях сопоставление идёт по имени — вложение заполняет слот, когда Feature присоединена под именем слота, в блоке компонента или на соединении, — поэтому значение является точным ключом из набора объявленных слотов и никогда не извлекается из ключа вложения. Набор слотов сокета закрыт, поскольку вложение, написанное на соединении под именем, которого его сокет не объявляет, останавливает сборку, поэтому вложение, несущее соединение, никогда не сообщает free. Передаётся имя слота, а не простое логическое значение, потому что то, какой слот заполнен, — более полезная половина ответа. Пусто, если набор объявленных слотов хостовой сущности Component не удалось разрешить, что отличается от “free”: free — это положительный вывод о том, что ни один объявленный слот не носит это имя.
valuesobjectнетПолезная нагрузка операционной конфигурации вложения. Для учётных данных — та форма, которую объявил автор: указатель в хранилище секретов или сам материал.
infraobjectнетФизические размеры этого вложения для каждого экземпляра.
injectobjectнетАгностичная маршрутизация внедрения. Сопоставляет локальные переменные ключам provides цели.
originstring (enum)нетОтличает вложения, написанные в блоке features: (explicit), от синтетических вложений, созданных проходом расширения, управляемым аннотациями (annotation), или mixed, если листья value/infra вложения содержат смесь обоих (тогда сведения по каждому листу находятся в картах происхождения). Допустимые значения: "explicit", "annotation", "mixed"
annotation_keystringнетИмя аннотации, вызвавшей синтетическое вложение. Отсутствует, если origin равно explicit.
annotation_sourcestringнетМесто объявления аннотации в исходниках в виде :. Отсутствует, если origin равно explicit.
values_provenancemap of FieldProvenanceнетПроисхождение каждого листа полезной нагрузки values с ключом — путём листа через точку.
infra_provenancemap of FieldProvenanceнетПроисхождение каждого листа полезной нагрузки infra с ключом — путём листа через точку.
sensitiveлогическаянетTrue, если это вложение обрабатывает материал, который автор объявил чувствительным: либо присоединённая Feature объявляет чувствительный лист в своей опоре values, infra или provides, либо слот, который заполняет вложение, объявляет переносимый им материал чувствительным — одноимённый слот вложения хостовой сущности Component или, для вложения, написанного на соединении, одноимённый слот, объявленный сокетом соединения. Выводится из этих объявлений по объединённому вложению, никогда не из содержимого значения или имени. Не задано, если нет ни одного из этих объявлений.
sensitive_injectmap из map из stringнетКлючи доставки из inject, чей указанный ключ provides присоединённая Feature объявляет чувствительным, в собственной форме inject: механизм, затем ключ доставки, а значением — указанный ключ provides. Подмножество inject. Отсутствует, если вложение не объявляет механизма доставки или не ссылается ни на один чувствительный ключ provides.
sensitive_payload_leavesstring[]нетЛистья полезной нагрузки values и infra этого вложения, которые прикреплённая Feature объявляет чувствительными, каждый в виде пути через точку с префиксом столпа, который занимает элемент данных: values. или infra.. Здесь читается та полезная нагрузка, которую вложение несёт в итоге, поэтому лист, стоящий на значении, которое схема Feature объявляет значением по умолчанию, называется наравне с листом, написанным автором: заполненное значение по умолчанию — это элемент данных, который несёт полезная нагрузка, и маркировка, прочитанная только из написанного блока, оставила бы его неназванным. Это полистовая единица маркировки чувствительности, и она отвечает на вопрос, на который не отвечает ни одна из двух других: sensitive даёт один ответ на всё вложение, sensitive_inject — по одному на каждый ключ доставки inject, и ни одна не называет отдельный лист. Лист появляется там, где его покрывает путь, который схема Feature объявляет чувствительным: объявление называет этот лист или объект, содержащий его, поэтому лист внутри объекта, покрытого объявлением, называется этим объявлением. Сопоставление идёт по сегментам пути через точку, без чтения чего-либо из самого текста пути и без проверки значений, поэтому объявление в db покрывает db.password и не достигает соседнего листа с именем dbPassword. Ответ уровня вложения никогда не распространяется на отдельные листья: это утверждало бы ложное о листе, оставленном читаемым. Отсутствующий ключ означает, что это вложение не называет ни одного листа, который его Feature объявляет чувствительным. Он не утверждает, что полезная нагрузка нечувствительна, и не отличает вложение, у которого нет такого листа, от производителя, который вообще не сообщает эту ось; гость, читающий отсутствующий ключ как разрешение показать или вывести значение в открытом виде, прочитал его наоборот. Листья идут в том порядке, в каком их хранит полезная нагрузка, листья столпа values перед листьями столпа infra — в том же порядке, что несут сами полезные нагрузки values и infra, и именно это делает полезную нагрузку побайтно идентичной между запусками на одинаковых входных данных. Отсутствует, когда вложение не несёт ни одного листа, который его Feature объявляет чувствительным.
connectionAttachmentConnectionнетСоединение, которому принадлежит это вложение: присутствует у каждого вложения, написанного на одном из соединений узла, и отсутствует у каждого вложения собственного блока вложений узла. Вложение, написанное на соединении, во всех остальных отношениях является одним из вложений узла: оно индексируется своим квалифицированным именем — псевдонимом соединения и слотом, соединёнными точкой, — и берёт привязку и чувствительность из слота, который объявляет сокет соединения. Поэтому именно это поле отличает одно от другого, и оно несёт соединение как данные, а не оставляет его извлекать из ключа. Потребитель соединяет его с рёбрами графа по сокету и псевдониму: ребро, источник которого — узел, несущий это вложение, а сокет и псевдоним — эти, и есть соединение, на котором представлено вложение, а цель этого ребра — то, чему оно представлено. Вложение соединения, которое проводит вложение Feature, никогда его не несёт, потому что такое соединение не несёт вложений.
realizationstringнетFeatureRecipe, реализующий это вложение, в виде :: тот, который Manifest привязывает к нему — по собственному имени вложения, если уровень имён Manifest сопоставляет это имя, иначе по его типу Feature, — то есть тот, которым сборка тех же документов его отрисовывает. Для вложения, написанного на соединении, имя, по которому читается уровень имён, — это его квалифицированное имя: псевдоним соединения и слот, соединённые точкой. Значение — это пара, которую aggrega inspect выводит как реализацию вложения, и, где цель проставляет происхождение на то, что отрисовывает, значение aggrega.ai/recipe-uri на документах, которые отрисовывает этот FeatureRecipe, поэтому потребитель связывает вложение с тем, что оно отрисовывает, без перевода между формами. Поле называет FeatureRecipe по имени и версии, а не по возможности. Поле фиксирует, какой FeatureRecipe привязывает Manifest, и читается из Manifest и каталога при построении графа: ничего не загружается для его получения, а FeatureRecipe отрисовывается только тогда, когда отрисовывает сборка. Отсутствует, когда Manifest не привязывает вложение ни к одному FeatureRecipe, который есть в каталоге.

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

IRFeatureEntry.inject

Агностичная маршрутизация внедрения. Сопоставляет локальные переменные ключам provides цели.

СвойствоТипОбязательноОписание
envmap of stringнетДоставка через переменные окружения: ключи — имена локальных переменных потребителя, значения — ключи provides цели.
filemap of stringнетДоставка через монтирование файлов: ключи — локальные пути к файлам потребителя, значения — ключи provides цели.
argmap of stringнетДоставка через аргументы командной строки: ключи — префиксы флагов потребителя, значения — ключи provides цели.

IRBoundaryFeature

Вложение Feature уровня границы, спроецированное в IR: URI типа Feature плюс infra границы, по которой FeatureRecipe области границы отрисовывает и разрешает свой источник. Вложения уровня границы не несут полезной нагрузки values.

СвойствоТипОбязательноОписание
typestringдаURI каталожной Feature, прикреплённой к этой границе.
infraobjectнетФизические размеры для вложения границы; infra, по которой FeatureRecipe области границы вычисляет свои шаблоны и источник.
sensitive_payload_leavesstring[]нетЛистья полезной нагрузки infra этого вложения границы, которые прикреплённая Feature объявляет чувствительными, каждый в виде пути через точку с префиксом столпа, который занимает элемент данных. Здесь появляются только координаты infra., потому что вложение уровня границы не несёт полезной нагрузки values. Здесь читается та полезная нагрузка, которую вложение несёт в итоге, поэтому лист, стоящий на значении, которое схема Feature объявляет значением по умолчанию, называется наравне с листом, написанным границей: заполненное значение по умолчанию — это элемент данных, который несёт полезная нагрузка, и маркировка, прочитанная только из написанного блока, оставила бы его неназванным. Лист появляется там, где его покрывает путь, который схема Feature объявляет чувствительным: объявление называет этот лист или объект, содержащий его, поэтому лист внутри объекта, покрытого объявлением, называется этим объявлением. Сопоставление идёт по сегментам пути через точку, без чтения чего-либо из самого текста пути и без проверки значений, поэтому объявление в db покрывает db.password и не достигает соседнего листа с именем dbPassword. Отсутствующий ключ означает, что это вложение не называет ни одного листа, который его Feature объявляет чувствительным, включая случай, когда прикреплённая Feature не разрешается ни в одну схему, которую мог бы прочитать этот читатель. Он не утверждает, что полезная нагрузка infra нечувствительна, и не отличает вложение, у которого нет такого листа, от производителя, который вообще не сообщает эту ось. Потребитель, читающий отсутствующий ключ как разрешение показать или вывести значение в открытом виде, прочитал его наоборот. Листья идут в том порядке, в каком их хранит полезная нагрузка, — в том же порядке, что несёт сама полезная нагрузка infra, и именно это сохраняет граф побайтно идентичным между запусками на одинаковых входных данных. Отсутствует, когда вложение не несёт ни одного листа, который его Feature объявляет чувствительным.
realizationstringнетFeatureRecipe, реализующий это вложение границы, в виде :: тот, который Manifest привязывает к нему — по собственному имени вложения, если уровень имён Manifest сопоставляет это имя, иначе по его типу Feature, — то есть тот, которым сборка тех же документов его отрисовывает. Это то же поле, читаемое так же, что и реализация записи вложения в feature_values_mapping. Отсутствует, когда Manifest не привязывает вложение ни к одному FeatureRecipe, который есть в каталоге.

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

CatalogMetadata

Корпоративный набор метаданных, явно извлечённый из сущности каталога и предоставляющий данные о жизненном цикле и владении линтерам Wasm.

СвойствоТипОбязательноОписание
maintainersMaintainer[]нетСопровождающие, которых каталожная сущность указывает как своих владельцев.
licensestringнетИдентификатор лицензии SPDX, который каталожная сущность объявляет для описываемого ею программного обеспечения.
repositorystringнетURL Git-репозитория, который каталожная сущность называет местом хранения своих исходных файлов.
homestringнетURL домашней страницы, вики или документации каталожной сущности.
keywordsstring[]нетОписательные ключевые слова, которые объявляет каталожная сущность.

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

IRNode

СвойствоТипОбязательноОписание
descriptionstringнетНеобязательная документация, написанная разработчиком и описывающая роль этого экземпляра компонента в приложении. Передаётся из Aggregate для отрисовки и для диагностик линтинга.
labelsmap of stringдаМетки утиной типизации и онтологии сущности.
componentstringдаИмя базовой сущности Component.
resolved_versionstringдаТочная семантическая версия сущности Component, разрешённая при компиляции.
sync_waveintegerнетВолна развёртывания, унаследованная от поля syncWave содержащей границы (по умолчанию 0; отрицательные значения допускаются). В K8s и Helm волна определяет порядок развёртывания: она становится аннотацией argocd.argoproj.io/sync-wave, а на ресурсе, который чарт уже помечает как хук Helm, она также становится helm.sh/hook-weight этого хука. В compose значение записывается как метка сервиса и упорядочивает сервисы файла, в который оно рендерится, через depends_on между ними. В cloudformation оно упорядочивает выделение ресурсов стека, в который собирается группа диспетчеризации: каждый ресурс волны объявляется зависимым от ресурсов предыдущей волны. Это порядок их создания и, в обратном направлении, порядок удаления, но никогда не готовность, поскольку шаблон стека не выражает понятия готовности ресурса. В terraform оно упорядочивает блоки модулей корневой конфигурации, в которую собирается граница: каждый модуль волны объявляется зависимым от модулей предыдущей волны. Это порядок, в котором движок выполняет свои действия, но никогда не готовность, поскольку конфигурация не выражает понятия готовности ресурса. Значение также передаётся вместе с происхождением сборки узла.
boundary_pathstringнетПуть границы Release, в которую помещён этот узел: имена границ от самой внешней внутрь, соединённые через / (например, ‘data/inner’ для компонента, помещённого в границу inner, объявленную внутри границы data). Имя границы не может содержать /, поэтому путь однозначно разбивается обратно на границы. Узел импортированной сущности Aggregate, которую Release направляет в границу, несёт путь этой границы. Позволяет плагинам рендеринга генерировать уникальные идентификаторы с учётом границ.
subsystem_pathstringнетПуть подсистемы 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_metadataCatalogMetadataнетКорпоративный набор метаданных, явно извлечённый из сущности каталога и предоставляющий данные о жизненном цикле и владении линтерам Wasm.
catalog_annotationsmap of stringнетНеизменяемые внутренние характеристики компонента, задаваемые архитектором платформы в домене 2.
release_annotationsmap of stringнетСтроки физической топологии и эксплуатационные реалии, каскадно наследуемые от границ в Release.
aggregate_annotationsmap of stringнетКогнитивные метаданные, намерения разработчика и FinOps, каскадно наследуемые от подсистем в Aggregate.
self_injectobjectнетБлок self-inject уровня Component, перенесённый из Aggregate; агностичная маршрутизация внедрения, которую узел объявляет для самого себя. Непрозрачен на этом уровне схемы; плагин политик, который его читает, сам разбирает байты.
source_filestringнетПуть к файлу Aggregate, в котором был задан этот узел, относительно рабочего пространства. Узлы корневого уровня несут путь корневой сущности Aggregate; узлы подагрегатов несут путь к файлу импортированной сущности Aggregate. Путь задаётся относительно корня рабочего пространства (каталога, содержащего .aggrega-config.yaml), поэтому граф побайтово идентичен на машинах, чьи рабочие пространства находятся по разным абсолютным путям. Потребители, фильтрующие диагностику по файлам, перед сравнением разрешают поле относительно того же корня рабочего пространства. Отсутствует, если граф был собран без корня рабочего пространства.
usesobjectнетБлок uses узла в точности в том виде, в каком он задан: каждое имя сокета сопоставляется либо со списком имён целевых экземпляров, либо с картой записей соединений с ключами-псевдонимами, в порядке их объявления автором. Это блок в записанном виде — факт, отличный от разрешённых соединений в edges: сокет, заполненный автором, появляется здесь, даже если он не породил соединения, поэтому читатель может отличить сокет, заполненный автором, от сокета, который достигает цели. Отсутствует, если узел не задаёт блок uses. Непрозрачен на этом уровне схемы; плагин политики, который его читает, сам разбирает байты.
sensitive_payload_leavesstring[]нетЛистья полезной нагрузки values и infra этого узла, которые его сущность Component объявляет чувствительными, каждый в виде пути через точку с префиксом столпа, который занимает значение: values. или infra.. Поле называет СОБСТВЕННЫЕ данные узла — то, что values_mapping и infra_mapping несут для этого узла, — и это иной предмет, чем пометка на записи вложения, которая называет данные, несомые вложением согласно объявлению его сущности Feature. Одно невосстановимо из другого: сущность Component узла и сущность Feature вложения объявляют разные схемы, а узел, к которому ничего не прикреплено, всё равно несёт значения. Здесь читается та полезная нагрузка, которую несут эти два сопоставления, поэтому лист, стоящий на значении, которое схема сущности Component объявляет значением по умолчанию, называется наравне с листом, записанным автором: заполненное значение по умолчанию — это данные, которые несёт граф, и пометка, считанная только с записанных блоков, оставила бы его неназванным. Лист появляется, если его покрывает путь, который схема сущности Component объявляет чувствительным: объявление называет этот лист или объект, его содержащий, поэтому лист внутри объекта, покрытого объявлением, называется этим объявлением. Сопоставление выполняется посегментно по пути через точку, без анализа текста самого пути и без просмотра значений, поэтому объявление на db покрывает db.password и не достигает соседнего листа с именем dbPassword. Отсутствие ключа означает, что этот узел не называет ни одного листа, который его сущность Component объявляет чувствительным, включая случай, когда сущность Component узла не разрешается ни в одну схему, которую мог бы прочитать этот читатель. Это не утверждает, что полезная нагрузка узла нечувствительна, и не отличает узел, у которого нет такого листа, от производителя, который вообще не сообщает эту ось. Потребитель, читающий отсутствие ключа как разрешение показать или вывести значение в открытом виде, понял его наоборот. Листья идут в том порядке, в каком их содержит полезная нагрузка, листья столпа values перед листьями столпа infra; это тот же порядок, в котором их несут сами эти полезные нагрузки, и именно он сохраняет граф побайтово идентичным между запусками на одинаковых входных данных. Отсутствует, если узел не несёт ни одного листа, который его сущность Component объявляет чувствительным.

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

IREdge

СвойствоТипОбязательноОписание
sourcestringдаID потребляющего узла, в котором начинается соединение.
targetstringдаID узла, которого достигает соединение.
socketstringнетКатегория usesSchema, к которой относится это ребро (например, ‘databases’, ‘tools’).
aliasstringнетЗаданный разработчиком псевдоним этого соединения (например, ‘primary_db’).
socket_declarationstring (enum)даПроисхождение сокета: declared, когда сущность каталога, которой принадлежит сокет, перечисляет его в usesSchema (потребляющая сущность Component или, для ребра, созданного сущностью Feature, исходная Feature); ad-hoc, когда автор сущности Aggregate назвал сокет, не объявленный в каталоге. Это третья ось, не зависящая от авторства ребра: она говорит, откуда взялся сокет, а не кто провёл ребро, поэтому ребро, созданное в Release и ведущее в объявленный сокет, и ребро, созданное в Aggregate и ведущее в сокет ad-hoc, различаются по двум осям независимо. Объявленный сокет несёт свою запись usesSchema, включая селектор, ограничивающий цели, которых может достичь ребро; у сокета ad-hoc нет записи в каталоге и, следовательно, нет селектора, поэтому то, что может переносить ребро, ограничено только объявленными provides цели. Присутствует всегда, поэтому потребителю никогда не приходится считать отсутствующее значение значением declared, а политика может требовать, чтобы каждое ребро было declared. Отличается от маркера привязки вложения, который отвечает на вопрос той же формы о другом предмете. Допустимые значения: "declared", "ad-hoc"
origin_featurestringнетЕсли это ребро было самостоятельно объявлено сущностью Feature (включая Features учётных данных с меткой feature.aggrega.ai/kind: secret), здесь указывается URI типа Feature. Позволяет Wasm-плагинам изолировать собственную топологию.
origin_feature_instancestringнетИмя экземпляра для конкретного вложения той Feature, которая объявила это ребро. Находит разрешённые provides сущности FeatureRecipe уровня границы по экземпляру, различая два вложения одного типа Feature на одной границе.
origin_releaseлогическаянетTrue, если это ребро создано сущностью Release, подключившей объявленный, но не привязанный сокет к существующему компоненту. Отмечает АВТОРСТВО ребра, а не конфигурацию: ребро, объявленное разработчиком, для которого Release лишь предоставил infra, остаётся ребром происхождения Aggregate (origin_release не задан; его infra из Release появляется в карте infra ребра). origin_feature задан => происхождение Feature; origin_release равен true => происхождение Release; ни то, ни другое => происхождение Aggregate.
valuesobjectнетРазрешённые значения разработчика для этого соединения (из ребра Aggregate), проверенные при разрешении по valueSchema, объявленной исходным сокетом (сокетом на потребляющем компоненте, который является источником ребра), и спроецированные в контекст рендеринга потребляющего узла по пути .context.uses..values. Ключи, опущенные автором, заполняются из объявленных значений по умолчанию сокета; значение, заданное автором, имеет приоритет.
infraobjectнетРазрешённые infra для этого соединения, предоставленные записью ребра в Release, проверенные при разрешении по infraSchema, объявленной исходным сокетом (сокетом на потребляющем компоненте, который является источником ребра), и спроецированные по пути .context.uses..infra. Ключи, опущенные автором, заполняются из объявленных значений по умолчанию сокета; значение, заданное автором, имеет приоритет.
injectobjectнетАгностичная маршрутизация внедрения. Сопоставляет локальные переменные ключам provides цели.
sensitive_payload_leavesstring[]нетЛистья в values и infra этого ребра, которые сокет, относительно которого они записаны, объявляет чувствительными, каждый в виде пути через точку с префиксом столпа, который занимает элемент данных: values. или infra.. Читаемое объявление — это контракт отдельного соединения на ПОТРЕБЛЯЮЩЕМ компоненте — источнике ребра — в сокете, к которому подключено это ребро: его valueSchema управляет values, а его infraSchema — infra, и это тот же контракт, по которому проверяются обе полезные нагрузки. Объявления цели не играют роли: то, что публикует цель, — это иной элемент данных, нежели конфигурация, которую потребитель записывает для соединения. Это то же поле, читаемое тем же способом, что и маркировка на узле, но с другим предметом: маркировка узла называет собственные данные узла относительно схемы его сущности Component, а эта называет конфигурацию соединения относительно контракта сокета, поэтому ни одну из них нельзя восстановить из другой. Здесь читаются полезные нагрузки, которые несёт это ребро, поэтому лист, стоящий на значении, которое контракт сокета объявляет значением по умолчанию, называется наравне с листом, написанным автором. Лист появляется там, где его покрывает путь, который контракт объявляет чувствительным: объявление называет этот лист или объект, содержащий его. Сопоставление идёт по сегментам пути через точку, без чтения чего-либо из самого текста пути и без проверки значений, поэтому объявление в db покрывает db.password и не достигает соседнего листа с именем db_password. Поверхность, которая скрывает в графе значения, объявленные чувствительными, скрывает эти листья в values и infra этого ребра, а также в записи uses потребляющего узла для того же соединения, которая несёт значения в том виде, в каком их написал автор. Отсутствующий ключ означает, что это ребро не называет ни одного листа, который контракт его сокета объявляет чувствительным, включая случай, когда сокет не объявляет контракта, который можно было бы здесь прочитать. Он не утверждает, что конфигурация нечувствительна, и потребитель, читающий отсутствующий ключ как разрешение показать или вывести значение в открытом виде, прочитал его наоборот. Листья идут в том порядке, в каком их хранят полезные нагрузки, листья столпа values перед листьями столпа infra, и именно это сохраняет граф побайтно идентичным между запусками на одинаковых входных данных. Отсутствует, когда ребро не несёт ни одного листа, который контракт его сокета объявляет чувствительным.

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

IREdge.inject

Агностичная маршрутизация внедрения. Сопоставляет локальные переменные ключам provides цели.

СвойствоТипОбязательноОписание
envmap of stringнетДоставка через переменные окружения: ключи — имена локальных переменных потребителя, значения — ключи provides цели.
filemap of stringнетДоставка через монтирование файлов: ключи — локальные пути к файлам потребителя, значения — ключи provides цели.
argmap of stringнетДоставка через аргументы командной строки: ключи — префиксы флагов потребителя, значения — ключи provides цели.

IRMetadata

Идентичность графа: Aggregate, из которого он построен.

СвойствоТипОбязательноОписание
aggregate_namestringдаmetadata.name сущности Aggregate.

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

IRProvenance

Метаданные трассируемости для диагностики и аудита.

СвойствоТипОбязательноОписание
schema_versionstringдаВерсия схемы IR, которой соответствует граф, — aggrega.ai/v1beta1, то же значение, что несёт apiVersion графа.
compiler_versionstringдаОбязательная отметка соответствия. Определяет по версии бинарный файл aggrega, который собрал этот граф.
aggregate_versionstringдаТочная семантическая версия корневого намерения Aggregate, использованного при компиляции.
manifest_versionstringдаТочная семантическая версия lock-файла Manifest, использованного при компиляции.
release_versionstringдаТочная семантическая версия файла маршрутизации Release, использованного при компиляции.

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

IRSpec

Сам граф: его узлы, рёбра и полезные нагрузки, индексированные по узлам.

СвойствоТипОбязательноОписание
nodesmap of IRNodeдаСловарь всех узлов графа с ключами по их абсолютному ID. Чисто топологический. Ключи: одна или несколько букв, цифр, знаков подчёркивания, точек или дефисов. Шаблон: ^[a-zA-Z0-9_.-]+$.
edgesIREdge[]даЯвные логические сетевые пути и зависимости между узлами.
values_mappingobjectдаЕдиный источник истины для непрозрачных сквозных когнитивных полезных нагрузок, сопоставленных по ID узла.
infra_mappingobjectдаПолезная нагрузка физического масштабирования, внедрённая из Release, сопоставленная по ID узла.
feature_values_mappingmap of map of IRFeatureEntryдаНормализованная карта ID узлов на конфигурации прикреплённых к ним Features. Одна корзина содержит все вложения узла, что бы они ни создавали, — операционные Features, Features учётных данных, Features идентификации — с ключами по имени экземпляра, которое автор дал каждому вложению. Вложение, записанное на одном из соединений узла, имеет ключом своё квалифицированное имя — псевдоним соединения и слот, соединённые точкой, — и указывает своё соединение в собственном поле connection. Ключи: одна или несколько букв, цифр, знаков подчёркивания, точек или дефисов. Шаблон: ^[a-zA-Z0-9_.-]+$.
boundary_featuresmap of map of IRBoundaryFeatureнетВложения Feature каждой границы с ключами сначала по пути границы, затем по имени экземпляра. Присутствует, только если в графе есть вложения Feature уровня границы. Ключи: одна или несколько букв, цифр, знаков подчёркивания, точек, косых черт или дефисов. Шаблон: ^[a-zA-Z0-9_./-]+$.
provenanceIRProvenanceдаМетаданные трассируемости для диагностики и аудита.

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

IRGraph

СвойствоТипОбязательноОписание
apiVersionconst “aggrega.ai/v1beta1”даКонстанта: "aggrega.ai/v1beta1"
kindconst “IR”даКонстанта: "IR"
metadataIRMetadataдаИдентичность графа: Aggregate, из которого он построен.
specIRSpecдаСам граф: его узлы, рёбра и полезные нагрузки, индексированные по узлам.

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