Panoramica dei Providers
Un provider esegue il rendering dei tipi di input di una Recipe in file manifest nativi del provider. Il rendering del Provider è servito da un Plugin con pluginType: provider: il Plugin elenca il nome o i nomi dei provider di cui esegue il rendering in spec.provider.capabilities e porta i metadati del provider-socket nello stesso blocco spec.provider. La libreria standard di Aggrega include cinque provider — helm, helm-chart, compose, terraform, cloudformation — e ciascuno dichiara il proprio contratto: quali tipi di input accetta, quali file di output emette, quali annotazioni di boundary consuma e come il tipo Workload si traduce nella sua forma nativa quando si usa il tipo di input sintetizzato. Questo insieme di capitoli tratta tali contratti dal punto di vista dell’autore di Recipe.
Il capitolo si organizza in due gruppi. Architettura e contratti condivisi tratta ciò che tutti i provider hanno in comune: l’architettura a socket di plugin che collega il compilatore Go al plugin provider Wasm, le annotazioni di confine che ogni provider legge per configurare posizionamento e rete, e un indice che ti indirizza alla pagina giusta per ciascun provider. Riferimenti per provider tratta gli aspetti specifici: le particolarità di authoring di ciascun provider, la struttura della directory di output di ciascun provider e la semantica di traduzione di ciascun provider per i meccanismi Workload e artifacts. Quale provider accetta quale tipo di input lo indica la matrice delle capability in ../architecture/16-recipe-input-composition.md, che è la griglia autorevole.
Architettura e contratti condivisi
- Architettura del Provider — l’architettura plugin-socket, il ruolo del Plugin di rendering dei provider nella pipeline di compilazione e il dispatch per provider.
- Annotazioni ben note — le annotazioni di confine
aggrega.ai/riservate alla piattaforma che i provider consumano per posizionamento, prefissi di registry, rete, sicurezza e metadati di packaging. - Indice di riferimento dei Provider — cosa produce ciascun provider della libreria standard e quale pagina risponde a quale domanda. Per sapere quali tipi di input accetta un provider, leggi la matrice delle capability in ../architecture/16-recipe-input-composition.md.
Riferimento per provider
helm— il provider Kubernetes principale. Rendering con l’SDK di Helm in modalità sourced.helm-chart— il provider di composizione in umbrella chart. Impacchetta più componenti in un unico chart Helm per confine.compose— il provider Docker Compose. Outputdocker-compose.yamlper confine.terraform— il provider Terraform. Una configurazione radice per confine, in cui ogni componente è un blocco module che punta alla sotto-directory propria di quel componente.cloudformation— il provider CloudFormation. Un template di stack per confine, emesso come JSON puro.