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

Переопределение рецепта для отдельного экземпляра

Этот пример демонстрирует одну возможность 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.

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

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

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

Terminal window
aggrega scaffold --example per-instance-recipe-override

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

Terminal window
cd per-instance-recipe-override

Сборка

Terminal window
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega 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, должен быть однозначно определён сопоставлением; если сопоставления нет, сборка останавливается и называет кандидатов, а не угадывает.