Skip to main content

快速开始

概述

PM2 是一个守护进程管理工具,帮助您管理和守护您的应用程序。它以简单直观的 C​​LI 命令行方式进行工作。

安装

最新的 PM2 版本可以使用 NPMYarn 安装:

$ npm install pm2@latest -g
# or
$ yarn global add pm2

启动应用

启动、守护和监控应用程序的最简单方法是使用以下命令行:

$ pm2 start app.js

或很容易启动任何其他应用程序:

$ pm2 start bashscript.sh
$ pm2 start python-app.py --watch
$ pm2 start binary-file -- --port 1520

您可以传递给 CLI 的一些选项:

# 指定应用程序名称
--name <app_name>

# 当文件改变时,观察并重新启动应用程序
--watch

# 设置应用程序重新加载的内存阈值
--max-memory-restart <200MB>

# 指定日志文件
--log <log_path>

# 向脚本传递额外的参数
-- arg1 arg2 arg3

# 自动重启延迟
--restart-delay <delay in ms>

# 使用时间作为日志前缀
--time

# 不自动重启应用程序
--no-autorestart

# 指定cron强制重启
--cron <cron_pattern>

# 附加到应用程序日志
--no-daemon

管理应用

管理应用程序状态很简单,命令如下:

$ pm2 restart app_name
$ pm2 reload app_name
$ pm2 stop app_name
$ pm2 delete app_name

指令范围:

  • all 所有
  • id 特定id

进程检查

现在你已经启动了这个应用程序,你可以检查它的状态、日志、指标,甚至可以使用pm2.io获取在线监控面板。

列出应用程序

列出 PM2 管理的所有应用程序的状态:

$ pm2 [list|ls|status]

查看日志

查看实时日志:

$ pm2 logs

指定日志行数:

$ pm2 logs --lines 200

查看监控信息

$ pm2 monit

pm2.io:监控和诊断 Web 界面

基于 Web 的仪表板,带有诊断系统的跨服务器:

$ pm2 plus

负载均衡

PM2 内置自动负载均衡器,它将在每个进程之间共享所有 HTTP[s]/Websocket/TCP/UDP 连接。

在集群模式下启动应用程序:

$ pm2 start app.js -i max

在此处阅读有关集群模式的更多信息。

ecosystem配置文件

您还可以创建一个名为 Ecosystem File 的配置文件来管理多个应用程序。

$ pm2 ecosystem

这将生成一个 ecosystem.config.js 文件:

module.exports = {
apps : [{
name: "app",
script: "./app.js",
env: {
NODE_ENV: "development",
},
env_production: {
NODE_ENV: "production",
}
}, {
name: 'worker',
script: 'worker.js'
}]
}

启动:

$ pm2 start process.yml

在此处阅读有关应用程序声明的更多信息。

开机启动

启动:

$ pm2 startup

保存:

$ pm2 save

在此处阅读有关启动脚本的更多信息。

应用监听

--watch选项很简单:

$ cd /path/to/my/app
$ pm2 start env.js --watch --ignore-watch="node_modules"

这将在当前目录 + 所有子文件夹中的任何文件更改时监视并重新启动应用程序,并且它将忽略 node_modules 文件夹中的任何更改--ignore-watch="node_modules"

然后,您可以使用pm2 logs来检查重新启动的应用程序日志。

更新PM2

全局安装新最版本的PM2:

$ npm install pm2@latest -g

然后更新内存中的 PM2

$ pm2 update

命令列表

# Fork mode
pm2 start app.js --name my-api # Name process

# Cluster mode
pm2 start app.js -i 0 # Will start maximum processes with LB depending on available CPUs
pm2 start app.js -i max # Same as above, but deprecated.
pm2 scale app +3 # Scales `app` up by 3 workers
pm2 scale app 2 # Scales `app` up or down to 2 workers total

# Listing

pm2 list # Display all processes status
pm2 jlist # Print process list in raw JSON
pm2 prettylist # Print process list in beautified JSON

pm2 describe 0 # Display all informations about a specific process

pm2 monit # Monitor all processes

# Logs

pm2 logs [--raw] # Display all processes logs in streaming
pm2 flush # Empty all log files
pm2 reloadLogs # Reload all logs

# Actions

pm2 stop all # Stop all processes
pm2 restart all # Restart all processes

pm2 reload all # Will 0s downtime reload (for NETWORKED apps)

pm2 stop 0 # Stop specific process id
pm2 restart 0 # Restart specific process id

pm2 delete 0 # Will remove process from pm2 list
pm2 delete all # Will remove all processes from pm2 list

# Misc

pm2 reset <process> # Reset meta data (restarted time...)
pm2 updatePM2 # Update in memory pm2
pm2 ping # Ensure pm2 daemon has been launched
pm2 sendSignal SIGUSR2 my-app # Send system signal to script
pm2 start app.js --no-daemon
pm2 start app.js --no-vizion
pm2 start app.js --no-autorestart

进一步了解

了解如何将应用程序的所有选项声明到JSON 配置文件中。

了解如何进行通过脚本停止和重新启动应用程序以提高可靠性。

了解如何轻松部署和更新生产应用程序。

使用PM2.io监控您的生产应用程序。