Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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 di WorkloadLibrary referenziata 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/StatelessService

Scrivi 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:

Terminal window
aggrega scaffold --example workload-library-import

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd workload-library-import

Build

Terminal window
aggrega pull --release release.yaml # pins BaseWorkloads in release.lock
aggrega build --release release.yaml

Il 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.