❓ Perguntas Frequentes (FAQ) - Deploy

🔑 Por que meu deploy via Git de um repositório privado falha com erro de autenticação?

A falha geralmente ocorre por uma chave SSH ou token de acesso incorreto/expirado.
Verifique se a chave SSH cadastrada na plataforma tem permissão de leitura no repositório ou gere um novo token de acesso com as permissões corretas e atualize nas configurações do projeto.

📦 O que significa o erro "Failed to resolve dependencies" durante o deploy?

Este erro indica que o gerenciador de pacotes (Maven, Composer, NPM, etc.) não conseguiu baixar as dependências.
Certifique-se de que seus arquivos de manifesto, como pom.xml ou package.json, estão corretos e que os repositórios de dependências estão acessíveis de dentro do contêiner.

🚀 Meu deploy foi concluído com sucesso, mas a aplicação não inicia. O que verificar?

Verifique os logs do contêiner para identificar o erro que impede a inicialização.
Causas comuns incluem:

• Variável de ambiente ausente
• Porta de aplicação incorreta
• Falha na conexão com o banco de dados

📝 Por que as alterações do meu último commit não aparecem após um auto-deploy?

O problema pode estar no webhook configurado ou em cache.
Verifique se o webhook do seu repositório Git está ativo e apontando para a URL correta na plataforma.
Considere limpar o cache da aplicação ou do CDN, caso esteja utilizando.

💾 Recebo um erro de "out of memory" durante o processo de build. O que fazer?

O processo de compilação pode exigir mais memória do que a alocada para o contêiner.
Aumente temporariamente os cloudlets do nó de build/aplicação durante o deploy para garantir recursos suficientes para a compilação bem-sucedida.

📂 Como devo estruturar meu arquivo .zip para um deploy correto?

O arquivo .zip deve conter os arquivos da aplicação em sua raiz, e não dentro de um subdiretório.
A plataforma espera encontrar os arquivos principais (ex: index.php ou ROOT.war) diretamente no primeiro nível do pacote.

🔒 O deploy falha com "permission denied". Como corrigir?

Este erro ocorre quando os scripts de deploy tentam escrever em diretórios sem a permissão necessária.
Verifique as permissões dos arquivos e, se necessário, utilize Deployment Hooks para executar um comando chmod antes da execução.

🐢 O deploy via VCS é muito lento. Existe uma forma de otimizar?

Sim! Algumas dicas:

• Utilize um .gitignore bem configurado para não versionar arquivos desnecessários.
• Considere estratégias para cachear dependências dentro do contêiner.

⚙️ Posso executar comandos customizados, como migrações de banco de dados, durante o deploy?

Sim, utilize os Deployment Hooks.
É possível configurar scripts para rodarem antes (Pre-hooks) ou depois (Post-hooks) do deploy, permitindo executar migrações, limpar cache ou automatizar outras tarefas.

🌿 Meu deploy falha ao tentar clonar o repositório com mensagem sobre a branch "master". O que mudou?

Muitos serviços Git (como GitHub) agora usam main como branch padrão em vez de master.
Verifique qual é a branch principal do seu repositório e ajuste nas opções de deploy da plataforma.

🛠️ Recebo erro de versão incompatível do Node.js/PHP/Java durante o deploy. Como resolver?

A versão configurada no ambiente é diferente da exigida pelo projeto.
Acesse as configurações da topologia e altere a versão do stack (Node.js, PHP, Java) para a compatível com sua aplicação.

🔗 O deploy via URL de um arquivo Zip está falhando. O que pode ser?

A URL fornecida pode não permitir acesso direto.
Garanta que:

• O link inicia o download imediato do arquivo
• Não requer autenticação
• O firewall do contêiner permite conexão externa

⚠️ Por que o deploy substitui arquivos de configuração que alterei manualmente?

O processo padrão de deploy sobrescreve os arquivos existentes.
Para preservar configurações:

• Use variáveis de ambiente
• Mantenha arquivos fora do diretório de deploy
• Utilize links simbólicos, se necessário

🖥️ Meu deploy em cluster falha apenas em alguns nós. Qual a causa?

Pode ocorrer por:

• Falta de sincronização
• Recursos insuficientes
• Problemas de rede em alguns nós

Verifique os logs de cada nó individualmente e garanta configurações idênticas entre eles.

⏳ O que fazer quando o deploy trava em "em andamento" por muito tempo?

Um deploy travado pode indicar problema em script ou falta de recursos.
Aguarde o Timeout do Deploy, verifique os logs para identificar o último passo executado e tente novamente após ajustar os recursos.