Pular para o conteúdo principal

Requisitos

  • Node.js instalado localmente (para desenvolvimento)
  • Conta na Vertra Cloud
  • Arquivo package.json na raiz do projeto

Estrutura do projeto

Configuração

package.json

Garanta que o package.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

  1. Compacte o projeto em um .zip (pastas como node_modules, venv e target são removidas automaticamente) ou envie-o ao GitHub.
  2. No dashboard, clique em Novo Projeto e envie o .zip ou cole a URL do repositório.
  3. 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.
  4. Adicione suas variáveis de ambiente em Variáveis de Ambiente.
  5. 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.
  6. Revise e faça o deploy. Acompanhe a saída na aba Logs.
O passo a passo completo está em Primeiro deploy.

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.PORT e no host 0.0.0.0

Problemas comuns

Garanta que todas as dependências estejam listadas no package.json. A plataforma instala apenas o que está declarado.
Sua aplicação pode estar tentando usar uma porta fixa. Use process.env.PORT para a porta correta.
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.
Última modificação em 26 de outubro de 2026