Guide Complet sur PM2

Installation de PM2

Pour installer PM2 globalement sur votre système, utilisez la commande suivante :

npm install pm2 -g

Cela installera PM2 en tant que commande globale, accessible depuis n'importe quel répertoire dans votre terminal1.

Lancement de Scripts ou de Sites NPM avec PM2

Démarrer une Application

Pour démarrer une application Node.js avec PM2, utilisez la commande suivante dans le répertoire de votre projet :

pm2 start app.js

Remplacez app.js par le point d'entrée de votre application.

Démarrer un Script NPM

Si votre projet utilise un script NPM défini dans le fichier package.json, vous pouvez le démarrer avec PM2 comme suit :

pm2 start npm -- run <script-name>

Remplacez <script-name> par le nom du script défini dans votre package.json.

Options de Démarrage

Vous pouvez également spécifier des options supplémentaires lors du démarrage, telles que le nombre d'instances, le mode cluster, et les variables d'environnement :

pm2 start app.js --name "my-app" -i 4 --watch

• --name "my-app" : Donne un nom à votre application.
• -i 4 : Démarre 4 instances de l'application (mode cluster).
• --watch : Redémarre l'application automatiquement lorsque des modifications de fichiers sont détectées.

Gestion des Logs

PM2 facilite la gestion des logs. Vous pouvez afficher les logs en temps réel avec la commande suivante :

pm2 logs

pm2 logs my-app

Sauvegarde et Démarrage Automatique

Sauvegarder la Liste des Processus

Pour sauvegarder la liste des processus gérés par PM2, utilisez :

pm2 save

Cela créera un fichier de sauvegarde qui peut être utilisé pour restaurer les processus plus tard.

Générer un Script de Démarrage

Pour générer un script de démarrage qui redémarre automatiquement vos applications PM2 au démarrage du serveur, utilisez :

pm2 startup

Cette commande génère un script adapté à votre système d'exploitation et affiche les instructions pour l'activer.

Restaurer les Processus

Pour restaurer les processus sauvegardés, utilisez :

pm2 resurrect

Surveillance et Gestion

Surveiller les Applications

PM2 offre une interface de surveillance en temps réel. Vous pouvez l'activer avec :

pm2 monit

Arrêter et Redémarrer les Applications

Pour arrêter une application :

pm2 stop my-app

 

Pour redémarrer une application :

pm2 restart my-app

Supprimer une Application

Pour supprimer une application de la liste PM2 :

pm2 delete my-app

Conclusion

PM2 est un outil puissant pour gérer les applications Node.js en production. Avec ses fonctionnalités de gestion des processus, de surveillance, et de démarrage automatique, il simplifie grandement le déploiement et la maintenance des applications.