Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Довідковий покажчик 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