Saltar al contenido principal

🚀 ¿Qué es NPM?

El NPM (Node Package Manager) es el gestor de paquetes estándar de Node.js, utilizado para instalar librerías y dependencias. Además, puedes usarlo para ejecutar scripts de inicio de tu aplicación.

aviso

Aunque NPM permite ejecutar scripts con npm start, no es un gestor de procesos. Esto significa que no ofrece tolerancia a fallos, reinicio automático de la aplicación en caso de caída o bloqueo, ni mantiene el proceso en segundo plano. En entornos de producción, se recomienda usar un gestor de procesos como PM2. Para aprender sobre PM2, ¡haz clic aquí!.

🛠️ Cómo usar NPM en SaveinCloud​

En la plataforma, puedes integrar NPM a tu aplicación Node.js de dos maneras principales:

1️⃣ - Seleccionando la Etiqueta "NPM" al Crear el Entorno​

Durante la creación de un nuevo entorno en SaveinCloud, puedes optar por una imagen preconfigurada que ya incluye Node.js y NPM instalados. Esta opción agiliza el proceso de despliegue, permitiendo que tu aplicación sea gestionada por NPM desde el inicio.

NPM Topologia

2️⃣ - Configurando NPM mediante Variables de Entorno​

Si ya tienes un entorno en ejecución, es posible configurar NPM utilizando variables de entorno.

Variáveis de Ambiente - Parte 1

Variáveis de Ambiente - Parte 2

📄 Configuración del Archivo package.json​

Para que NPM ejecute tu aplicación correctamente, es necesario tener el script de inicio dentro del archivo de configuración llamado package.json y este debe estar ubicado en el directorio /home/jelastic/ROOT - que es el estándar definido en la variable de entorno $ROOT_DIR, pudiendo cambiarse el directorio según necesidad -. Este archivo define cómo NPM debe iniciar tu aplicación.

info

La plataforma buscará archivos de entrypoint estándar - como server.js, index.js, app.js - dentro del directorio /home/jelastic/ROOT (en este caso, es el directorio especificado dentro de la variable de entorno $ROOT_DIR) para realizar el inicio automático de tu aplicación. Si el entrypoint de tu aplicación tiene otro nombre, puedes especificarlo en la variable de entorno $APP_FILE.

Ejemplo de script para iniciar la aplicación en el archivo package.json:

{
  "scripts": {
    "start": "node ./server.js"
  }
}
  • start: es el punto de entrada de la aplicación y se ejecutará con npm start.
aviso

🔒 Asegúrate de liberar en el firewall el puerto que utiliza tu aplicación para garantizar su correcto funcionamiento. Para aprender sobre Gestión de Firewall, ¡haz clic aquí!

🧰 Comandos Útiles de NPM​

ComandoDescripción
npm installInstala todas las dependencias listadas en package.json.
npm install <pacote>Instala un paquete específico localmente.
npm run startEjecuta el script definido como start en package.json.
npm run <nome-script>Ejecuta cualquier otro script personalizado definido.
npm outdatedVerifica dependencias desactualizadas.
npm updateActualiza todas las dependencias a la última versión permitida.
info

💡 Recuerda almacenar tu archivo package.json dentro del directorio /home/jelastic/ROOT, ya que la plataforma ejecutará el comando npm install para instalar las dependencias contenidas en tu archivo en cada reinicio de la instancia (la variable de entorno $UPDATE_PACKAGES_ON_RESTART debe tener el valor true).

🧠 ¿Dudas?​

Contacta con el soporte técnico y envía tu consulta, estaremos disponibles para ayudarte.

ℹ️ Enlaces útiles​