Utilizar versión personalizada de NodeJs

En los planes de Hosting Avanzado disponemos de herramientas especiales para desarrollar tu web, tales como Ruby, Python o Node.js.

En el caso de Node.js, además de utilizar la versión instalada por defecto en el servidor, podemos emplear otras versiones personalizadas gracias al gestor de versiones de Node.js llamado NVM.

En esta guía te indicamos cómo puedes disponer de la versión personalizada de Node.js que necesitas en pocos pasos.

Instalar una versión personalizada de Node.js

El primer paso que tendrás que realizar es acceder vía SSH a tu hosting.

Una vez conectado, descargamos e instalamos NVM desde su repositorio oficial mediante el siguiente comando:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

Una vez finalizada la instalación, ejecutamos los siguientes comandos para que NVM esté disponible en la sesión SSH actual:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Si vuelves a acceder al hosting mediante una nueva sesión SSH, es posible que tengas que ejecutar de nuevo estos comandos para cargar NVM.

Instalamos nuestra versión personalizada de Node.js mediante NVM. En nuestro ejemplo vamos a utilizar Node.js 24, perteneciente a una rama LTS con soporte:

nvm install 24

Una vez instalada, indicamos que queremos utilizar esta versión:

nvm use 24

Podemos comprobar la versión activa mediante el siguiente comando:

node --version

El resultado mostrará la versión concreta de la rama 24 que NVM haya instalado, por ejemplo:

v24.x.x

Crear la aplicación de Node.js

Una vez instalada nuestra versión personalizada de Node.js, ya podemos crear nuestra aplicación.

En nuestro ejemplo la hemos colocado en el directorio app1, para tenerla separada del resto de nuestra web:

mkdir app1
cd app1

A continuación, inicializamos el proyecto:

npm init

Durante este proceso, npm nos solicitará algunos datos sobre la aplicación. Podemos aceptar los valores predeterminados pulsando la tecla Enter.

Adicionalmente, instalamos Express para una mayor comodidad:

npm install express

Finalmente, ya podemos crear nuestro fichero index.js con el contenido de nuestra aplicación.

En este ejemplo simplemente vamos a hacer que nos muestre en la web qué versión de Node.js estamos utilizando:

var express = require('express');
var app = express();
app.get('/app1', function (req, res) {
    res.send(process.version);
});
app.listen(0, function () {
});

En las aplicaciones Node.js ejecutadas en Dinahosting debemos utilizar el puerto 0, ya que el sistema se encarga de asignar y gestionar el puerto necesario para la aplicación.

Copiar la versión personalizada de Node.js

Por último, y antes de preparar la aplicación de Node.js desde nuestro Panel de Control, vamos a copiar la carpeta que contiene la versión personalizada de Node.js al mismo directorio donde tenemos nuestra aplicación.

Podemos saber dónde se encuentra el ejecutable de la versión instalada utilizando:

nvm which 24

Para copiar de forma segura el directorio completo de Node.js dentro del directorio de nuestra aplicación, ejecutamos:

NODE_BIN="$(nvm which 24)"
NODE_DIR="$(dirname "$(dirname "$NODE_BIN")")"
NODE_VERSION="$(basename "$NODE_DIR")"
cp -a "$NODE_DIR" .

De esta forma, copiamos la versión de Node.js dentro de app1 sin eliminar ni modificar la instalación original administrada por NVM.

Podemos comprobar que el binario se encuentra en la ubicación correcta mediante:

ls -l "$PWD/$NODE_VERSION/bin/node"

También podemos mostrar la ruta completa que tendremos que indicar posteriormente en el Panel de Control:

echo "$PWD/$NODE_VERSION/bin/node"

El resultado será una ruta similar a la siguiente:

/home/usuario/app1/v24.x.x/bin/node

Preparar la aplicación desde el Panel de Control

Una vez montada nuestra versión personalizada de Node.js, accedemos al Panel de Control del hosting y vamos a la sección Otras aplicaciones.

En este apartado vamos a especificar los siguientes puntos:

• El directorio en el que se encuentra nuestra aplicación de Node.js. En nuestro ejemplo, será el directorio www/app1.
• La ruta a nuestro fichero de inicio de la aplicación, llamado www/app1/index.js.
• La ruta al binario personalizado de Node.js que hemos instalado anteriormente con NVM y copiado dentro del directorio de la aplicación.

En nuestro ejemplo, la ruta al binario terminará de la siguiente forma:

/app1/v24.18.0/bin/node

La ruta completa puede variar dependiendo del nombre de usuario y de la ubicación del directorio principal del hosting.

Una vez guardada la configuración, nuestra aplicación se ejecutará utilizando la versión personalizada de Node.js que hemos instalado.