Desplegar una aplicación node.js en cPanel

A continuación se detallan los pasos para instalar, configurar y gestionar una aplicación Node.js en cPanel a través del módulo "Setup Node.js App".

Paso 1: Inicia Sesión y Localiza el Módulo de Node.js

1. Accede a tu cuenta de cPanel.
2. En la pantalla principal, busca la sección de "Software".
3. Dentro de esta sección, haz clic en el icono "Setup Node.js App".

Paso 2: Crea tu Entorno de Aplicación

1. Una vez dentro del módulo, haz clic en el botón "CREATE APPLICATION".
2. Rellena el formulario con la información de tu proyecto:
   • Node.js version: Selecciona la versión de Node.js que requiere tu aplicación. Debe ser compatible con la especificada en tu archivo package.json.
   • Application mode:
     • Development: Para la fase de desarrollo. Muestra errores detallados.
     • Production: Para sitios en vivo. Optimiza el rendimiento.
   • Application root: La carpeta donde subirás los archivos de tu aplicación (ej. home/tu_usuario/miapp-nodejs).
   • Application URL: La dirección web pública desde la que se accederá a tu aplicación (ej. tudominio.com/miapp).
   • Application startup file: El archivo de entrada principal de tu aplicación (comúnmente app.js, index.js o server.js).
3. Cuando hayas completado todos los campos, haz clic en el botón "CREATE".

Paso 3: Sube los Archivos de tu Aplicación

1. Vuelve al menú principal de cPanel y abre el "Administrador de Archivos" ("File Manager").
2. Navega hasta la carpeta que definiste como "Application root" en el paso anterior.
3. Sube todos los archivos y carpetas de tu proyecto a este directorio. Asegúrate de que el archivo package.json esté presente.

Consejo: Para subir muchos archivos, comprime tu proyecto en un archivo .zip, súbelo y luego usa la opción "Extract" del Administrador de Archivos.

Paso 4: Instala las Dependencias (NPM Install)

1. Regresa a la utilidad "Setup Node.js App" en cPanel y entra en la configuración de tu aplicación.
2. El sistema detectará tu package.json. Haz clic en el botón "RUN NPM INSTALL".
3. El sistema leerá el archivo e instalará todas las dependencias. Espera el mensaje de éxito.

Paso 5: Inicia la Aplicación

1. En la misma pantalla de configuración de la aplicación, busca los botones de control.
2. Haz clic en "START APP".
3. Visita la "Application URL" que definiste para ver tu proyecto en funcionamiento.

Gestión de la Aplicación

Desde la interfaz de "Setup Node.js App" puedes:

• Reiniciar (Restart): Aplica los cambios que hayas hecho en el código.
• Detener (Stop App): Detiene la ejecución de tu aplicación.
• Cambiar versión de Node.js: Permite cambiar la versión de Node.js. Recuerda volver a instalar las dependencias después.
• Variables de Entorno: Añade variables de entorno (claves de API, etc.) en la sección "Environment variables".
• Eliminar (Destroy): Elimina la configuración de la aplicación. No borra los archivos.

Solución de Problemas Comunes

• Error 503 o la página no carga:
  • Revisa los logs: Busca el enlace a los archivos de log (stderr.log) para encontrar errores.
  • Archivo de inicio incorrecto: Asegúrate de que el "Application startup file" es el correcto.
  • Puerto incorrecto: No fuerces un puerto en tu código. El sistema lo asigna automáticamente.
• NPM Install falla:
  • Verifica que tu package.json no tenga errores de sintaxis.
  • Asegúrate de que la versión de Node.js seleccionada es compatible con tus dependencias.