Instalação do Node.js e do npm
Para descarregar e instalar os binários do Node.js e do npm (gestor de pacotes do Node.js), execute os passos seguintes:
1 - Aceda à sua conta usando SSH.
2 - Na linha de comandos, escreva o comando seguinte: cd ~ wget https://nodejs.org/dist/v4.4.1/node-v4.4.1-linux-x64.tar.xz
Este comando irá descarregar a versão 4.4.1 LTS (Long-Term Support) do Node.js. Se desejar descarregar uma versão mais recente, altere o número da versão no comando acima.
3 - Para extrair os ficheiros do Node.js, escreva o comando seguinte: tar xvf node-v4.4.1-linux-x64.tar.xz
4 - Para renomear a pasta extraída para "nodejs", escreva o comando seguinte: mv node-v4.4.1-linux-x64 nodejs
5 - Para instalar os binários do Node e do npm, escreva os comandos seguintes: mkdir ~/bin cp nodejs/bin/node ~/bin cd ~/bin ln -s ../nodejs/lib/node_modules/npm/bin/npm-cli.js npm
NOTA: A diretoria ~/bin está, por defeito, no PATH, o que significa que pode executar o Node e o npm a partir de qualquer diretoria da sua conta.
Após a execução destes comandos, o Node.js e o npm ficarão instalados na sua conta. Para confirmar que a instalação foi concluída com sucesso, escreva os comandos seguintes: node --version npm --version
ARRANQUE DE APLICAÇÃO NODE.JS
Depois de instalar o Node.js, poderá correr aplicações Node.js. O procedimento necessário dependerá da forma como a aplicação foi configurada.
MÉTODO 1 - USO DE NPM
Muitas das aplicações desenvolvidas por terceiros e aplicações gratuitas, como o Ghost, utilizam o npm para o arranque, como pode ser observado no comando seguinte: nohup npm start --production &
NOTA: O caractere & permite que o comando seja executado em segundo plano, e o comando nohup garante que a aplicação continue a correr mesmo que o utilizador faça logout da sessão do terminal em uso.
Para que este método funcione corretamente, deverá existir um ficheiro package.json na aplicação. Este ficheiro contém os metadados do projeto, que o npm usará para determinar como arrancar a aplicação, gerir dependências, entre outros.
Para consultar a documentação oficial do npm sobre o ficheiro package.json, aceda a: https://docs.npmjs.com/files/package.json.
MÉTODO 2 - ARRANQUE DIRECTO DO NODE
No caso de aplicações mais simples, ou de qualquer aplicação que não possua o ficheiro package.json, poderá arrancar o executável do Node diretamente e especificar o nome do ficheiro da aplicação. Exemplo: nohup node my_app.js &
Neste caso, não poderá usufruir dos benefícios do npm para a gestão da aplicação.
NOTA: Como mencionado acima, o simbolo & permite que o comando seja executado em segundo plano, e o comando nohup garante que a aplicação continue a correr mesmo que o utilizador faça logout da sessão do terminal em uso.
PARAR UMA APLICAÇÃO NODE.JS
Para parar uma aplicação Node.js em execução, escreva o comando seguinte: pkill node
Este comando irá parar imediatamente todas as aplicações Node.js em execução.
INTEGRAÇÃO DE APLICAÇÃO NODE.JS COM O SERVIDOR WEB
Dependendo do tipo de aplicação Node.js que estiver a utilizar, poderá querer aceder à mesma através do seu navegador. Para tal, deverá escolher uma porta disponível para a sua aplicação Node.js e criar regras de reescrita que redireccionem os visitantes para a aplicação. Exemplo:
1 - Adicione as seguintes linhas ao ficheiro .htaccess, localizado na diretoria /home/username/public_html (substitua username pelo nome de utilizador da sua conta):
RewriteEngine On RewriteRule ^$ http://127.0.0.1:XXXXX/ [P,L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ http://127.0.0.1:XXXXX/$1 [P,L]
2 - Substitua XXXXX pelo número da porta associada à sua aplicação Node.js.
NOTA: Utilize uma porta livre, entre os números 49152 e 65535 (inclusive).
3 - Guarde as alterações ao ficheiro .htaccess. A partir deste momento, os visitantes do seu site serão redireccionados para a aplicação Node.js associada à porta especificada.
NOTA: Se a sua aplicação não arrancar, isso poderá indicar que a porta selecionada não está livre. Verifique o log da aplicação para códigos de erro como EADDRINUSE. Nesse caso, utilize um número de porta diferente no ficheiro .htaccess e tente novamente.
MAIS INFORMAÇÕES
Para mais informações sobre o Node.js, consulte: http://nodejs.org.