Importazione da libreria di Workload — un corpo di Workload condiviso tramite `$import`
Un singolo servizio web stateless la cui Recipe sintetizza il proprio Workload Kubernetes da una voce di libreria condivisa invece che da un corpo inline. Questa è la terza modalità di authoring di spec.workload su una Recipe:
- Modalità 1 (inline): un Workload in template Go scritto direttamente nella Recipe.
- Modalità 2 (importazione da file):
$import: ./relative/path.yaml— un file locale. - Modalità 3 (importazione da libreria):
$import: <Library>#/workloads/<Entry>— una voce diWorkloadLibraryreferenziata tramite un’identità a nome semplice.
La Recipe web-service qui usa la Modalità 3:
spec: capability: helm implements: example/compute/web-service workload: $import: BaseWorkloads#/workloads/StatelessServiceScrivi il riferimento come un unico token ininterrotto: nessuno spazio e nessuna interruzione di riga in alcun punto, dal nome della libreria fino al frammento. Un riferimento che contiene spazi bianchi viene rifiutato anziché ripulito, e la build si arresta — vedi errors/fatal-halts.md «A reference to a library entry carries whitespace (Un riferimento a una voce di libreria contiene spazi bianchi)».
BaseWorkloads è una WorkloadLibrary pubblicata nel catalogo dell’hub (workloadlibrary/base-workloads). La sua voce StatelessService è un template Go valutato nel contesto di rendering di questa Recipe, quindi .values.image (dal Component/Aggregate) e .infra.* (repliche, porta, compute — dalla Release) vi confluiscono esattamente come farebbero in un corpo inline. Fattorizzare il Workload in una libreria non cambia nulla di ciò che viene distribuito: l’output renderizzato è identico byte per byte al Workload inline equivalente.
La versione della libreria è fornita dal lockfile per Release — nessun host di registry compare nel riferimento. Con aggrega pull, BaseWorkloads viene fissata nella sezione workload_libraries del lockfile; con aggrega build, la libreria fissata viene risolta e la sua voce renderizzata.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example workload-library-importPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd workload-library-importBuild
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlIl catalogo viene risolto dal registry dell’hub indicato in .aggrega-config.yaml (che fornisce BaseWorkloads e il provider helm) più il catalog/ locale di questo esempio (il Component e la Recipe web-service). I Manifests finiscono in dist/app/helm/ — la directory: del confine seguita dalla capacità del provider.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `workload-library-import`, chiama una volta lo strumento `scaffold` con `example` impostato su `workload-library-import` e senza `dir`: scrive l’esempio in una nuova cartella `workload-library-import`. Poi chiama lo strumento `build` con `workspace_root` impostato su `workload-library-import`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano sotto `workload-library-import/dist/`.Verificare l’affermazione di identità byte per byte
Sostituisci il workload: { $import: … } della Recipe con un blocco workload: | che contenga alla lettera il corpo di StatelessService, esegui di nuovo la build e confronta con diff i due alberi dist/. Coincidono esattamente: il riferimento alla libreria si risolve nello stesso testo di template, valutato nello stesso contesto di rendering, quindi l’importazione è una fattorizzazione della superficie di authoring senza alcun effetto sui byte renderizzati.