Requisitos
- Node.js instalado localmente (para desenvolvimento)
- Conta na Vertra Cloud
- Arquivo
package.jsonna raiz do projeto
Estrutura do projeto
Configuração
package.json
Garanta que opackage.json tenha um script start definido:
A plataforma executa
npm install automaticamente antes de iniciar sua aplicação. Não inclua node_modules no upload.vertracloud.config (opcional)
Exemplo: servidor HTTP simples
Deploy
- Dashboard
- CLI
- VS Code
- Compacte o projeto em um
.zip(pastas comonode_modules,venvetargetsão removidas automaticamente) ou envie-o ao GitHub. - No dashboard, clique em Novo Projeto e envie o
.zipou cole a URL do repositório. - Em Build, confira o runtime (JavaScript), o arquivo principal (
index.js) e a memória. Os comandos de start e build ficam em Configurações avançadas. - Adicione suas variáveis de ambiente em Variáveis de Ambiente.
- Em Rede, ative a publicação na web para que a aplicação receba um endereço
*.vertraweb.app(plano Pro ou superior, 512 MB de memória). A aplicação precisa escutar na porta 80. - Revise e faça o deploy. Acompanhe a saída na aba Logs.
Versões disponíveis
Observações
- Dependências são instaladas automaticamente via
npm install - Variáveis de ambiente podem ser configuradas no dashboard ou pela API
- Logs ficam disponíveis em tempo real no terminal do dashboard
- Reinício automático vem ativado por padrão e reinicia a aplicação automaticamente após uma queda
- Sempre escute em
process.env.PORTe no host0.0.0.0
Problemas comuns
Error: Cannot find module
Error: Cannot find module
Garanta que todas as dependências estejam listadas no
package.json. A plataforma instala apenas o que está declarado.EADDRINUSE: address already in use
EADDRINUSE: address already in use
Sua aplicação pode estar tentando usar uma porta fixa. Use
process.env.PORT para a porta correta.O container reinicia sem parar
O container reinicia sem parar
Verifique os logs para identificar o erro. Erros de sintaxe ou dependências ausentes são causas comuns. O sistema de detecção de crash loop pausa o reinício automático após 5 quedas em 10 minutos.