Guía de discord.js

Gestionando el proceso de tu bot con PM2

PM2 es un administrador de procesos. Administra los estados de sus aplicaciones, para que pueda iniciar, detener, reiniciar y eliminar procesos. Ofrece características tales como monitorear los procesos en ejecución y configurar un "inicio con el sistema operativo" (ya sea Windows, Linux o Mac) para que sus procesos comiencen cuando inicie su sistema.

Instalación

Puedes instalar pm2 mediante npm:

npm install --global pm2
1

O, también puedes utilizar Yarn:

yarn global add pm2
1

Iniciando tu aplicación

Después de instalar pm2, la manera más sencilla para iniciar tu aplicación es yendo al directorio donde se encuentra tu bot y ejecutar lo siguiente:

pm2 start your-app-name.js
1

Notas adicionales

El script pm2 start permite el uso de argumentos en línea.

  • --name: Esto le permite establecer el nombre de su proceso al incluirlo en pm2 list o pm2 monit:
pm2 start your-app-name.js --name "Algún nombre cool"
1
  • --watch: Esta opción reiniciará automáticamente su proceso tan pronto como se detecte un cambio de archivo, lo que puede ser útil para entornos de desarrollo:
pm2 start your-app-name.js --watch
1

TIP

El comando pm2 start puede tener más parámetros opcionales, pero solo estos dos son relevantes. Si quieres revisar el resto de los parámetros, puedes revisar la documentación de pm2 aquíopen in new window.

Cuando el proceso se inicie con pm2, puedes ejecutar pm2 monit para monitorear todas las salidas de la consola de los procesos iniciados por pm2. Esto incluye cualquier console.log() en tu código o errores de código.

Configuración del arranque junto al sistema

Quizás una de las características más útiles de PM2 es poder iniciarse con su sistema operativo. Esta función garantizará que los procesos de su bot siempre se inicien después de un (inesperado) reinicio (por ejemplo, después de un corte de energía).

Los pasos iniciales difieren según el sistema operativo. En esta guía, cubriremos los de Windows y Linux / MacOS.

Pasos iniciales para Windows

TIP

Ejecute esto desde el símbolo del sistema con permisos de administrador para evitar ser "golpeado" por múltiples cuadros de dialogo UAC.

Instalar el paquete de pm2-windows-serviceopen in new window a partir de npm:

npm install --global pm2-windows-service
1

Cuando la instalación finalice, instala el servicio ejecutando el siguiente comando:

pm2-service-install
1

TIP

Puedes usar el parámetro -n para establecer el nombre del servicio: pm2-service-install -n "the-service-name"

Pasos iniciales para Linux/MacOS

Necesitas un script de arranque, el cual puedes obtener ejecutando los siguientes comandos:

# Detecta el sistema de inicio disponible, genera la configuración, y habilita el sistema de inicio
pm2 startup
1
2

O, si quieres especificar su sistema manualmente, selecciona una de las opciones con el comando:

pm2 startup [ubuntu | ubuntu14 | ubuntu12 | centos | centos6 | arch | oracle | amazon | macos | darwin | freesd | systemd | systemv | upstart | launchd | rcd | openrc]
1

El resultado de ejecutar uno de los comandos enumerados anteriormente generará un comando para que lo ejecute con todas las variables y opciones de entorno configuradas.

Ejemplo de la "salida" para usuarios de Ubuntu:

[PM2] You have to run this command as root. Execute the following command:
      sudo su -c "env PATH=$PATH:/home/user/.nvm/versions/node/v8.9/bin pm2 startup ubuntu -u user --hp /home/user
1
2

Después de ejecutar el comando, puedes continuar con el siguiente comando.

Guardar la lista de procesos actual

Para guardar la lista de procesos actual para que se inicie automáticamente después de un reinicio, ejecute el siguiente comando:

pm2 save
1

Para deshabilitar esto, ejecute el siguiente comando:

pm2 unstartup
1