Только каталог — MariaDB + Adminer без написания собственной платформы
Этот пример развёртывает небольшой реальный стек — базу данных MariaDB с веб-интерфейсом Adminer перед ней — ссылаясь только на сущности каталога стандартной библиотеки. Здесь не написано ни одной сущности Component, Feature или Recipe: три коротких YAML-файла направляют всё на сущности, которые уже поставляются в каталоге.
Это самая маленькая поверхность написания, которую предлагает Aggrega, и естественное первое знакомство с языком. Родственный пример уровня написания развёртывает тот же стек, создавая собственный слой каталога: сначала прочитайте этот пример, чтобы увидеть, что даёт вам готовый каталог, а затем тот, чтобы узнать, как устроен лежащий под ним слой.
Три файла
aggregate.yaml— намерение разработчика: что представляет собой стек. Два компонента, выбранных из каталога поtype:, обязательные учётные данные в виде вложения, заполняющего слот, и одно реброuses, подключающее базу данных к сокетуdatabasesв Adminer.release.yaml— реализация оператора для каждого окружения: какого размера и где. Блокиinfra:(версия движка, размер хранилища, опубликованный порт) принадлежат оператору; сущность Aggregate никогда их не содержит.manifest.yaml— маршрутизация оператора: какая сущность Recipe реализует каждый тип на этой цели. Ниже объясняется, почему ссылки уточнены провайдером.
Что демонстрирует пример
- Сущности Components как ссылки на каталог.
type: core/datastore/mariadbиtype: core/devtool/adminer— это всё объявление вычислительных ресурсов. Разработчик задаёт только значения, которые предоставляют схемы сущностей Component, — каждое опущенное поле получает значение по умолчанию из схемы (сравните переменные окружения кодировки и сопоставления в выводе с однострочным блокомvalues:, который их породил). - Строковый канал. Сущность Component каталога для Adminer объявляет uses-сокет
databases, принимающий любой компонент с меткойcomponent.aggrega.ai/type=stateful-server. Ребро сущности Aggregate внедряетprovides.hostиз сущности Recipe базы данных вADMINER_DEFAULT_SERVER. Компилятор передаёт строку, не интерпретируя её: на этой цели это имя сервиса compose; то же ребро на цели Kubernetes передавало бы DNS-имя Service. - Опора вложений. Схема
featuresSchemaсущности Component базы данных требует слотroot_password, заполняемый сущностью Featurecore/secret-valueиз каталога. Слот является чёрным ящиком: доставкой управляет сущность FeatureRecipe, выбранная в Manifest, и разработчик не может её диктовать. - Маршрутизация Recipe с уточнением по Provider. Manifest сопоставляет
core/datastore/mariadb:1.0.0сcompose/mariadb:1.0.0— с уточнением по провайдеру, — потому что стандартная библиотека поставляет Recipe для mariadb у нескольких провайдеров (в том числе compose и helm). Именно сопоставление оператора устраняет неоднозначность цели: голая неуточнённая ссылка, совпадающая с Recipe нескольких провайдеров, явно останавливает сборку, а не выбирает одну молча. Чтобы перенацелить стек, перенаправьте эти сопоставления; сущность Aggregate не меняется.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example catalog-onlyЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd catalog-onlyСборка
Из этой директории, с сущностями каталога, разрешаемыми из hub.aggrega.ai, реестра по умолчанию, который указывает .aggrega-config.yaml:
aggrega pull --release release.yamlaggrega build --release release.yamlPull разрешает каждую упомянутую сущность и фиксирует её в release.lock (идентичность + дайджест содержимого; чтобы пересоздать устаревший lock-файл, запустите pull снова). При наличии рабочей копии каталога стандартной библиотеки (где её взять) укажите её директорию aggrega-catalog через --catalog в обеих командах, чтобы читать сущности оттуда. Сборка читает этот lock-файл — без него сборка останавливается и называет два пути вперёд: pull или --auto-pull, — и формирует dist/compose/docker-compose.yaml. Сущность Release задаёт свои компоненты напрямую (без блока boundaries:), поэтому компилятор включает их в синтезированную область по умолчанию и выводит всё плоско в dist/ — одна граница, без сегмента с именем границы в пути.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки сами. Если в папке рабочего пространства ещё нет папки `catalog-only`, вызовите один раз инструмент `scaffold`, задав для `example` значение `catalog-only` и не задавая `dir`: он запишет пример в новую папку `catalog-only`. Затем вызовите инструмент `build`, задав для `workspace_root` значение `catalog-only`, для `release` — `release.yaml`, для `auto_pull` — true и для `write` — true. Сообщите мне, какие файлы записала сборка; они находятся в `catalog-only/dist/`.Чтение вывода
Связи становятся видны в сформированном файле compose:
- сервис
webсодержитADMINER_DEFAULT_SERVER: db—provides.hostсущности Recipe базы данных (имя сервиса compose), доставленный через ребро uses; - то же ребро породило
depends_on: [db]— топологию, а не только строки; MARIADB_CHARACTER_SET_SERVERиMARIADB_COLLATION_SERVERсервисаdbберутся из значений по умолчанию схемы, которые сущность Aggregate нигде не упоминает;image: mariadb:11.4и привязка порта8080:8080берутся из блоковinfra:сущности Release — опоры оператора, сформированной рядом с опорой разработчика.
Запуск
cd dist/composedocker compose up -dОткройте http://localhost:8080: поле сервера заранее заполнено значением db.
Войдите как root с паролем для разработки из вложения сущности Aggregate
(dev-root-pw-change-me — заполнитель, который нужно заменить
везде, кроме локальной разработки), база данных appdb.
Что дальше
На уровне написания вы сами создаёте этот же слой платформы — сущности Components, Recipes и FeatureRecipes для учётных данных, которые этот пример использовал в готовом виде, — и компилируете одну сущность Aggregate для четырёх целей.