Цю сторінку перекладено машинним способом. Читати оригінал англійською.
Дорожня карта Aggrega
Звідки походить Aggrega і куди рухається, великими кроками. Віхи від 0 до 3 описують, що компілятор і його каталог роблять сьогодні; віха 4 і напрями після неї описують роботу, що попереду. Ця сторінка не наводить дат. Що працює сьогодні, поверхня за поверхнею, описано на сторінці Стан мови.
Віха 0 — Прототип
Перший прототип компілював документи YAML через проміжний граф у вивід Helm і показав, що підхід працює. Компілятор, що з’явився згодом, було написано навколо описаної нижче моделі сутностей.
Віха 1 — Ядро компілятора
- Модель сутностей. Розробники описують застосунок у сутності Aggregate. Команди платформи надають сутності Components і Features, які використовує ця сутність, а також сутності Recipes і FeatureRecipes, що реалізують їх на цільовій платформі; сутність Manifest зіставляє кожен тип з його сутністю Recipe, а сутність Release розміщує сутність Aggregate в одному середовищі.
- Конвеєр компіляції. Розв’язання, побудова топології, фіналізація графа, статичний аналіз і рендеринг перетворюють документи на проміжний граф компонентів і з’єднань
usesміж ними, а потім на файли. - Контракт ін’єкції. Компонент публікує свої значення з’єднання через
provides, а компілятор передає їх кожному споживачу черезinject, між просторами імен, без того щоб розробник писав ім’я хоста. - Параметри для кожного середовища. Сутність Aggregate надає параметри, а кожна сутність Release заповнює їх для свого середовища.
- Маніфести Kubernetes і чарти Helm, що записуються для кожної межі, з
aggrega buildіaggrega inspect.
Віха 2 — Повний конвеєр
- Features, що рендерять ресурси, і облікові дані як Features. Приєднана сутність Feature може рендерити власні ресурси, а облікові дані — це така сама сутність Feature, як і будь-яка інша, що доставляється своєму компоненту як змінна середовища або файл.
- Docker Compose, з мостом, що ретранслює з’єднання між мережами Compose.
- Три способи написати сутність Recipe, які можна поєднувати: обгорнути наявний чарт, модуль або файл (
source:), один раз описати контейнер як сутність Workload, яку синтезує цільова платформа (workload:), або генерувати власні файли (artifacts:). - Детермінований вивід. Порядок автора зберігається всюди, тож ідентичний вхід дає побайтово ідентичний вивід.
- Одна мова схем. JSON Schema 2020-12 з компактною скороченою формою YAML, бібліотеками схем і зіставлень для повторного використання, типізованими контрактами параметрів і міжпольовими твердженнями.
- Features, приєднані через анотацію. Сутність Release або Aggregate приєднує сутність Feature, записуючи анотацію, яку зв’язує сутність Manifest, з тим самим результатом, що й під час явного приєднання.
aggrega build --trace, що записує проміжний стан кожного компонента для налагодження.
Етап 3 — випуск 0.9.0
Що додає 0.9.0:
- П’ять цільових платформ, рендеринг яких виконують плагіни. Маніфести Kubernetes, чарти Helm, Docker Compose, Terraform і CloudFormation записує кожен окремий плагін провайдера WebAssembly, вбудований у бінарний файл, тож щойно встановлена копія рендерить офлайн; компілятор записує файли й ніколи не запускає інструменти. Поле
formсутності Workload вибирає контролер, яким вона стає: без стану, зі станом, демон, запланований або одноразове завдання. - Plugins для всього, що специфічне для предметної області. Providers, політики, імпортери, кроки конвеєра й розширення командного рядка — це плагіни WebAssembly, написані за допомогою наборів для плагінів для Go, Rust і TypeScript. Хост і плагін обмінюються даними через один версійований інтерфейс, закодований у CBOR і згенерований з єдиної схеми для всіх трьох мов.
- Управління. Плагін політик, приєднаний до робочого простору, перевіряє кожну збірку: він відхиляє граф або відрендерений файл, що порушує правило, вказуючи, що виправити, або додає мітки й анотації, яких розробник ніколи не вводить.
- Реєстри, lock-файли та підписування. Сутності каталогу, зокрема сутності Aggregates, публікуються в реєстрах OCI та витягуються з них за ім’ям і версією;
aggrega pullфіксує кожну залежність у lock-файлі, а артефакти підписуються під час публікації та перевіряються під час витягування. - Каталог стандартної бібліотеки та його публічний хаб. Сутності Components для агентів, моделей, шлюзів, сховищ даних, обміну повідомленнями, спостережуваності, безпеки та зберігання, упорядковані за мітками типу, категорії та можливостей і доступні з
hub.aggrega.ai. aggrega import. Плагіни-імпортери створюють чернетки файлів Aggrega з проєктів Langflow, Flowise, n8n, Dify, CrewAI, LangGraph, Google ADK, Microsoft Agent Framework, MCP і Docker Compose, оцінюючи кожне зіставлення щодо каталогу;--syncпідтримує чернетки в узгодженні з їхнім джерелом.- Легкий початок. Сутності Release або Aggregate з однією областю не потрібні межі чи підсистеми, а
aggrega scaffold,aggrega edit-document,aggrega validate,aggrega lintіaggrega explainпідтримують цикл створення. - Редактор і асистент. Розширення для Visual Studio Code додає валідацію, навігацію, підказки під час наведення, автодоповнення та граф топології для YAML Aggrega через
aggrega serve;aggrega mcpі навичка Aggrega надають ШІ-асистенту ті самі інструменти. - Встановлення однією командою в Linux, macOS і Windows або за допомогою Homebrew, Scoop і winget.
Віха 4 — Впровадження користувачами, більше хмар і більший каталог
- Впровадження користувачами. Те, що кажуть нам користувачі, визначає порядок роботи: першим іде все, що полегшує впровадження.
- Провайдери для Azure і Google Cloud.
- Більший каталог. Більше компонентів і сутності Recipes для кожної цільової платформи, зокрема реалізації базових компонентів у Terraform і CloudFormation.
- Формально верифіковане ядро. Ключові властивості компілятора, доведені як теореми в Lean: ідентичний вхід дає ідентичний вивід, не генерується нічого, що не було оголошено, і кожне значення з’єднання досягає саме тих споживачів, яких називають його з’єднання
uses. Тести на основі властивостей охоплюють вбудовані плагіни.
Подальші напрями
- Живе подання вашої архітектури. Граф топології в редакторі та
--ir-graphуже показують граф, який розв’язав компілятор; потоковий режим надсилав би цей граф у міру його змін, щоб фронтенд відстежував кожне редагування в момент, коли воно відбувається. - Workloads у керованих контейнерних сервісах. Сутність Workload, описану один раз, синтезують для керованих контейнерних сервісів хмарних цільових платформ, таких як Amazon ECS і Fargate, Google Cloud Run та Azure Container Apps.
- Більше форматів для імпорту. Специфікації OpenAPI для API, яке застосунок викликає або обслуговує, і файли робочих навантажень Score.
- Чернетка сутності Recipe на основі її сутності Component. Початкова сутність Recipe, яка вже читає значення сутності Component і передає її значення з’єднання, щоб команда платформи її доповнила.
- Шаблони, що змінюють форму документа залежно від середовища. Ключ, присутній в одному середовищі й відсутній в іншому, завдяки обчисленню шаблонів до розбору документа.
- Результати перевірки політик у редакторі. Результати плагіна управління, показані в редакторі в міру зміни файлів, поряд із валідацією, яку він показує сьогодні.