Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Філософія екосистеми

Філософія екосистеми

Архітектура Aggrega спирається на ключові принципи проєктування, що врівноважують гнучкість і передбачуваність. Завдяки чітким межам і стандартизованим контрактам принципово універсальний компілятор може безшовно оркеструвати все: від стандартної cloud-native інфраструктури до вузькоспеціалізованого штучного інтелекту.

1. Базова механіка: фізика архітектури

  • Розділення відповідальностей (закон Конвея): розробники не пишуть код фізичної інфраструктури, а Ops не закодовують жорстко логіку застосунку. Настанови архітектури поділяють авторинг на межі Domain-Driven — розділення, якого компілятор не нав’язує (див. інваріант 7).
  • Пізнє зв’язування (інверсія залежностей): розробники запитують абстрактні інтерфейси (наприклад, type: enterprise-agent), а не конкретні реалізації (наприклад, helm-chart-v2). Сутність Manifest під час компіляції зіставляє інтерфейс із правильною реалізацією, що уможливлює справжні розгортання на кілька цілей з одного вихідного файлу.
  • Чистота AOT (без отримання даних із живої хмари): Компілятор агностичний щодо живої хмари. Під час компіляції він ніколи не автентифікується в API інфраструктури й не отримує живі IP-адреси. Він повністю працює на основі інверсії керування, відображаючи детерміновані вказівники та заздалегідь передаючи абстрактні контракти впровадження, щоб середовище виконання могло безпечно розв’язати остаточні фізичні з’єднання.

2. Досвід розробника: намір і абстракція

  • Семантичний досвід розробника (стандарт мапи з 5 ключових слів): щоб запобігти когнітивному тертю, розробники використовують рівно п’ять загальнозрозумілих ключових слів у топології YAML на основі мап:
    1. parameters: глобальний контракт середовища (наприклад, передавання динамічних розмірів дисків).
    2. values: основне корисне навантаження когнітивної/бізнес-логіки (належить розробникам).
    3. uses: явно оголошені мережеві ребра та залежності (належать розробникам).
    4. infra: фізичний слід і механічне визначення розмірів (належать Ops, заборонені в сутності Aggregate).
    5. inject: суворий контракт доставлення, що зіставляє локальні змінні з цільовими ключами provides (env, file, arg). Цей механізм розширюваний.
  • Термінологія, незалежна від можливостей: щоб реалії базової інфраструктури (як-от термін Kubernetes namespace) не просочувалися в досвід розробника, платформа використовує універсальні поняття, як-от boundaries.
  • Явний намір і «гучне обмеження» (жодної інфраструктури-привида): компілятор ніколи не повинен вигадувати обчислювальні ресурси чи функції, яких розробник явно не оголосив. Використання рушія політик для непомітного впровадження проксі безпеки створює «інфраструктуру-привида»: коли вона ламається, розробник зрештою налагоджує проксі, якого немає в його YAML. Замість непомітної зміни архітектури плагіни політик Wasm діють суворо як гучні обмеження. Якщо топологія порушує безпеку, компілятор зупиняє збірку й повертає дуже конкретну помилку (наприклад, «Помилка: дані PII надходять до постачальника моделей через AI-шлюз router. Ви маєте явно під’єднати до нього функцію core/data-masking»), змушуючи розробника виправити власне єдине джерело істини.

3. Компілятор без власної позиції: обробка та оркестрація

  • Програмовані політики (компілятор без власної позиції): Основний компілятор Go — це нейтральний щодо вмісту обчислювальний механізм. Він розбирає YAML, обходить графи й обчислює перетини міток. Справжній «інтелект» (наприклад, вимогу, щоб трафік моделей, який переносить дані з обмеженим доступом, проходив через AI-шлюз, що маскує чутливий текст) підприємство програмує динамічно за допомогою підключуваних сокетів WebAssembly (Wasm) для мутацій абстрактного синтаксичного дерева (AST)—зміни розібраного представлення конфігурації в пам’яті—та для валідації політик.
  • Агностичність щодо схем (словник з відкритим кодом): Основний компілятор агностичний щодо фізичних рівнів виконання. Він не має жорстко закодованих схем для Helm, Terraform чи Docker Compose. Натомість блок source сутності Recipe для Ops — це відкритий словник, ключі якого визначає провайдер і які потрапляють до шаблонів сутності Recipe як .source.*. Ядро розв’язує отримуване джерело за вбудованою формою { kind, url, version } (види: helm-oci-chart, helm-https-chart, compose-https-fragment, git-repository), що вже відокремлює компілятор від хмарних мов, якими він маніпулює. Модель отримання описано в довіднику source сутності Recipe.
  • Явна оркестрація сутностей Plugin: основний компілятор Go діє суворо як нейтральний будівник графів і ніколи не вгадує, як обробити вузол. Натомість увесь доменний інтелект явно оркеструється через спеціальні сокети WebAssembly (Wasm) на двох окремих рівнях. 1. Глобальні сокети: корпоративні політики та форматування оцінюються явно зареєстрованими сокетами компілятора (наприклад, роллю керування label-transform для автоматичного тегування метаданих, роллю керування, що виносить вердикти щодо топологічної безпеки, і сокетом рендерера для остаточного генерування артефактів). 2. Конвеєри реалізації: логіку мутацій, специфічну для сутності Component, оркеструє Manifest; коли він зіставляє абстрактний інтерфейс із конкретним Recipe, ця реалізація явно оголошує послідовний масив pipeline плагінів Wasm для виконання. Компілятор лише передає незалежний від можливостей граф проміжного представлення (IR) у ці визначені сокети, гарантуючи, що вся доменно-специфічна логіка залишається суворо версіонованою в екосистемі, а не жорстко закодованою в ядрі компілятора.
  • Пласка компіляція та атомарність сутностей Feature: Aggrega не керує станом, не опитує кінцеві точки й не чекає завершення викочування. Компілятор обчислює вкладені модулі й зводить їх до плаского одновимірного графа проміжного представлення (IR), перш ніж передати дані плагінам рендерингу Wasm. Важливо, що хоча граф сплощується, компілятор зберігає атомарність сутностей Feature. Якщо функція проксі самостійно оголошує мережеве ребро до захищеного сховища, компілятор фіксує семантичне походження цього ребра, гарантуючи, що рушії політик Wasm можуть виконувати пошук за $O(1)$, не приписуючи помилково з’єднання батьківському компоненту. Нарешті, для підтримки часової послідовності кожна межа в сутності Release має значення syncWave: <integer>; кожен плагін рендерингу перекладає хвилю кожної межі в той засіб, яким його власна ціль виражає порядок (анотацію порядку виконання, яку читає низхідний контролер GitOps, або залежність між сервісами файлу, який він генерує), тоді як ціль, що взагалі не має засобу впорядкування, записує хвилю, не впорядковуючи за нею.

4. Семантична онтологія: ідентифікація та таксономія

  • Операційна cloud-native онтологія: щоб плагіни Wasm з відкритим кодом і корпоративні політики могли універсально взаємодіяти, мітка component.aggrega.ai/type зіставляється виключно із закритим набором універсальних хмарних примітивів (server, worker, task, function, stateful-server, resource). Це власний ключ Aggrega: опублікована схема сутності Component перелічує значення, яких він набуває, а документ з будь-яким іншим значенням відхиляється під час завантаження. Саме централізоване фіксування цього словника гарантує, що автономні рушії політик і створені спільнотою плагіни рендерингу Wasm читають одне й те саме слово для однієї й тієї самої форми, коли зустрічають сутність Component, яку не писав жоден з їхніх авторів. Компілятор при цьому нічого не виводить із рядка: він зіставляє значення із селектором і нічого не надає з власної ініціативи; закритий набір забезпечує те, що селектор кожного зіставляє той самий словник.
  • Класифікація за віссю, яку Aggrega не визначає: закритий набір охоплює лише цей один зарезервований ключ. Каталог, якому потрібна власна класифікація (рівень, зона даних, клас сервісу, дрібніший поділ примітивів), визначає власний ключ мітки поруч із зарезервованим, оскільки схема сутності Component приймає будь-який додатковий ключ мітки з рядковим значенням, а кожна поверхня селекторів читає його однаково. Розширення відбувається у вашому ключі, а не всередині ключа Aggrega, і саме це дає змогу корпоративному словнику зростати без дрейфу спільного.
  • Качина типізація (семантичні ознаки через мітки): якщо базові типи суто cloud-native, увесь когнітивний, операційний і комплаєнс-інтелект нашаровується повністю через семантичну качину типізацію. Мітки, створені Platform Architect (наприклад, model.aggrega.ai/capability: generative, compliance.aggrega.ai/data-class: restricted), слугують справжньою ідентичністю вузла. Сутності Features динамічно прив’язуються до компонентів на основі цих селекторів міток.

5. Корпоративне керування: схеми та успадкування

  • Суворе розділення API та корпоративна виявлюваність: відповідно до стандартів Kubernetes усі визначення корисного навантаження однаково розміщуються в блоці spec:. Ідентичність ресурсу, характеристичні мітки та явні інструкції для компілятора розміщуються суворо в блоці metadata:. Щоб гарантувати суворе розв’язання, кожен спільний артефакт YAML суворо вимагає рядка SemVer version, перевіреного регулярним виразом. Крім того, для підтримки виявлюваності в реєстрах OCI та керування життєвим циклом блок metadata підтримує необов’язковий корпоративний набір метаданих. Цей набір містить description, структурований масив об’єктів maintainers (name, email, url), license, repository, home (URL документації) і keywords (для пошукового індексування). Кінець життєвого циклу керується поза документом: aggrega deprecate додає до вже опублікованого артефакту підписану позначку застарілості — рівень серйозності, причину та необов’язкову заміну, — не змінюючи його опублікованих байтів.

  • Розширюваність схем (патерн CRD у Kubernetes): щоб не оновлювати схему основного компілятора для кожної нової AI- чи інфраструктурної функції, платформа використовує JSON Schema 2020-12 для валідації конфігурацій. Platform Architects пишуть суворі типи, логіку валідації та значення за замовчуванням безпосередньо в блоці schema: компонентів каталогу, зазвичай у компактній формі — скороченому записі у формі YAML, що вміщує обмеження кожного поля в один рядок (port: { type: integer, min: 1, max: 65535, default: 8080 }) і компілюється в JSON Schema 2020-12 перед запуском валідації. Повний YAML у JSON Schema залишається рівноправним варіантом для схем, яким потрібен його повний словник. Каталоги, що виросли настільки, що виграють від повторного використання схем між сутностями Component, виносять спільні форми (блоки проб, ліміти ресурсів, форми іменованих портів) у спеціальну сутність SchemaLibrary і посилаються на них через ключове слово JSON Schema $ref:.

  • Успадкування схем (базові лінії корисного навантаження): щоб базову лінію визначали лише один раз, платформа поділяє успадкування на два окремі рівні. Стандартні метадані YAML (зокрема семантичні мітки), зіставлення Manifest і конфігурації Release використовують традиційні стратегії злиття, щоб дозволити потрібні перевизначення для середовищ. Схеми корисного навантаження (schema:) так не зливаються, і два види каталогу тут розходяться: schema: сутності Feature компонується зі схемою її бази за семантикою композиції JSON Schema 2020-12 і обходиться під час завантаження робочого простору механізмом злиття, який позначає походження за позицією у вихідному файлі, тож кожен лист злитої схеми несе свій вихідний файл; розширювальна сутність Component узагалі не визначає вмісту корисного навантаження: вона записує буквальний маркер schema: inherited і отримує блок своєї бази точно таким, яким його визначила база, на будь-якій глибині ланцюжка. Отже, базова лінія сутності Component гарантована конструкцією, а не політикою: контракт нащадка просто є контрактом бази, тож нащадкові нічого послаблювати. Натомість така сутність Component компонує структуру (свої слоти приєднання, сокети топології, список дозволеного самовпровадження та іменовані assertions), а нащадок, якому потрібне суворіше правило, ніж оголошує його база, виражає його як додатковий запис assertions:, який правила бази зберігають поруч із собою, а не замінюються ним. Ширша топологічна безпека та керування мітками й надалі належно делеговані сокету керування Wasm.

  • Паритет інтерфейсів та автоматична реалізація: щоб Ops не доводилося дублювати YAML сутностей Recipe, коли архітектор породжує трохи змінений варіант базової сутності Component, сутність Recipe, написана для бази, обслуговує кожну сутність Component, що її розширює, на будь-якій глибині ланцюжка. Розширювальна сутність Component пише schema: inherited, тож не додає до values/infra/provides жодного кореневого ключа, який сутність Recipe бази не змогла б обробити. Сутність Manifest і далі зіставляє розширювальний тип власним записом, а перевірка зіставлення приймає цей запис, коли implements зіставленої сутності Recipe називає цей тип або будь-яку базу, яку він розширює (див. Сутність Recipe, написана для бази, обслуговує все, що її розширює). Трекер інфраструктури-привида (видає попередження, коли жоден шаблон, оголошений прив’язаною сутністю Recipe, не читає заданого ключа, щоб запобігти «інфраструктурі-привиду») — відповідне обмеження на етапі рендерингу.

  • Зіставлення версій у implements: поле implements у сутностях Recipes і FeatureRecipes підтримує три форми, щоб збалансувати суворість і гнучкість екосистеми:

    1. Точна версія: implements: "core/api-server:1.0.0" — збігається лише з 1.0.0. Для сутностей Recipes, тісно пов’язаних із конкретною версією схеми.
    2. Сумісна за мажорною версією (діапазон SemVer): implements: "core/api-server:^1.0.0" — збігається з >=1.0.0, <2.0.0. Призначена для сутностей Recipes, що покладаються на гарантії сумісності SemVer сутності Component: мінорні та патч-оновлення вважаються зворотно сумісними згідно з SemVer, а компілятор перевіряє, що версія сутності Component задовольняє діапазон.
    3. Без версії: implements: "core/api-server" — збігається з будь-якою версією. Для сутностей Recipes, справді незалежних від версії (наприклад, універсальної сутності Recipe для worker, яка використовує лише .context.inject.env і жодних специфічних для версії полів values).

    implements ніколи не обирає сутність Recipe: сутність Manifest називає Recipe для кожного типу компонента, а компілятор перевіряє, що implements зіставленої сутності Recipe приймає цей тип в одній із трьох форм, і зупиняється в разі невідповідності. За цим самим оголошенням компілятор пропонує кандидатні сутності Recipes, коли тип компонента не має зіставлення.

    Патерн трьох форм дає змогу сутностям Recipes оголошувати контракт версії, що відповідає їхньому фактичному зв’язку зі схемою сутності Component. Сутності Recipes, тісно прив’язані до конкретної версії схеми, закріплюють її точно; сутності Recipes, що покладаються на гарантії сумісності SemVer сутності Component, використовують діапазон, сумісний за мажорною версією; сутності Recipes, поведінка яких зовсім не залежить від версії сутності Component, залишаються без версії. У результаті мінорні оновлення версії сутності Component не змушують Ops ні закріплювати версії сутностей Component, ні підтримувати паралельні сутності Recipes для кожної версії.