Build
Quando uma definição de template estiver pronta, useTemplate.build(...) para criá-la. O build aceita um nome de template mais configurações opcionais de build, como CPU, memória, tags, comportamento de cache e um callback de log de build.
Template.buildInBackground(...) / Template.build_in_background(...) e inspecione o status do build posteriormente.
Nomes
Todo build precisa de um nome de template. Mantenha os nomes estáveis para uma família lógica de templates, por exemplo:my-python-templateagent-runtime-basesandbox-webapp
Tags e versionamento
Tags permitem rotular builds para gerenciamento de releases sem alterar o nome do template subjacente. Padrões comuns incluem:- versões semânticas, como
v1.0.0 - rótulos de promoção, como
stagingouproduction - canais móveis, como
latest
Logs
Os logs de build ajudam você a inspecionar o progresso de provisionamento e diagnosticar falhas. Em JavaScript e TypeScript, passeonBuildLogs para Template.build(...). O SDK também exporta defaultBuildLogger(...) para um logger de console padrão.
Template.getBuildStatus(...) / Template.get_build_status(...) para consultar o status e recuperar entradas de log posteriormente.
Tratamento de erros
Builds de template podem falhar por vários motivos comuns:- credenciais inválidas para um registry privado
- falhas de instalação de pacotes dentro de
runCmd(...)/run_cmd(...) - um comando de inicialização que encerra inesperadamente
- um comando de prontidão que nunca é bem-sucedido
- configurações de CPU e memória que não atendem aos limites da plataforma
- inspecione primeiro os logs de build
- valide a imagem de origem do template ou Dockerfile
- execute novamente com o cache desabilitado se você suspeitar de uma camada desatualizada
- reduza o template à menor sequência de instruções que falha
building, waiting, ready e error.