Este guia explica como ajustar a configuração de um site Node.js hospedado na infraestrutura Infomaniak. Você aprenderá a adaptar o comportamento de sua aplicação de acordo com sua evolução, suas dependências ou suas preferências técnicas.

Pré-requisitos

• Instalar um site Node.js em sua hospedagem.
• Testar suas modificações localmente antes de aplicá-las em produção.
• Verificar se seus scripts (start, build) estão bem definidos em seu arquivo package.json.
• Se você modificar a estrutura do seu projeto, lembre-se de ajustar o diretório de execução e os comandos associados.
• Importante: a porta de escuta definida no Gerenciador deve corresponder obrigatoriamente àquela utilizada no código da aplicação.

Acessar a configuração

Cada site possui um painel de controle dedicado para controlar a aplicação (iniciar, parar, reiniciar), consultar os logs de execução, gerenciar as versões do Node.js e ativar os certificados SSL:

1. Clique aqui para acessar o gerenciamento do seu site no Gerenciador Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao site em questão:
   
3. Clique em Gerenciar as configurações avançadas:
   
4. Clique na aba Node.js para acessar as configurações:
   

Comandos e automação

Diretório de execução

O diretório de execução indica o local no servidor onde os comandos de construção (build) e de lançamento serão executados. Ele deve apontar para o diretório raiz de sua aplicação, onde se encontra seu arquivo package.json.

./          // Root directory
./app       // Subfolder named app
./backend   // Subfolder named backend

Comando de construção (Build)

Se sua aplicação necessitar de uma etapa de preparação (instalação das dependências, compilação TypeScript, minificação), informe aqui o comando a ser executado. Esta é a método recomendado para implantar suas atualizações.

Ao contrário de uma execução manual em SSH, esta interface utiliza um ambiente com desempenho aprimorado para garantir uma construção rápida sem impactar os recursos do seu site em produção. Você pode encadear várias tarefas aqui (como um git pull seguido de um build) e acompanhar o progresso, bem como os logs do processo em tempo real, diretamente do Gerenciador.

# Example: install dependencies and build
npm install && npm run build

# Example: update code and build with yarn
git pull && yarn install && yarn build

Observação: Se seu projeto já estiver compilado ou não necessitar de nenhuma etapa intermediária, este campo pode permanecer vazio.

Comando de lançamento

Esta instrução inicia seu servidor. Ela deve ser idêntica àquela utilizada em seu ambiente de desenvolvimento local para iniciar o ponto de entrada da aplicação.

# Option 1: Direct file launch
node index.js

# Option 2: Using npm script
npm start

# Option 3: Using yarn script
yarn start

Porta de escuta

Sua aplicação deve obrigatoriamente escutar na porta dinâmica atribuída pelo Gerenciador. Esta porta é transmitida ao seu código através da variável de ambiente PORT.

// Use the port provided by the environment
const port = process.env.PORT || 8080;

app.listen(port, () => {
  console.log(`Application started on port ${port}`);
});

Versão do Node.js

Você pode selecionar a versão do Node.js desejada nas configurações. É aconselhável priorizar uma versão estável (LTS) para garantir a segurança e a longevidade do seu projeto.

Aplicar e validar as alterações

Uma vez que suas modificações sejam salvas no Gerenciador, você deve reiniciar sua aplicação a partir do painel de controle para que os novos parâmetros (nova versão do Node, nova porta ou novo comando de build) sejam considerados.

Em caso de dificuldade ao iniciar, você pode consultar o console de execução ou consultar este outro guia para solucionar problemas.