Fazer deploy ↗
docs

Builds

Histórico, logs e diagnóstico de builds. Cada deploy gera um build com SHA do commit, duração e status.

Toda vez que você faz deploy — manualmente, por push do GitHub ou via API — a Veloz cria um build. Builds têm ID, status, trigger (o que originou), commit, logs e duração.

Listar builds

veloz builds list                # últimos 10 builds do serviço atual
veloz builds list --limit 20     # últimos 20
veloz builds list --service api  # builds de um serviço específico

Mostra:

  • ID parcial do build
  • Status (na fila, compilando, ativo, falhou, cancelado)
  • Duração
  • Trigger (push, config, redeploy, rollback, cli)
  • Branch e mensagem do commit

Ver detalhes de um build

veloz builds show <id>

Retorna SHA do commit, autor, mensagem, branch, imagem gerada, motivo da falha (se houver) e timestamps de cada fase.

Logs de build

veloz builds logs <id>           # logs formatados (steps do Dockerfile)
veloz builds logs <id> --raw     # logs brutos do BuildKit

A formatação parseia steps do Dockerfile, mostra cache hits e duração de cada camada — útil para identificar onde o build está demorando.

Em monorepos, passe --service <nome> ou copie o ID exato de veloz builds list.

Triggers de build

Trigger Quando acontece
push Push do GitHub na branch configurada
cli veloz deploy no terminal
config Mudança de configuração que requer rebuild (ex: variável de ambiente que afeta build, mudança de start command)
redeploy Você clicou "Redeploy" no dashboard ou rodou veloz deploy sem mudanças
rollback Você reverteu para uma versão anterior

Rollback

No dashboard, em Builds → escolha um build verde anterior → Rollback. A versão anterior é promovida sem precisar recompilar.

Pela CLI: liste os builds, escolha o ID e use a UI do dashboard para o rollback (essa operação ainda é exclusiva do dashboard).

Cache de build

A Veloz mantém cache de camadas Docker entre builds para acelerar deploys. Você não precisa configurar — funciona automaticamente.

Se um build está usando cache antigo de forma indesejada, você pode forçar build limpo no dashboard com Build sem cache.

Build minutes

Cada minuto de build é cobrado. O plano Vibe inclui crédito mensal — builds curtos rotineiros raramente passam disso. Se você está em build muito lento (>5min), vale otimizar:

  • Use cache de dependências (lockfile bem estável)
  • Evite reinstalar pacotes do sistema desnecessariamente
  • Em monorepos, configure --app para fazer deploy só do que mudou

→ Pacotes do sistema · Best practices

Próximos passos