Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Обзор Providers

Провайдер преобразует входные виды сущности Recipe в нативные для провайдера файлы манифестов. Рендеринг Provider выполняет сущность Plugin с pluginType: provider: Plugin перечисляет имена провайдеров, которые он рендерит, в spec.provider.capabilities и хранит метаданные сокета провайдера в том же блоке spec.provider. Стандартная библиотека Aggrega поставляет пять провайдеров — helm, helm-chart, compose, terraform, cloudformation, — и каждый из них объявляет собственный контракт: какие входные виды он принимает, какие выходные файлы создаёт, какие аннотации границ использует и как вид Workload преобразуется в его нативную форму, когда используется синтезированный входной вид. Этот набор глав описывает эти контракты с точки зрения автора сущности Recipe.

Глава состоит из двух частей. Архитектура и общие контракты описывают то, что объединяет все провайдеры, — архитектуру сокетов плагинов, связывающую компилятор на Go с плагином провайдера на Wasm, аннотации границ, которые читает каждый провайдер для настройки размещения и сетевого взаимодействия, и указатель, направляющий на нужную страницу отдельного провайдера. Справочники по провайдерам описывают частности: особенности написания для каждого провайдера, структуру выходного каталога каждого провайдера и семантику преобразования механизмов Workload и артефактов для каждого провайдера. На вопрос, какой провайдер принимает какой входной вид, отвечает матрица возможностей в ../architecture/16-recipe-input-composition.md, которая является авторитетной таблицей.

Архитектура и общие контракты

  • Архитектура Provider — архитектура сокетов плагинов, роль сущности Plugin, выполняющей рендеринг провайдера, в конвейере компиляции и диспетчеризация по провайдерам.
  • Общеизвестные аннотации — зарезервированные платформой аннотации границ aggrega.ai/, которые провайдеры используют для метаданных размещения, префиксов реестров, сетевого взаимодействия, безопасности и упаковки.
  • Указатель справочника Provider — что создаёт каждый провайдер стандартной библиотеки и на какой странице дан ответ на какой вопрос. О том, какие входные виды принимает провайдер, см. матрицу возможностей в ../architecture/16-recipe-input-composition.md.

Справочник по провайдерам

  • helm — основной провайдер Kubernetes. Рендеринг с помощью Helm SDK в режиме с источником.
  • helm-chart — провайдер композиции зонтичных чартов. Упаковывает несколько компонентов в один чарт Helm для каждой границы.
  • compose — провайдер Docker Compose. Вывод docker-compose.yaml для каждой границы.
  • terraform — провайдер Terraform. Одна корневая конфигурация на границу, где каждый компонент — блок module, ссылающийся на собственный подкаталог этого компонента.
  • cloudformation — провайдер CloudFormation. Один шаблон стека на границу в формате чистого JSON.