Logs de Build

Os logs de build mostram a saida completa do processo de construcao da imagem de container da sua aplicacao. Voce pode acompanha-los em tempo real ou consulta-los apos a conclusao do build.

Visualizando logs em tempo real

Durante um build ativo, os logs sao transmitidos em tempo real no dashboard:

1. Acesse a pagina do servico
2. Va ate a aba Deployments
3. Clique no deployment que esta em andamento
4. Os logs aparecem automaticamente e atualizam em tempo real

O visualizador de logs rola automaticamente para acompanhar as novas linhas. Voce pode pausar a rolagem automatica para analisar uma parte especifica.

Etapas do build

Os logs de build mostram tres fases principais:

1. Download do codigo — o Guara Cloud baixa o codigo-fonte do seu repositorio no commit especifico
2. Build da imagem — a imagem de container e construida a partir do seu codigo, instalando dependencias e compilando a aplicacao
3. Push da imagem — a imagem construida e armazenada para uso no deploy

Depurando builds com falha

Quando um build falha, os logs sao a principal ferramenta para identificar o problema. Aqui estao os erros mais comuns e como resolve-los:

“Cannot find module” ou “Module not found”

Causa: Uma dependencia esta faltando ou o caminho de importacao esta incorreto.

Solucao:

• Verifique se todas as dependencias estao listadas no package.json (Node.js) ou no arquivo equivalente da sua linguagem
• Certifique-se de que o arquivo importado existe e o caminho esta correto
• Execute npm install ou yarn install localmente para confirmar que funciona

”Port already in use” ou erro de porta

Causa: A aplicacao nao esta usando a porta configurada no servico.

Solucao:

• Configure sua aplicacao para usar a variavel de ambiente PORT
• Verifique se a porta configurada no servico corresponde a porta que sua aplicacao escuta
• Na maioria dos frameworks, use process.env.PORT (Node.js) ou equivalente

”Build timeout”

Causa: O build excedeu o tempo limite de 15 minutos.

Solucao:

• Otimize o Dockerfile para usar cache de camadas de forma eficiente
• Use um arquivo .dockerignore para excluir arquivos desnecessarios (como node_modules, .git)
• Considere fazer upgrade do seu plano para ter mais recursos de build

”Out of memory” ou “Killed”

Causa: O build consumiu mais memoria do que o permitido.

Solucao:

• Reduza o uso de memoria durante o build (por exemplo, evite builds paralelos)
• Use multi-stage builds no Dockerfile para otimizar o processo
• Considere fazer upgrade do seu plano para mais recursos

Linhas de erro destacadas

O visualizador de logs destaca automaticamente linhas que contem erros em vermelho, facilitando a identificacao rapida de problemas. Linhas de log do processo de clone do repositorio podem ser expandidas ou colapsadas para manter o foco no build principal.