Лише каталог — 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 для чотирьох цілей.