Pm2 handleiding

Wat is PM2

PM2 is een process manager voor onder andere Node.js-applicaties en kan ook gebruikt worden als queue runner voor Laravel. Het helpt bij het beheren van de applicatieprocessen en biedt functies zoals automatisch herstarten van een proces bij een crash, het bijhouden van de status van de processen en het in- en uitschakelen van processen op afstand.

Hoe installeer ik PM2

Installeer PM2 via npm (Node Package Manager). Voer onderstaande commando uit op de CLI:

npm install pm2@latest -g

Het gebruik van PM2

1. Maak een .pm2 directory aan in /home/username;

2. Maak in deze folder een .json file aan met de opdracht voor PM2. Als voorbeeld onderstaand een queue runner voor Laravel.

   • Maak het bestand 'queue.conf.json' aan met onderstaande inhoud:

{
        "name": "queue",
        "script": "/usr/bin/php8.1 /home/username/domains/shockmedia.nl/current/artisan horizon",
        "log_file": "/home/username/.pm2/logs/queue-out.log",
}

3. Start de applicatie door op de CLI in te geven: pm2 start ~/.pm2/queue.conf.json

4. Om er voor te zorgen dat bij een herstart van de server het pm2 proces weer start is het noodzakelijk onderstaande commando op de CLI uit te voeren. Geef de output door aan ons per mail (support@shockmedia.nl), wij verwerken dit verder. Dit is per gebruiker een eenmalige actie.

pm2 startup systemd

5. Basis pm2 commando's:

• pm2 list (toon alle applicaties gemanaged door pm2)
• pm2 stop <id|name> (stop een applicatie)
• pm2 start <id|name> (start een applicatie)
• pm2 restart <id|name> (herstart een applicatie)
• pm2 logs <id|name> (toon de logs)
• pm2 delete <id|name> (verwijder een applicatie)
• pm2 save (belangrijk om door te voeren naar wijzigingen, de huidige status wordt opgeslagen en hersteld wanneer wij de server herstarten.)

Zie voor meer informatie ook de quick-start pagina van pm2: https://pm2.keymetrics.io/docs/usage/quick-start/