Visão geral dos Providers
Um provider renderiza os tipos de entrada de uma Recipe em arquivos manifest nativos do provider. A renderização Provider é fornecida por um Plugin com pluginType: provider: o Plugin lista o nome ou os nomes de provider que renderiza em spec.provider.capabilities e traz seus metadados de provider-socket nesse mesmo bloco spec.provider. A biblioteca padrão do Aggrega inclui cinco providers — helm, helm-chart, compose, terraform, cloudformation — e cada um declara seu próprio contrato: quais tipos de entrada aceita, quais arquivos de saída emite, quais anotações de boundary consome e como o tipo Workload se traduz em sua forma nativa quando o tipo de entrada sintetizado é usado. Este conjunto de capítulos aborda esses contratos do ponto de vista do autor de Recipes.
O capítulo se organiza em dois grupos. Arquitetura e contratos compartilhados aborda o que todos os providers têm em comum — a arquitetura de sockets de plugin que liga o compilador Go ao plugin de provider Wasm, as anotações de fronteira que cada provider lê para configurar posicionamento e rede, e um índice que direciona você à página certa de cada provider. Referências por provider abordam os detalhes: as particularidades de escrita de cada provider, a estrutura do diretório de saída de cada provider e a semântica de tradução de cada provider para os mecanismos Workload e artifacts. Qual provider aceita qual tipo de entrada é respondido pela matriz de capacidades em ../architecture/16-recipe-input-composition.md, que é a tabela de referência.
Arquitetura e contratos compartilhados
- Arquitetura do Provider — a arquitetura plugin-socket, o papel do Plugin de renderização de providers no pipeline de compilação e o despacho por provider.
- Anotações conhecidas — as anotações de fronteira
aggrega.ai/reservadas pela plataforma que os providers consomem para posicionamento, prefixos de registry, rede, segurança e metadados de empacotamento. - Índice de referência do Provider — o que cada provider da biblioteca padrão produz e qual página responde a qual pergunta. Para saber quais tipos de entrada um provider aceita, leia a matriz de capacidades em ../architecture/16-recipe-input-composition.md.
Referência por provider
helm— o provider principal do Kubernetes. Renderização com o SDK do Helm no modo sourced.helm-chart— o provider de composição em umbrella chart. Empacota vários componentes em um único chart Helm por fronteira.compose— o provider do Docker Compose. Saídadocker-compose.yamlpor fronteira.terraform— o provider do Terraform. Uma configuração raiz por fronteira, em que cada componente é um bloco module que usa como fonte o subdiretório próprio desse componente.cloudformation— o provider do CloudFormation. Um template de stack por fronteira, emitido como JSON puro.