Схема графа 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 із FieldProvenance | ні | Походження кожного листка корисного навантаження values за шляхом листка через крапку. |
infra_provenance | map із 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 межі, з якою boundary-scope FeatureRecipe рендерить і розв’язує своє джерело. Приєднання на рівні межі не містять корисного навантаження values.
| Властивість | Тип | Обов’язкова | Опис |
|---|---|---|---|
type | string | так | URI Feature каталогу, приєднаної на цій межі. |
infra | object | ні | Фізичні розміри для приєднання межі; infra, з якою boundary-scope FeatureRecipe обчислює свої шаблони та джерело. |
sensitive_payload_leaves | string[] | ні | Листки, які містить корисне навантаження infra цього приєднання межі і які приєднана Feature оголошує чутливими, кожен як шлях через крапку з префіксом стовпа, що його займає значення. Тут з’являються лише координати infra.db охоплює db.password і не сягає сусіднього листка з назвою dbPassword. Відсутній ключ означає, що це приєднання не називає жодного листка, який його Feature оголошує чутливим, зокрема у випадку, коли приєднана Feature не розв’язується в жодну схему, яку міг би прочитати цей читач. Він не стверджує, що корисне навантаження infra нечутливе, і не відрізняє приєднання, яке не має такого листка, від виробника, що взагалі не повідомляє цю вісь. Споживач, який сприймає відсутній ключ як дозвіл показати чи вивести значення у відкритому вигляді, прочитав його навпаки. Листки надходять у тому порядку, у якому їх містить корисне навантаження, — у тому самому порядку, що його має саме корисне навантаження infra, і саме це зберігає граф побайтово ідентичним між запусками з ідентичними вхідними даними. Відсутнє, коли приєднання не містить жодного листка, який його Feature оголошує чутливим. |
realization | string | ні | FeatureRecipe, що реалізує це приєднання межі, у формі |
Додаткові властивості не дозволені.
CatalogMetadata
Набір корпоративних метаданих (Enterprise Metadata Suite), явно витягнутий із сутності каталогу, що надає дані про життєвий цикл і власність лінтерам Wasm.
| Властивість | Тип | Обов’язкова | Опис |
|---|---|---|---|
maintainers | Maintainer[] | ні | Супровідники, яких каталожна сутність перелічує як своїх власників. |
license | string | ні | Ідентифікатор ліцензії SPDX, який каталожна сутність оголошує для програмного забезпечення, яке вона описує. |
repository | string | ні | URL Git-репозиторію, який каталожна сутність називає місцем зберігання своїх вихідних файлів. |
home | string | ні | URL домашньої сторінки, вікі або документації каталожної сутності. |
keywords | string[] | ні | Описові ключові слова, які оголошує каталожна сутність. |
Додаткові властивості не дозволені.
IRNode
| Властивість | Тип | Обов’язкова | Опис |
|---|---|---|---|
description | string | ні | Необов’язкова документація, написана розробником, що описує роль цього екземпляра компонента в застосунку. Передається з Aggregate для рендерингу та для діагностики лінтингу. |
labels | map of string | так | Мітки duck-typing та онтології сутності. |
component | string | так | Назва базової сутності Component. |
resolved_version | string | так | Точна семантична версія сутності Component, визначена під час компіляції. |
sync_wave | integer | ні | Хвиля розгортання, успадкована з поля 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_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 | ні | Набір корпоративних метаданих (Enterprise Metadata Suite), явно витягнутий із сутності каталогу, що надає дані про життєвий цикл і власність лінтерам Wasm. |
catalog_annotations | map of string | ні | Незмінні, внутрішні характеристики компонента, задані Platform Architect у Domain 2. |
release_annotations | map of string | ні | Рядки фізичної топології та операційні реалії, що каскадно успадковуються від меж у сутності Release. |
aggregate_annotations | map of string | ні | Когнітивні метадані, наміри розробника та FinOps, що каскадно успадковуються від підсистем у сутності Aggregate. |
self_inject | object | ні | Блок самоін’єкції рівня Component, перенесений із сутності Aggregate; агностична маршрутизація ін’єкцій, яку вузол оголошує для себе. Непрозорий на цьому рівні схеми; плагін політик, який його читає, сам розбирає байти. |
source_file | string | ні | Шлях відносно робочого простору до файлу сутності Aggregate, де було задано цей вузол. Вузли кореневого рівня несуть шлях кореневої сутності Aggregate; вузли sub-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", "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 | так | Сам граф: його вузли, ребра й корисні навантаження з ключами за вузлами. |
Додаткові властивості не дозволені.