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.