Como Rodar Node.js na Cloudez (Guia Prático + dicas para IA)
06 de julho de 2020
⚠️ Está usando IA (ChatGPT, Claude, Copilot etc.)?
Leia a seção 4 “Usando IA para configurar seu Node.js” antes de rodar qualquer comando. Existem três pontos importantes que você precisa conhecer antes de executar qualquer comando.
Node.js + pm2
Para garantir que sua aplicação Node.js fique sempre online e suporte altos fluxos de tráfego, recomendamos a utilização do PM2. Ele gerencia o processo e garante que o site reinicie sozinho após qualquer erro ou manutenção.
1. Ativando e Preparando o Ambiente
Antes de iniciar, você precisa entrar na “bolha” da sua aplicação e garantir que todas as dependências estejam instaladas.
cd /srv/seudominio.com.br/www/
source ../activate
npm install
npm install -g pm2
npm run build
2. Iniciando sua Aplicação com PM2
O comando para “dar o play” varia conforme a tecnologia que você usa. Escolha o cenário que se aplica ao seu projeto:
pm2 start npm --name “meu-app” -- start
pm2 start server.ts --name “meu-app” --interpreter ts-node
pm2 start app.js --name “meu-app”
3. Configuração do Proxy (Acesso Público)
Diferente de sites PHP, aplicações Node.js executam em uma porta interna definida pela própria aplicação (por exemplo, 3000, 3001, 8080 ou outra). Essa porta é configurada durante o desenvolvimento da aplicação e não pelo Nginx ou pelo suporte da Cloudez.
O papel do Nginx é apenas encaminhar os acessos ao seu domínio para a porta onde a aplicação já está rodando. Por isso, antes de solicitar a configuração do Proxy, verifique qual porta sua aplicação está utilizando.
⚠️ Importante: essa etapa não deve ser feita por você via SSH, mesmo que você (ou uma IA) saiba como configurar Nginx. Por questões de segurança e performance, o Proxy é configurado exclusivamente pelo nosso suporte.
Abra um ticket informando a porta que sua aplicação utiliza. Exemplo: “Olá, minha aplicação está pronta e rodando na porta 3000. Poderiam configurar o Proxy no Nginx para o meu domínio?”
4. Usando IA para configurar seu Node.js
Usar ChatGPT, Cloude, Copilot ou outra IA para te ajudar com os passos acima é possível, os comandos de PM2 e SSH descritos neste guia são compatíveis com o que uma IA generalista sugere.
O problema aparece em três pontos específicos, porque a IA não sabe que sua aplicação está na Cloudez:
1. Configuração de Proxy/Nginx: É comum a IA sugerir configurar o Nginx diretamente por SSH quando você pede ajuda para “expor a aplicação na porta X”. Não faça isso.
Essa etapa é exclusiva do suporte (veja passo 3), porque configurações de proxy feitas manualmente podem ser sobrescritas ou entrar em conflito com o que o suporte provisiona depois.
2. Itens gerenciados pelo painel: Domínio, certificado SSL e algumas variáveis de ambiente são gerenciadas pelo painel Cloudez, não pelo servidor. Se a IA sugerir editar esses itens diretamente por SSH (em vez de pelo painel), a alteração pode ser sobrescrita na próxima vez que o painel reprovisionar a aplicação e você perde a mudança sem aviso.
3. Ambiente virtual da aplicação: Oriente a IA para acessar o diretório /www e executar source ../activate para ativar o ambiente virtual da aplicação antes de qualquer gerenciamento em aplicações Node.js
Esse comando ativa o ambiente virtual da aplicação. Somente depois disso os demais comandos de gerenciamento da aplicação devem ser executados.
Prompt seguro para usar em uma IA
Copie e cole isso antes de pedir ajuda com configuração do Node:
–
Estou hospedando uma aplicação Node.js na Cloudez. Uso PM2 via SSH para gerenciar o processo da aplicação, esse é o fluxo padrão.
Porém, existem algumas particularidades dessa hospedagem:
1. O Proxy reverso/Nginx NÃO deve ser configurado por mim via SSH. Essa etapa é feita exclusivamente pelo suporte da Cloudez mediante ticket.
2. Itens como domínio, certificado SSL e algumas variáveis de ambiente são gerenciados pelo painel da Cloudez. Antes de sugerir alterações via SSH, confirme se existe uma configuração equivalente no painel.
3. Antes de qualquer gerenciamento da aplicação Node.js, acesse o diretório /www e execute source ../activate para entrar no ambiente virtual da aplicação. Todos os comandos de instalação de dependências, instalação do PM2, build e gerenciamento da aplicação devem ser executados somente após essa etapa.
Minha dúvida é: [descreva aqui o que você precisa fazer].
Ainda precisa de ajuda?
Se depois de revisar isso sua aplicação Node continuar com problemas, abra um ticket com nosso suporte e inclua se você usou IA no processo, isso agiliza o nosso diagnóstico.