Довідковий покажчик Provider
Кожен із провайдерів стандартної бібліотеки Aggrega приймає власну підмножину трьох видів вхідних даних Recipe (sourced, synthesized, artifacts). Канонічна матриця можливостей міститься в ../../architecture/16-recipe-input-composition.md у розділі «Provider Capability Matrix». Прочитайте цей розділ, щоб побачити авторитетну таблицю, а текст про кожного провайдера під нею — щоб дізнатися, які комбінації видів вхідних даних приймає кожен провайдер: таблиця описує кожен вид окремо й не може показати, що два з них можна оголосити разом.
Ця сторінка — дороговказ. Вона описує, що створює кожен провайдер стандартної бібліотеки, і спрямовує вас на сторінку, присвячену йому; які види вхідних даних приймає провайдер і в яких комбінаціях, пояснюють розділи, посилання на які наведено вище.
Провайдери стандартної бібліотеки
helm— створює пласкі маніфести Kubernetes. Див. helm.md.helm-chart— пакує компоненти межі в один парасольковий чарт Helm. Див. helm-chart.md.compose— створює сервіси Docker Compose, об’єднані в один compose-файл для кожної межі. Див. compose.md.terraform— створює конфігурацію Terraform. Він генерує конфігурацію й ніколи не запускає Terraform. Див. terraform.md.cloudformation— створює шаблони стеків CloudFormation, по одному на кожну межу. Він генерує конфігурацію й ніколи не запускає CloudFormation. Див. cloudformation.md.
Що робить syncWave межі в кожному провайдері
Значення syncWave: межі сутності Release зчитує кожен провайдер стандартної бібліотеки, а що саме воно впорядковує і в яких термінах — залежить від провайдера; у helm-chart воно впорядковує лише ресурси, що несуть його анотацію:
| Provider | Що робить хвиля |
|---|---|
helm | Упорядковує ресурси, які застосовує контролер GitOps або Helm. Якщо хвиля не дорівнює 0, кожен згенерований ресурс має argocd.argoproj.io/sync-wave, а ресурс-хук, створений шаблоном чарту, додатково має helm.sh/hook-weight. |
helm-chart | Упорядковує ресурси, що несуть анотацію. Шаблони вихідного чарту копіюються так, як їх написав автор, тож вони мають argocd.argoproj.io/sync-wave лише там, де її записує чарт; артефакт, завантажений через $import:, який додає провайдер, має її, але не має helm.sh/hook-weight — див. helm-chart.md. |
compose | Упорядковує сервіси всередині compose-файлу, у який генерується межа, через depends_on між ними, а також додатково записує значення в кожен згенерований сервіс як мітку aggrega.ai/sync-wave. Упорядкування між двома compose-файлами виразити неможливо — див. compose.md. |
terraform | Упорядковує блоки module кореневої конфігурації, у яку збирається межа, через depends_on між ними. Це порядок, у якому Terraform виконує свої дії, а не готовність — конфігурація не має поняття про те, що ресурс готовий до роботи, — і порядок видалення не гарантується. Упорядкування між двома кореневими конфігураціями виразити неможливо, а значення також записується разом із походженням збірки вузла — див. terraform.md. |
cloudformation | Упорядковує створення стеку, у який збирається межа, через DependsOn між ресурсами. Це порядок створення, а у зворотному напрямку — порядок видалення, а не готовність — шаблон стеку не має поняття про те, що ресурс готовий до роботи. Упорядкування між двома стеками виразити неможливо — див. cloudformation.md. |
Як задати syncWave: для окремої межі, описано на сторінці сутності Release; точні мітки й анотації, які генерує кожен провайдер, наведено в well-known-annotations.md.
Де що шукати
| Якщо ви хочете дізнатися… | Дивіться |
|---|---|
| Який провайдер підтримує який вид вхідних даних | Розділ Provider Capability Matrix у ../../architecture/16-recipe-input-composition.md |
| Які комбінації видів вхідних даних приймає провайдер і що виводиться в разі відмови | ../../architecture/16-recipe-input-composition.md «Що саме приймає кожен провайдер» |
| Як гніздо плагіна провайдера отримує вхідні дані й повертає результат | architecture.md |
| Форма написання для кожного провайдера (структура чарту, ключі верхнього рівня compose, тіла Terraform, фрагменти CloudFormation) | Відповідна сторінка провайдера (helm.md, helm-chart.md, compose.md, terraform.md, cloudformation.md) |
| Які анотації межі використовує кожен провайдер і їхні значення за замовчуванням | well-known-annotations.md |
Що робить syncWave межі в кожному провайдері | Таблиця вище |
| Чи повідомляє провайдер ім’я, яке дає згенерованим ресурсам, і що читати, якщо ні | ../templates/rendered-resource-names.md |
| Можливості написання для виду Workload | ../entities/workload.md |
| Концептуальна модель композиції трьох видів вхідних даних | ../../architecture/16-recipe-input-composition.md |