Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

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 de WorkloadLibrary referenciada 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/StatelessService

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

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

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd workload-library-import

Compilação

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

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