Перейти к содержимому
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 «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