Commandes CLI PM2, gestion de processus Node.js, monitoring, logs, redémarrages automatiques et déploiement. Guide pratique pour développeurs et DevOps cherchant à optimiser la performance et la stabilité de leurs applications.
pm2 start app.jsDémarre une application Node.js avec PM2
--name-n--instances-i--watch--ignore-watch--max-memory-restart--max-restarts--min-uptime--kill-timeout--restart-delay--time--no-autorestart--cron--no-daemon--env--interpreter--node-args--log-l--output-o--error-e--merge-logs--log-date-format--disable-logs--attach-a--listen-timeout--wait-ready--shutdown-with-message--force-f
pm2 start app.js --name mon-apiDémarre avec un nom personnalisé
--name-n
pm2 start app.js -i maxDémarre en mode cluster (tous les CPU)
-i--instances
pm2 start app.js -i 4Démarre avec 4 instances
-i--instances
pm2 start app.js --watchDémarre avec rechargement automatique (watch)
--watch--ignore-watch
pm2 start app.js --watch --ignore-watch="node_modules|logs|.git"Watch avec exclusion de dossiers
--watch--ignore-watch
pm2 start app.js --max-memory-restart 500MRedémarre si la mémoire dépasse 500 Mo
--max-memory-restart
pm2 start app.js --cron "0 0 * * *"Redémarre selon une expression cron (minuit)
--cron
pm2 start app.js --no-autorestartDésactive le redémarrage automatique
--no-autorestart
pm2 start app.js --env productionDémarre avec l'environnement production
--env
pm2 start app.js --node-args="--max-old-space-size=4096"Passe des arguments à Node.js
--node-args
pm2 start app.js -- --port=3000Passe des arguments à l'application
--
pm2 start app.js -l combined.log -o out.log -e err.logDéfinit les fichiers de logs
-l--log-o--output-e--error
pm2 start app.js --merge-logsFusionne les logs de toutes les instances
--merge-logs
pm2 start app.js --log-date-format "YYYY-MM-DD HH:mm:ss"Format personnalisé des dates dans les logs
--log-date-format
pm2 start app.js --disable-logsDésactive l'écriture des logs
--disable-logs
pm2 start app.js --wait-ready --listen-timeout 10000Attend que l'application soit prête (10s)
--wait-ready--listen-timeout
pm2 start app.js --kill-timeout 5000Timeout de 5s avant kill forcé
--kill-timeout
pm2 start npm --name "mon-app" -- run startDémarre un script npm
--name
pm2 start yarn --name "mon-app" -- startDémarre un script yarn
--name
pm2 start pnpm --name "mon-app" -- startDémarre un script pnpm
--name
pm2 start python --name "mon-script" -- script.pyDémarre un script Python
--name--interpreter
pm2 start "java -jar monapp.jar" --name "mon-java"Démarre une application Java
--name
pm2 start "python -m http.server 8080" --name "http-server"Démarre un serveur HTTP Python
--name
pm2 start ecosystem.config.jsDémarre avec un fichier de configuration
--only--env--no-daemon--attach
pm2 start ecosystem.config.js --only mon-apiDémarre uniquement une application spécifique
--only
pm2 start ecosystem.config.js --env productionDémarre avec l'environnement production
--env
pm2 stop mon-apiArrête une application
all--silent
pm2 stop allArrête toutes les applications
pm2 restart mon-apiRedémarre une application
--update-env--cron-restart--env
pm2 restart mon-api --update-envRedémarre en mettant à jour les variables d'environnement
--update-env
pm2 restart allRedémarre toutes les applications
pm2 reload mon-apiRecharge sans downtime (0-second reload)
--update-env--env
pm2 reload allRecharge toutes les applications sans downtime
pm2 reload ecosystem.config.js --only mon-apiRecharge depuis le fichier ecosystem
--only
pm2 gracefulReload allRecharge gracieuse (envoie SIGUSR2)
pm2 delete mon-apiSupprime une application de PM2
all
pm2 delete allSupprime toutes les applications
pm2 listListe toutes les applications gérées par PM2
--sort--json--help
pm2 lsAlias de pm2 list
--sort
pm2 statusAlias de pm2 list
--sort
pm2 show mon-apiAffiche les détails d'une application
--json
pm2 desc mon-apiAlias de pm2 show
pm2 info mon-apiAlias de pm2 show
pm2 describe mon-apiAlias de pm2 show
pm2 logsAffiche les logs de toutes les applications
--raw--json--format--timestamp--lines-n--err--out--nostream--highlight
pm2 logs mon-apiAffiche les logs d'une application spécifique
--lines-n--err--out--timestamp
pm2 logs mon-api --lines 100Affiche les 100 dernières lignes
--lines-n
pm2 logs --errAffiche uniquement les logs d'erreur
--err
pm2 logs --outAffiche uniquement les logs de sortie
--out
pm2 logs --rawAffiche les logs bruts (sans formatage)
--raw
pm2 logs --jsonAffiche les logs au format JSON
--json
pm2 logs --timestampForce l'affichage des timestamps
--timestamp
pm2 flushVide tous les fichiers de logs
pm2 flush mon-apiVide les logs d'une application
pm2 reloadLogsRecharge les fichiers de logs (après rotation)
pm2 monitOuvre le monitoring en temps réel
pm2 monitorAlias de pm2 monit
pm2 scale mon-api 4Scale l'application à 4 instances
+n-n
pm2 scale mon-api +2Ajoute 2 instances
+n
pm2 scale mon-api -1Retire 1 instance
-n
pm2 saveSauvegarde la liste des processus pour redémarrage
--force-f
pm2 save --forceForce la sauvegarde
--force-f
pm2 resurrectRestaure les processus précédemment sauvegardés
pm2 unstartupDésactive le démarrage automatique
platform
pm2 startupConfigure le démarrage automatique au boot
systemdupstartlaunchdrcdopenrcvsystem
pm2 startup systemdConfigure pour systemd (Linux)
-u--user--hp--service-name
pm2 startup systemd -u monuserConfigure pour un utilisateur spécifique
-u--user
pm2 startup upstartConfigure pour Upstart (Ubuntu 14.04)
pm2 startup launchdConfigure pour launchd (macOS)
pm2 unstartup systemdDésactive le démarrage automatique pour systemd
pm2 pingVérifie la connexion à PM2
pm2 updateMet à jour PM2 en mémoire (après mise à jour npm)
pm2 updatePM2Alias de pm2 update
pm2 killTue le démon PM2
pm2 reset mon-apiRéinitialise les compteurs de redémarrage
all
pm2 reset allRéinitialise tous les compteurs
pm2 sendSignal SIGUSR2 mon-apiEnvoie un signal à une application
SIGINTSIGTERMSIGUSR1SIGUSR2SIGHUP
pm2 env 0Affiche les variables d'environnement de l'instance 0
id
pm2 jlistListe au format JSON
pm2 prettylistListe au format JSON formaté
pm2 reportGénère un rapport de diagnostic complet
pm2 link <secret> <public>Lie l'instance à PM2 Plus (Keymetrics)
--name
pm2 unlinkDélie l'instance de PM2 Plus
pm2 webLance l'API web de monitoring (port 9615)
--port--host--help
pm2 web --port 8080 --host 0.0.0.0Lance l'API web sur un port personnalisé
--port--host
pm2 serve /chemin/vers/dossier 8080Sert un dossier statique via HTTP
--name--spa--basic-auth-username--basic-auth-password--help
pm2 serve /var/www/html 8080 --name mon-site --spaSert un site SPA (Single Page Application)
--name--spa
pm2 serve /var/www/html 8080 --basic-auth-username admin --basic-auth-password secretSert avec authentification basique
--basic-auth-username--basic-auth-password
pm2 deploy ecosystem.config.js production setupConfigure le déploiement sur le serveur distant
setupupdaterevertexeclist
pm2 deploy ecosystem.config.js productionDéploie l'application sur l'environnement production
--force
pm2 deploy ecosystem.config.js production revert 1Revient au déploiement précédent
revert
pm2 deploy ecosystem.config.js production exec "npm run migrate"Exécute une commande sur le serveur distant
exec
pm2 deploy ecosystem.config.js listListe les déploiements disponibles
list
pm2 ecosystemGénère un fichier ecosystem.config.js de base
--help
pm2 initAlias de pm2 ecosystem
pm2 generateGénère un fichier de configuration JSON
jsonjsyaml
pm2 install pm2-logrotateInstalle le module de rotation des logs
installuninstallstartstoprestartlistpublishhelp
pm2 module:install pm2-logrotateAlias de pm2 install
pm2 uninstall pm2-logrotateDésinstalle un module
uninstall
pm2 list-modulesListe les modules installés
pm2 module:listAlias de pm2 list-modules
pm2 conf <module> set <key> <value>Configure un module
setgetdeleteclear
pm2 set pm2-logrotate:max_size 10MDéfinit la taille max des logs à 10 Mo
set
pm2 set pm2-logrotate:retain 30Garde 30 fichiers de logs
set
pm2 set pm2-logrotate:compress trueActive la compression des logs
set
pm2 install pm2-server-monitInstalle le module de monitoring serveur
install
pm2 install pm2-mongodbInstalle le module MongoDB
install
pm2 install pm2-mysqlInstalle le module MySQL
install
pm2 install pm2-redisInstalle le module Redis
install
pm2 install pm2-elasticsearchInstalle le module Elasticsearch
install
pm2 install pm2-postgresInstalle le module PostgreSQL
install
pm2 interact <secret> <public>Connecte PM2 à PM2 Plus (Keymetrics)
--info_node
pm2 trigger <app_name> <action_name> <params>Déclenche une action personnalisée
--help
pm2 pull <app_name>Met à jour le code depuis Git (déploiement)
pm2 forward <app_name>Redémarre après pull (déploiement)
pm2 backward <app_name>Revient à la version précédente (déploiement)
pm2 launch <app_name>Démarre l'application après déploiement
pm2 connect <secret> <public>Alias de pm2 link
pm2 disconnectAlias de pm2 unlink
pm2 axmActive le module d'actions personnalisées
pm2 runtimeLance PM2 en mode runtime (pour Docker)
startstoprestartreloaddeletelist
pm2-runtime start app.jsDémarre une application en mode runtime (Docker)
-i--instances--watch--env--name--no-autorestart--max-memory-restart
pm2-runtime start ecosystem.config.jsDémarre depuis ecosystem en mode runtime
--only--env
pm2-docker start app.jsAlias de pm2-runtime (déprécié)
pm2 status --no-colorAffiche le statut sans couleurs
--no-color
pm2 list --sort [name|id|pid|memory|cpu|status|uptime]Trie la liste des processus
--sort
pm2 list --sort memoryTrie par utilisation mémoire
--sort
pm2 attach mon-apiAttache à l'application pour voir les logs en direct
pm2 launch <app_name> <action>Lance une action de déploiement
pre-deploypost-deploy
pm2 publish <app_name>Publie une application sur PM2 Plus
pm2 save --forceForce la sauvegarde de la configuration
--force-f
pm2 dumpAlias de pm2 save
pm2 kill --timeout 10000Tue PM2 après un timeout
--timeout
pm2 send SIGINT mon-apiEnvoie SIGINT à l'application
pm2 send SIGTERM allEnvoie SIGTERM à toutes les applications
pm2 start app.js --max-restarts 10Limite à 10 redémarrages
--max-restarts
pm2 start app.js --min-uptime 10000Considère l'application stable après 10s
--min-uptime
pm2 start app.js --restart-delay 5000Délai de 5s avant redémarrage
--restart-delay
pm2 start app.js --timeAjoute un timestamp aux logs
--time
pm2 start app.js --namespace productionDéfinit un namespace pour l'application
--namespace
pm2 start app.js --disable-source-map-supportDésactive le support des source maps
--disable-source-map-support
pm2 start app.js --public <key>Associe à un bucket PM2 Plus
--public
pm2 start app.js --machine-name <name>Définit le nom de la machine pour PM2 Plus
--machine-name
pm2 start app.js --unique-name <name>Nom unique pour PM2 Plus
--unique-name
pm2 start app.js --treekillTue l'arbre de processus complet
--treekill--no-treekill
pm2 start app.js --kill-retry-time 100Temps entre les tentatives de kill (ms)
--kill-retry-time
pm2 start app.js --vizionActive l'intégration Git (Vizion)
--vizion--no-vizion
pm2 start app.js --versioningActive le versioning
--versioning
pm2 start app.js --post-start <command>Exécute une commande après le démarrage
--post-start
