Перейти до вмісту
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 із FieldProvenanceніПоходження кожного листка корисного навантаження values за шляхом листка через крапку.
infra_provenancemap із 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 межі, з якою boundary-scope FeatureRecipe рендерить і розв’язує своє джерело. Приєднання на рівні межі не містять корисного навантаження values.

ВластивістьТипОбов’язковаОпис
typestringтакURI Feature каталогу, приєднаної на цій межі.
infraobjectніФізичні розміри для приєднання межі; infra, з якою boundary-scope 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

Набір корпоративних метаданих (Enterprise Metadata Suite), явно витягнутий із сутності каталогу, що надає дані про життєвий цикл і власність лінтерам Wasm.

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

Додаткові властивості не дозволені.

IRNode

ВластивістьТипОбов’язковаОпис
descriptionstringніНеобов’язкова документація, написана розробником, що описує роль цього екземпляра компонента в застосунку. Передається з Aggregate для рендерингу та для діагностики лінтингу.
labelsmap of stringтакМітки duck-typing та онтології сутності.
componentstringтакНазва базової сутності Component.
resolved_versionstringтакТочна семантична версія сутності Component, визначена під час компіляції.
sync_waveintegerніХвиля розгортання, успадкована з поля syncWave межі, що містить вузол (типово 0; від’ємні значення дозволені). На K8s і Helm саме хвиля впорядковує розгортання: вона стає анотацією argocd.argoproj.io/sync-wave, а на ресурсі, який chart уже позначає як Helm hook, вона також стає helm.sh/hook-weight цього hook. На compose значення і записується як мітка сервісу, і впорядковує сервіси файлу, у який воно рендериться, через depends_on між ними. На cloudformation воно впорядковує створення стека, у який збирається група диспетчеризації: кожен ресурс хвилі оголошується залежним від ресурсів попередньої хвилі. Це порядок їх створення і, у зворотному напрямку, порядок видалення, але ніколи не готовність, бо шаблон стека не виражає поняття готовності ресурсу. На terraform воно впорядковує блоки module кореневої конфігурації, у яку збирається межа: кожен module хвилі оголошується залежним від modules попередньої хвилі. Це порядок, у якому рушій виконує дії, але ніколи не готовність, бо конфігурація не виражає поняття готовності ресурсу. Значення також передається разом із походженням збірки вузла.
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ніНабір корпоративних метаданих (Enterprise Metadata Suite), явно витягнутий із сутності каталогу, що надає дані про життєвий цикл і власність лінтерам Wasm.
catalog_annotationsmap of stringніНезмінні, внутрішні характеристики компонента, задані Platform Architect у Domain 2.
release_annotationsmap of stringніРядки фізичної топології та операційні реалії, що каскадно успадковуються від меж у сутності Release.
aggregate_annotationsmap of stringніКогнітивні метадані, наміри розробника та FinOps, що каскадно успадковуються від підсистем у сутності Aggregate.
self_injectobjectніБлок самоін’єкції рівня Component, перенесений із сутності Aggregate; агностична маршрутизація ін’єкцій, яку вузол оголошує для себе. Непрозорий на цьому рівні схеми; плагін політик, який його читає, сам розбирає байти.
source_filestringніШлях відносно робочого простору до файлу сутності Aggregate, де було задано цей вузол. Вузли кореневого рівня несуть шлях кореневої сутності Aggregate; вузли sub-aggregate несуть шлях файлу імпортованої сутності Aggregate. Шлях задано відносно кореня робочого простору (каталогу, що містить .aggrega-config.yaml), тож граф побайтово ідентичний на машинах, чиї робочі простори розташовані за різними абсолютними шляхами. Споживачі, що фільтрують діагностику за файлами, перед порівнянням розв’язують поле відносно того самого кореня робочого простору. Відсутнє, коли граф було зібрано без кореня робочого простору.
usesobjectніБлок uses вузла точно так, як його задав автор: кожна назва сокета відображається або на список імен цільових екземплярів, або на мапу записів з’єднань за псевдонімами, у порядку, в якому їх оголосив автор. Це блок у написаному вигляді, тобто інший факт, ніж розв’язані з’єднання в edges: сокет, який заповнив автор, з’являється тут, навіть якщо не створив з’єднання, тож читач може відрізнити сокет, заповнений автором, від сокета, що досягає цілі. Відсутній, коли вузол не задав блоку uses. Непрозорий на цьому рівні схеми; плагін політик, який його читає, сам розбирає байти.
sensitive_payload_leavesstring[]ніЛистки, які несе корисне навантаження values та infra цього вузла і які його сутність Component оголошує чутливими, кожен як шлях через крапку з префіксом стовпа, який займає дане: values. або infra.. Воно називає ВЛАСНІ дані вузла — те, що values_mapping та infra_mapping несуть для цього вузла, — і це інший предмет, ніж позначка на записі приєднання, яка називає дані, що їх приєднання несе відповідно до оголошення своєї сутності Feature. Жодне не можна відновити з іншого: Component вузла і Feature приєднання оголошують різні схеми, а вузол, що нічого не приєднує, однаково несе values. Тут читається те навантаження, яке несуть ці дві мапи, тож листок зі значенням, яке схема сутності 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", "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такСам граф: його вузли, ребра й корисні навантаження з ключами за вузлами.

Додаткові властивості не дозволені.