Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

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ída docker-compose.yaml por 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.