Переопределение рецепта для отдельного экземпляра
Этот пример демонстрирует одну возможность Manifest: уровень сопоставления name, который
переопределяет Recipe для одного экземпляра компонента, тогда как все остальные
экземпляры того же типа сохраняют общий Recipe уровня type.
Что он показывает
Aggregate объявляет два экземпляра одного типа компонента (example/compute/greeter):
components: greeter-default: type: example/compute/greeter greeter-special: type: example/compute/greeterКаталог содержит два Recipes, каждый из которых реализует example/compute/greeter, — greeter-blue
(сборка по умолчанию) и greeter-green (альтернативная сборка). Manifest сопоставляет
тип целиком и переопределяет один экземпляр по имени:
mappings: components: type: example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 # every greeter instance... name: greeter-special: compose/greeter-green:1.0.0 # ...except this oneИмя имеет приоритет над типом, поэтому greeter-special развёртывается через greeter-green, а
greeter-default — через greeter-blue.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example per-instance-recipe-overrideЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd per-instance-recipe-overrideСборка
aggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlЭтот пример использует стандартную библиотеку в качестве провайдера: провайдер compose поставляется в стандартном каталоге. Собственные учебные сущности примера — демонстрационный компонент example/compute/greeter и два его рецепта (greeter-blue / greeter-green), которые существуют исключительно для того, чтобы сделать переопределение для экземпляра наглядным, — находятся в общем каталоге у издателя example/, рядом с сущностями стандартной библиотеки. .aggrega-config.yaml объявляет hub.aggrega.ai реестром по умолчанию, поэтому сущности разрешаются из хаба, и команде сборки не нужен флаг --catalog.
Сгенерированный dist/app/compose/docker-compose.yaml показывает срабатывание переопределения:
greeter-default запускает image: greeter:blue, greeter-special запускает
image: greeter:green, а метка происхождения aggrega.ai/recipe-uri каждого сервиса
указывает отдельный Recipe, к которому он был разрешён.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке Workspace ещё нет папки `per-instance-recipe-override`, вызовите один раз инструмент `scaffold`, задав для `example` значение `per-instance-recipe-override` и не задавая `dir`: он запишет пример в новую папку `per-instance-recipe-override`. Затем вызовите инструмент `build`, задав для `workspace_root` значение `per-instance-recipe-override`, для `release` — `release.yaml`, для `auto_pull` — true и для `write` — true. Сообщите мне, какие файлы записала сборка; они находятся в `per-instance-recipe-override/dist/`.Чем это полезно
Двум экземплярам одного типа компонента иногда нужны разные физические
реализации — например, основная база данных на управляемом облачном Recipe, тогда как
её реплики используют Recipe внутри кластера. Уровень name выражает это для каждого
экземпляра в Manifest, без ответвления типа компонента и без дублирования
Aggregate. Тип, который реализует более одного Recipe, должен быть однозначно определён
сопоставлением; если сопоставления нет, сборка останавливается и называет кандидатов, а не
угадывает.