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