1、快速开始

快速开始

安装

http://events.jianshu.io/p/83ec9235b1de

https://pm2.keymetrics.io/docs/usage/pm2-doc-single-page/

通过 NPM 或 Yarn 安装 最新的 PM2 版本：

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

要安装 Node.js 和 NPM，你可以使用NVM

启动应用程序

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

$ pm2 start app.js

或者轻松启动任何其他应用程序：

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

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

# Specify an app name
--name <app_name>

# Watch and Restart app when files change
--watch

# Set memory threshold for app reload
--max-memory-restart <200MB>

# Specify log file
--log <log_path>

# Pass extra arguments to the script
-- arg1 arg2 arg3

# Delay between automatic restarts
--restart-delay <delay in ms>

# Prefix logs with time
--time

# Do not auto restart app
--no-autorestart

# Specify cron for forced restart
--cron <cron_pattern>

# Attach to application log
--no-daemon

如您所见，有许多选项可用于使用 PM2 管理您的应用程序。您将根据您的用例发现它们。

管理进程

管理应用程序状态很简单，这里是命令：

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

而不是 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

集群模式

对于 Node.js 应用程序，PM2 包括一个自动负载均衡器，它将在每个衍生进程之间共享所有 HTTP[s]/Websocket/TCP/UDP 连接。

要以集群模式启动应用程序：

$ pm2 start app.js -i max

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

Ecosystem 文件

您还可以创建一个称为Ecosystem文件的配置文件来管理多个应用程序。要生成Ecosystem文件：

$ 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 ecosystem.config.js

在此处阅读有关申请声明的更多信息。

设置启动脚本

使用您在服务器启动/重新启动时管理的进程重新启动 PM2 至关重要。要解决这个问题，只需运行此命令以生成一个活动的启动脚本：

$ 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

我们让它变得简单，版本之间没有重大变化，过程很简单：

npm install pm2@latest -g

然后更新内存中的 PM2 ：

pm2 update

备忘单

以下是一些值得了解的命令。只需使用示例应用程序或开发机器上当前的 Web 应用程序来尝试它们：

# 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 information 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监控您的生产应用程序。

如何更新PM2

安装最新的 pm2 版本：

npm install pm2@latest -g

然后更新内存中的 PM2 ：

pm2 update