Огляд 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.