Importação de biblioteca de Workload — um corpo de Workload compartilhado por meio de `$import`
Um único serviço web sem estado cuja Recipe sintetiza o seu Workload do Kubernetes a partir de uma entrada de biblioteca compartilhada em vez de um corpo inline. Este é o terceiro modo de autoria de spec.workload em uma Recipe:
- Modo 1 (inline): um Workload em template Go escrito diretamente na Recipe.
- Modo 2 (importação de arquivo):
$import: ./relative/path.yaml— um arquivo local. - Modo 3 (importação de biblioteca):
$import: <Library>#/workloads/<Entry>— uma entrada deWorkloadLibraryreferenciada por uma identidade de nome simples.
A Recipe web-service aqui usa 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 qualquer ponto, do nome da biblioteca até o fragmento. Uma referência que contém espaços em branco é recusada em vez de aparada, e o build é interrompido — veja 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, então .values.image (do Component/Aggregate) e .infra.* (réplicas, porta, computação — da Release) fluem para ela exatamente como fluiriam para um corpo inline. Fatorar o Workload em uma biblioteca não muda nada no que é implantado: a saída renderizada é idêntica byte a byte ao Workload inline equivalente.
A versão da biblioteca é fornecida pelo arquivo de bloqueio de cada Release — nenhum host de registro aparece na referência. No aggrega pull, BaseWorkloads é fixada na seção workload_libraries do arquivo de bloqueio; no aggrega build, a biblioteca fixada é resolvida e a sua entrada renderizada.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example workload-library-importEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd workload-library-importBuild
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlO catálogo é resolvido a partir do registro do hub nomeado em .aggrega-config.yaml (que fornece BaseWorkloads e o provedor 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 provedor.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use somente as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta do espaço 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`: ela grava o exemplo em uma 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. Diga-me quais arquivos o build gravou; eles ficam 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, refaça o build e compare com diff as duas árvores dist/. Elas coincidem exatamente: a referência à biblioteca se resolve no mesmo texto de template, avaliado no mesmo contexto de renderização, então a importação é uma fatoração da superfície de autoria sem nenhum efeito nos bytes renderizados.