Importação de biblioteca de Workload — um corpo de Workload partilhado através de `$import`
Um único serviço web sem estado cuja Recipe sintetiza o seu Workload do Kubernetes a partir de uma entrada de biblioteca partilhada em vez de um corpo inline. Este é o terceiro modo de autoria de spec.workload numa Recipe:
- Modo 1 (inline): um Workload em template Go escrito diretamente na Recipe.
- Modo 2 (importação de ficheiro):
$import: ./relative/path.yaml— um ficheiro local. - Modo 3 (importação de biblioteca):
$import: <Library>#/workloads/<Entry>— uma entrada deWorkloadLibraryreferenciada por uma identidade de nome simples.
A Recipe web-service usa aqui o modo 3:
spec: capability: helm implements: example/compute/web-service workload: $import: BaseWorkloads#/workloads/StatelessServiceEscreva a referência como um único token ininterrupto: nenhum espaço e nenhuma quebra de linha em ponto algum, do nome da biblioteca até ao fragmento. Uma referência que contenha espaços em branco é recusada em vez de aparada, e a compilação é interrompida — consulte errors/fatal-halts.md «A reference to a library entry carries whitespace (Uma referência a uma entrada de biblioteca contém espaços em branco)».
BaseWorkloads é uma WorkloadLibrary publicada no catálogo do hub (workloadlibrary/base-workloads). A sua entrada StatelessService é um template Go avaliado no contexto de renderização desta Recipe, pelo que .values.image (do Component/Aggregate) e .infra.* (réplicas, porta, computação — da Release) fluem para ela exatamente como fluiriam para um corpo inline. Fatorizar o Workload numa biblioteca não muda nada no que é implementado: a saída renderizada é idêntica byte a byte ao Workload inline equivalente.
A versão da biblioteca é fornecida pelo ficheiro de bloqueio de cada Release — nenhum anfitrião de registo aparece na referência. No aggrega pull, BaseWorkloads é fixada na secção workload_libraries do ficheiro de bloqueio; no aggrega build, a biblioteca fixada é resolvida e a sua entrada renderizada.
Gerar o exemplo
É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.
Escreva o exemplo numa nova pasta com o nome dele:
aggrega scaffold --example workload-library-importDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd workload-library-importCompilação
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlO catálogo é resolvido a partir do registo do hub indicado em .aggrega-config.yaml (que fornece BaseWorkloads e o fornecedor helm) mais o catalog/ local deste exemplo (o Component e a Recipe web-service). Os Manifests ficam em dist/app/helm/ — o directory: da fronteira seguido da capacidade do fornecedor.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.
Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa própria. Se a pasta da área de trabalho ainda não contiver uma pasta `workload-library-import`, chame uma vez a ferramenta `scaffold` com `example` definido como `workload-library-import` e sem `dir`: esta escreve o exemplo numa nova pasta `workload-library-import`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `workload-library-import`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Indique-me que ficheiros a compilação escreveu; encontram-se em `workload-library-import/dist/`.Verificar a afirmação de identidade byte a byte
Substitua o workload: { $import: … } da Recipe por um bloco workload: | que contenha literalmente o corpo de StatelessService, volte a compilar e compare com diff as duas árvores dist/. Coincidem exatamente: a referência à biblioteca resolve-se no mesmo texto de template, avaliado no mesmo contexto de renderização, pelo que a importação é uma fatorização da superfície de autoria sem qualquer efeito nos bytes renderizados.