Перевизначення рецепта для окремого екземпляра
Цей приклад демонструє одну можливість 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, слід однозначно визначити
зіставленням; якщо його не зіставлено, збірка зупиняється й називає кандидатів, а не
вгадує.