Este guia ajuda a diagnosticar rapidamente a origem de um problema caso o seu site Node.js, hospedado na infraestrutura Infomaniak, não funcione como esperado.

Verificar o estado da aplicação

No painel de controle do seu site Node.js, você pode verificar o estado atual da aplicação:

• Ativo: sua aplicação está funcionando normalmente.
• Em reinicialização: o aplicativo está sendo reiniciado, aguarde alguns instantes.
• Parado ou Com erro: ocorreu um problema.

Em caso de erro ou interrupção:

• Clique em « Iniciar » ou « Reiniciar » a aplicação.
• Consulte imediatamente o console de execução para identificar possíveis erros técnicos.

Analisar o console de execução

O console exibe as mensagens de erro geradas durante a execução da sua aplicação. Abaixo estão os erros mais comuns:

• Comando de execução incorreto: verifique se está a usar a sintaxe correta (exemplo: npm start, node app.js, etc.).
• Erro no código fonte: pode ser uma exceção não tratada, um módulo ausente ou uma porta definida incorretamente.

Verificar as configurações da aplicação

Na seção Configurações avançadas do site, certifique-se de que todas as configurações estejam corretas:

• Diretório de execução: diretório no qual os comandos build e start são executados.
• Comando de construção (opcional): por exemplo, npm run build, caso a sua aplicação necessite de um.
• Comando de execução: por exemplo, node index.js, npm start, etc.
• Porta de escuta: a porta na qual a aplicação aguarda as requisições (por exemplo, 8080, 3000, etc.).
  • A porta configurada na sua aplicação deve corresponder àquela definida no Manager.
• Versão do Node.js: certifique-se de que ela é compatível com o seu código.

A Infomaniak disponibiliza os gestores de pacotes NPM e Yarn. Pode escolher o que melhor se adapta ao seu projeto no assistente de configuração.

Ainda com problemas?

O site continua inacessível?

• O seu aplicativo pode estar em modo de manutenção.
• A porta de escuta da aplicação pode estar incorreta ou bloqueada.
• A aplicação não retorna uma resposta HTTP válida (por exemplo, não há res.send() ou res.end() no seu servidor).

Utilizou um método de instalação avançado?

Se importou o seu código através de Git, ZIP, SSH ou SFTP, certifique-se de que:

• O código foi descompactado ou clonado corretamente na pasta correta.
• Os arquivos essenciais (package.json, server.js, index.js, etc.) estão presentes.
• As dependências estão corretamente instaladas (a pasta node_modules está presente após a execução de npm install ou yarn install).

Se o problema persistir após todas estas verificações:

• Tente criar um novo site usando o método simples para testar com um exemplo funcional.
• Compare a sua configuração com a do exemplo fornecido.
• Consulte a documentação oficial do Node.js para obter informações sobre erros específicos.
• Se necessário, entre em contato com o suporte da Infomaniak, enviando uma cópia dos logs exibidos no console.