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

Только каталог — 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, заполняемый сущностью Feature core/secret-value из каталога. Слот является чёрным ящиком: доставкой управляет сущность FeatureRecipe, выбранная в Manifest, и разработчик не может её диктовать.
  • Маршрутизация Recipe с уточнением по Provider. Manifest сопоставляет core/datastore/mariadb:1.0.0 с compose/mariadb:1.0.0 — с уточнением по провайдеру, — потому что стандартная библиотека поставляет Recipe для mariadb у нескольких провайдеров (в том числе compose и helm). Именно сопоставление оператора устраняет неоднозначность цели: голая неуточнённая ссылка, совпадающая с Recipe нескольких провайдеров, явно останавливает сборку, а не выбирает одну молча. Чтобы перенацелить стек, перенаправьте эти сопоставления; сущность Aggregate не меняется.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example catalog-only

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd catalog-only

Сборка

Из этой директории, с сущностями каталога, разрешаемыми из hub.aggrega.ai, реестра по умолчанию, который указывает .aggrega-config.yaml:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Pull разрешает каждую упомянутую сущность и фиксирует её в 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 — опоры оператора, сформированной рядом с опорой разработчика.

Запуск

Terminal window
cd dist/compose
docker compose up -d

Откройте http://localhost:8080: поле сервера заранее заполнено значением db. Войдите как root с паролем для разработки из вложения сущности Aggregate (dev-root-pw-change-me — заполнитель, который нужно заменить везде, кроме локальной разработки), база данных appdb.

Что дальше

На уровне написания вы сами создаёте этот же слой платформы — сущности Components, Recipes и FeatureRecipes для учётных данных, которые этот пример использовал в готовом виде, — и компилируете одну сущность Aggregate для четырёх целей.