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

Дорожня карта 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 і передає її значення з’єднання, щоб команда платформи її доповнила.
  • Шаблони, що змінюють форму документа залежно від середовища. Ключ, присутній в одному середовищі й відсутній в іншому, завдяки обчисленню шаблонів до розбору документа.
  • Результати перевірки політик у редакторі. Результати плагіна управління, показані в редакторі в міру зміни файлів, поряд із валідацією, яку він показує сьогодні.