cylinderhost®
Código

Como preparar uma aplicação Node.js para hospedagem

Porta, comando de início, variáveis e logs: um roteiro para publicar sua aplicação Node.js.

Uma aplicação que funciona no seu computador precisa de um comando de início previsível, uma porta configurável e credenciais fora do código para rodar em hospedagem.

Defina como o projeto começa

Confira qual arquivo inicia sua aplicação. Em um projeto simples ele pode ser server.js. Se o código precisa de compilação, execute o build e configure o início para o arquivo gerado. Teste o mesmo comando que será usado no ambiente de produção.

{
  "scripts": {
    "start": "node server.js"
  }
}

Leia a porta pelo ambiente

O módulo HTTP do Node.js permite criar um servidor sem um framework. Este exemplo usa a porta configurada no ambiente e escuta nas interfaces do container:

const http = require("node:http");
const port = Number(process.env.PORT || 3000);

http.createServer((req, res) => {
  res.writeHead(200, {
    "Content-Type": "text/plain; charset=utf-8"
  });
  res.end("Aplicação online");
}).listen(port, "0.0.0.0");

Esse endereço de escuta permite que o proxy alcance a aplicação dentro de um container. Em uma VPS com proxy local, escutar apenas no loopback pode ser adequado. A escolha depende da arquitetura.

Mantenha as credenciais fora do Git

Guarde tokens, senhas de banco e chaves em variáveis de ambiente. Inclua um arquivo de exemplo sem valores reais. Se uma credencial já foi publicada, revogue-a e gere outra: remover o arquivo do último commit não apaga seu histórico.

Confira o deploy

  • O comando de início funciona sem ferramentas da sua máquina?
  • A rota principal responde?
  • As variáveis necessárias estão configuradas?
  • Os logs mostram conexão com o banco?
  • Os dados persistentes têm backup?

Na CylinderHost, consulte a documentação de deploy para enviar o código e configurar a aplicação. Confira os limites nos planos atuais.

Se o endereço não abrir

Comece pelo log do processo. Um erro de conexão com banco pede uma investigação diferente de uma porta ocupada. Faça uma alteração por vez e confira o resultado. Reiniciar sem ler os logs pode apenas repetir o erro.

Referência: introdução oficial ao Node.js.