Справочный указатель сущностей 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 «What each provider accepts, in full» |
| Как сокет плагина провайдера получает входные данные и возвращает результат | 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 |