Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Справочник по языку

«Что» и «как использовать» в Aggrega. Синтаксис, вызов CLI, каталог ошибок, разобранные примеры.

При первом знакомстве читайте главы ниже по порядку. Справочные подкаталоги перечислены под своими главами — переходите к ним напрямую, когда ищете конкретную сущность, ключевое слово, провайдер, команду CLI или ошибку.

Прежде чем читать главы по порядку, ознакомьтесь с разделом Состояние языка, чтобы узнать текущую степень готовности: какие возможности языка доступны уже сегодня, какие принимаются, но пока не обрабатываются компилятором, и какие запланированы на будущие итерации. Раздел Совместимость определяет, что выпуск обещает в отношении схем, командной строки, инструментов ассистента, кодов ошибок и наборов для разработки плагинов.

Модель уровней сущностей

Виды сущностей для авторинга в Aggrega организованы в три уровня, отражающих последовательность освоения (см. ниже). Рядом с ними стоит принадлежащая платформе сущность Workload, которая не является самостоятельным видом для авторинга: это форма, которую принимают синтезированные входные данные сущности Recipe, выражающая форму вычислений через словарь form: (stateless, stateful, daemon, scheduled, task, reference). Деление на уровни — это механизм документации и знакомства с языком, а не ограничение времени выполнения: каждый вид сущностей — полноправный элемент языка; компилятор обрабатывает их единообразно; Aggrega с открытым исходным кодом поддерживает все уровни без лицензирования и без ограничения функциональности. Отметки уровней означают «продвинутое; пропустите, если не нужно» для навигации, а не для возможностей.

УровеньВиды сущностейКогда осваивать
Уровень 1 — минимально достаточный наборAggregate, Component, Recipe, Manifest, ReleaseДень 1 — основатели-одиночки и небольшие команды выпускают работающее ПО, используя только уровень 1. Ментальная модель: «У меня есть приложение; я хочу его развернуть; вот как это сделать».
Уровень 2 — разделение ролейFeature, FeatureRecipe, PluginДень 30 — небольшие команды, в которых роли разделяются (разработчик + Ops + иногда безопасность). Уровень 2 появляется через сущности Plugins для рендеринга провайдеров (Ops выбирают между Helm, helm-chart, Compose, Terraform и CloudFormation), сущности Features (безопасность управляет учётными данными отдельно от конфигурации приложения) и сущности FeatureRecipes (настройка в момент привязки для каждого провайдера).
Уровень 3 — повторное использование между сущностями ComponentSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibraryДень 365 — зрелые каталоги, в которых общие формы повторяются во многих сущностях. Порог неформален: когда форма (например, PodResources) встречается в 5+ сущностях Components и согласование обновлений становится обременительным, запись в SchemaLibrary себя оправдывает.

Каждый шаг освоения добровольный. Основателя-одиночку никогда не заставляют разбираться с уровнем 3; корпоративный каталог имеет полный доступ к уровню 3 по мере необходимости. Уровень 1 полон для сценария основателя-одиночки: разработчик может выпускать работающие приложения, используя только сущности уровня 1. Это важное свойство дизайна: уровень 1 — не «подмножество, которое компилируется», а «подмножество, с которым выпускают ПО».

Набор уровня 1 из пяти сущностей требует начальных затрат: Aggregate + Component + Recipe + Manifest + Release — это больше формальностей, чем «положи YAML-файл и получи работающий сервис». Эти затраты — цена разделения авторинга на четыре домена (намерение разработчика / каталог платформы / эксплуатация платформы / маршрутизация), которое отличает Aggrega от чистого Helm или чистого Terraform. Учебные руководства уровня 1 явно разбирают настройку из пяти сущностей.

Внутри уровня 3 механизм spec.templates / $instantiate: (параметрические вспомогательные шаблоны в SchemaLibrary) описан как ещё более продвинутая подфункция. Большинство осваивающих уровень 3 поначалу не прибегают к spec.templates; порог — «когда в вашей библиотеке 6+ схем с общей параметризованной структурой».

Порядок чтения

  1. Как пользоваться этим справочником
  2. Соглашения об именовании
  3. Обзор справочника сущностей
  4. Обзор словаря
  5. Обзор шаблонов
  6. Обзор сущностей Providers
  7. Обзор CLI
  8. Обзор ошибок
  9. Обзор примеров

Справочник по разработке Plugin

Интерфейс плагинов Wasm располагается рядом с последовательностью глав, а не внутри неё: автор плагина читает его независимо от пути написания сущностей. Страница сущности plugin описывает интерфейс написания каталога; страницы ниже описывают сокеты, полезные нагрузки и рабочий процесс автора.

  • plugin-contract — сокеты, к которым подключается плагин, их место в конвейере и формы входных и выходных данных каждого сокета.
  • plugin-developer-guide — сквозной рабочий процесс автора: describe(), заявления о возможностях, ограничения среды выполнения, жизненный цикл publish/pull/build, подписание, версионирование.
  • policy-socket — подробно о сокете управления: его четыре роли, уровни серьёзности вердиктов, канал входных данных оператора и написание политики для любого из движков, поставляемых в составе компилятора.
  • governance-attachment-facts — факты по каждому подключению, которые политика управления считывает из графа сборки, включая три единицы маркировки чувствительности и причину, по которой отсутствие маркировки не является разрешением.
  • when-to-use-a-pipeline-step — выбор между шагом конвейера и шаблонной FeatureRecipe.
  • embedded-plugins — плагины, поставляемые в составе исполняемого файла компилятора.
  • tagging-plugins — два встроенных плагина управления, которые записывают метки без политики, governance/label-injector и governance/selector-tagger: их настройки и то, что записывает каждый из них.
  • core-importers — десять импортёров компилятора, от Langflow, Flowise и n8n до Compose, MCP и фреймворков агентов: что каждый из них читает и какие черновики составляет, их настройки и их публикация с каждым выпуском компилятора.
  • authoring-a-provider-walkthrough — пошаговый разбор создания гостевого модуля провайдера: от пустого каталога до сборки, записывающей файлы, которые отрендерил провайдер.
  • writing-a-governance-plugin — написание собственного плагина управления на основе каркаса адаптера из набора для плагинов: одно правило, ручной запуск экспорта каждой роли, сущность Plugin в каталоге рабочего пространства и сборка, которую плагин отклоняет.
  • compatibility — как версионируются наборы для разработки плагинов: что могут изменить патч-выпуск и минорный выпуск набора и что позволяет уже собранному плагину продолжать загружаться.