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