Visão geral dos Providers
Um fornecedor renderiza os tipos de entrada de uma Recipe em ficheiros de manifesto nativos do fornecedor. A renderização de Provider é servida por um Plugin com pluginType: provider: o Plugin lista o(s) nome(s) de fornecedor que renderiza em spec.provider.capabilities e transporta os metadados do socket de fornecedor nesse mesmo bloco spec.provider. A biblioteca padrão do Aggrega inclui cinco fornecedores — helm, helm-chart, compose, terraform, cloudformation — e cada um declara o seu próprio contrato: que tipos de entrada aceita, que ficheiros de saída emite, que anotações de fronteira consome e como o tipo Workload se traduz na sua forma nativa quando é usado o tipo de entrada sintetizado. Este conjunto de capítulos cobre esses contratos da perspetiva do autor da Recipe.
O capítulo organiza-se em dois grupos. Arquitetura e contratos partilhados abrange o que todos os providers têm em comum — a arquitetura de sockets de plugins que liga o compilador Go ao plugin de provider Wasm, as anotações de fronteira que todos os providers leem para configurar o posicionamento e a rede, e um índice que encaminha para a página certa de cada provider. Referências por provider abrange as especificidades: particularidades de autoria 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 de Workload e de artefactos. A pergunta sobre que provider aceita que tipo de entrada é respondida pela matriz de capacidades em ../architecture/16-recipe-input-composition.md, que é a grelha autoritativa.
Arquitetura e contratos partilhados
- Arquitetura de Provider — a arquitetura de sockets de plugins, o papel do Plugin de renderização de provider 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 registo, rede, segurança e metadados de empacotamento. - Índice de referência de Provider — o que cada provider da biblioteca padrão produz e que página responde a que pergunta. Para saber que tipos de entrada um provider aceita, consulte a matriz de capacidades em ../architecture/16-recipe-input-composition.md.
Referência por provider
helm— o provider Kubernetes principal. Renderização com o SDK do Helm em modo sourced.helm-chart— o provider de composição em umbrella chart. Empacota vários componentes num único chart Helm por fronteira.compose— o provider Docker Compose. Saídadocker-compose.yamlpor fronteira.terraform— o provider Terraform. Uma configuração raiz por fronteira, sendo cada componente um bloco de módulo que usa como source o subdiretório próprio desse componente.cloudformation— o provider CloudFormation. Um template de stack por fronteira, emitido em JSON puro.