Se você está pensando em utilizar hospedagem de aplicativos Node.js na MeuHub, temos boas notícias para você: Plesk vem com uma extensão Node.js que permite instalar e gerenciar aplicativos de forma rápida e fácil. Outras funções importantes incluem:
• Usando as versões mais recentes do Node.js (LTS e Current),
• Escolha do gerenciador de pacotes: NPM ou Yarn,
• Visualizando logs de aplicativos na interface web Plesk usando Log Browser,
• Interface web muito simples para outras funções de gerenciamento relacionadas
Neste artigo, descreveremos em detalhes como trabalhar com aplicativos Node.js no contexto do Plesk Obsidian, a versão mais recente do Plesk.
Hospedando um aplicativo ‘Hello World’
Para garantir que tudo funcione, vamos tentar hospedar um aplicativo Node.js de amostra, como um aplicativo “Hello, World”. Você pode baixar um aqui. Copiar/colar o conteúdo do arquivo app.js manualmente é uma opção, mas sugiro experimentar o GitHub.
Primeiro, você precisa criar uma assinatura (um domínio com hospedagem). Em seguida, você precisa criar um diretório de destino onde o aplicativo será armazenado. Selecione sua assinatura, vá para a guia “Arquivos” e crie um diretório chamado “hello-world”. Em seguida, vá para a guia “Domínios”, escolha o site e clique no botão “Git”.
Configuração de repositório local
Agora, você aprenderá a configurar um repositório local como um espelho de um remoto e implantar o código no diretório criado anteriormente. Defina esse URL como o URL do repositório Git remoto e altere o destino para o diretório “hello-world”. As configurações devem ficar assim:
Diferenças entre ‘Document Root’ e ‘Application Root’
O próximo passo é alterar a “raiz do documento” para o domínio. Observe que falarei sobre “Document root” e “Application root”: eles não são a mesma coisa. Quando estamos falando de aplicativos da web (por exemplo, aplicativos baseados em Node.js ou similares), a “raiz do documento” é o local onde os ativos estáticos podem ser encontrados. Enquanto isso, a “raiz do aplicativo” é o diretório raiz onde o próprio aplicativo está localizado. Na maioria dos casos, o “Document root” é um diretório dentro do diretório “Application root” (por exemplo, “public”).
Você precisa alterar a raiz do documento agora. Para isso, vá em “Domínios”, selecione seu site e vá em “Configurações de Hospedagem”:
Ativar suporte a Node.js
A última coisa a fazer antes de executar o aplicativo é habilitar o suporte ao Node.js no domínio. Vá em “Domínios”, escolha o site e clique em “Node.js”. Aqui você verá algumas informações sobre seu aplicativo e uma linha de botões na parte superior. Clique em “Ativar Node.js” e em alguns segundos sua tela ficará assim:
Instalando dependências
Antes de tentar acessar o aplicativo, você precisa inicializá-lo primeiro. Vamos começar instalando as dependências – felizmente, no Plesk, é tão fácil quanto clicar no botão “NPM install”. Isso instalará todas as dependências do aplicativo de acordo com o arquivo package.json.
Nota : você também pode usar o gerenciador de pacotes Yarn. A extensão tentará determinar o gerenciador de pacotes que você precisa com base nos arquivos do aplicativo. Ou você pode especificá-lo explicitamente na interface de extensão.
Em seguida, você precisa ajustar o arquivo de inicialização do aplicativo. O Plesk usa o servidor de aplicativos Phusion Passenger para servir aplicativos Node.js. Nosso repositório de aplicativos de demonstração contém um arquivo chamado “server.js”. Esse arquivo não faz parte de um aplicativo típico baseado em Express e contém apenas algumas linhas de código, mas ainda assim é necessário que o aplicativo seja executado:
const app = require('./app');
const http = require('http');
http.createServer(app).listen(process.env.PORT);
Você pode usar a ideia por trás desse arquivo ao hospedar outros aplicativos Node.js (por exemplo, com base em uma estrutura diferente). A última coisa que você precisa fazer é alterar a configuração “Application Startup File” para “server.js”.
Aqui estão algumas dicas que podem evitar muito sofrimento:
Como visualizar logs de aplicativos hospedados
A primeira coisa a fazer ao solucionar problemas de um aplicativo Node.js é verificar os arquivos de log. Para encontrar os registros de log, incluindo a saída do console do seu aplicativo, abra o “Log Browser” do seu site. Você pode focar os registros listados usando o menu suspenso à direita.
Trazer mensagens de erro para o navegador
Ao desenvolver um aplicativo, é muito útil ver as mensagens de erro diretamente no site – elas ainda estão sendo registradas. Vá para a tela de configurações do aplicativo Node.js e altere o Modo de Aplicativo para “desenvolvimento”. Da próxima vez que um problema aparecer, o erro será mostrado na janela do navegador. Assim:
Testando o suporte do Node.js
Outra diferença é a localização do ponto de entrada principal. No Plesk para Linux, ele deve estar localizado no diretório pai do “Document root” do domínio. No Plesk para Windows, deve ser colocado diretamente no diretório “Document root”.
Para testar o suporte ao Node.js, vamos usar o aplicativo de demonstração baseado em Express. Crie um diretório chamado “node-express” em seu domínio usando o acesso FTP ou o Gerenciador de Arquivos integrado. Em seguida, implante o conteúdo do repositório GitHub “node-express”. Depois disso, clique no link “Hosting Settings” (dentro de Domains -> Website name) e defina o diretório “Document root” do domínio para “node-express”.
Em seguida, vá para as configurações do aplicativo Node.js e altere o “Application Startup File” para “server.js”. Por fim, instale as dependências usando o botão “NPM install”. Depois que as dependências estiverem instaladas, você poderá navegar em seu site para garantir que o aplicativo esteja em execução. Alguns ajustes adicionais de regras de reescrita podem ser necessários, mas, como você pode ver, é possível iniciar o aplicativo Node.js mesmo na hospedagem do Windows.
Então é isso, pessoal! O suporte Plesk Obsidian para Node.js torna a hospedagem de aplicativos Node.js tão simples quanto abc…
