Restart

重启策略

当使用 PM2 启动应用程序时,应用程序会在自动退出、事件循环为空(node.js)或应用程序崩溃时自动重启。 但您也可以配置额外的重启策略,例如:

  • 在指定的 CRON 时间重启应用程序
  • 文件更改后重新启动应用程序
  • 当应用程序达到内存阈值时重新启动
  • 延迟启动和自动重启
  • 默认情况下崩溃或退出时禁用自动重启(应用程序始终使用 PM2 重启)
  • 在特定的指数增长时间自动重启应用程序

计划任务重启

通过 CLI:

bash
$ pm2 start app.js --cron-restart="0 0 * * *"
# 或者在重新启动应用程序时
$ pm2 restart app --cron-restart="0 0 * * *"

通过配置文件,使用cron_restart属性:

js
module.exports = {
  apps: [{
    name: 'Business News Watcher',
    script: 'app.js',
    instances: 1,
    cron_restart: '0 0 * * *',
    env: {
      NODE_ENV: 'development'
    },
    env_production: {
      NODE_ENV: 'production'
    }
  }]
}

要禁用 cron 重启:

bash
pm2 restart app --cron-restart 0

文件更改重启

当当前目录或其子目录中的文件被修改时,PM2 可以自动重启您的应用程序:

通过 CLI:

bash
$ pm2 start app.js --watch

如果应用程序是使用--watch选项启动的,停止应用程序不会阻止它在文件更改时重新启动。

要完全禁用手表功能,请执行: pm2 stop app --watch
通过 pm2 restart app --watch 在应用程序重启时切换手表选项。

通过配置文件,使用 watch: true 属性:

js
module.exports = {
  script: 'app.js',
  watch: true
}

您可以使用以下选项指定要监视更改的文件夹、忽略文件夹和监视文件间隔:

js
module.exports = {
  script: 'app.js',
  // Specify which folder to watch
  watch: ['server', 'client'],
  // Specify delay between watch interval
  watch_delay: 1000,
  // Specify which folder to ignore
  ignore_watch: ['node_modules', 'client/img'],
}

基于内存的重启策略

PM2 允许重新加载(如果不在集群中则自动回退以重新启动)基于内存限制的应用程序/请注意 PM2 内部工作程序(检查内存)每 30 秒启动一次,因此您可能需要稍等片刻 达到内存阈值后,进程会自动重新启动。

CLI:

bash
$ pm2 start api.js --max-memory-restart 300M

通过配置文件,使用 max_memory_restart 属性:

js
module.exports = {
  script: 'api.js',
  max_memory_restart: '300M'
}

注意:单位可以是 K(ilobyte)(例如 512K)、M(egabyte)(例如 128M)、G(igabyte)(例如 1G)。

重启延迟

使用 Restart Delay 策略设置自动重启之间的延迟:

CLI:

bash
$ pm2 start app.js --restart-delay=3000

通过配置文件,使用“restart_delay”属性:

js
module.exports = {
  script: 'app.js',
  restart_delay: 3000
}

没有自动重启

这在我们希望运行 1 次脚本并且不希望进程管理器在脚本完成运行时重新启动脚本的情况下很有用。

CLI:

bash
$ pm2 start app.js --no-autorestart

通过配置文件,使用 autorestart 属性:

js
module.exports = {
  script: 'app.js',
  autorestart: false
}

跳过特定退出代码的自动重启

有时您可能希望应用程序在出现故障时自动重启(即非零退出代码),而不希望进程管理器在正常关闭时重新启动它(即退出代码等于 0)。

在这种情况下,您仍然可以使用 PM2,将 stop_exit_codes 选项设置为应该跳过自动重启的退出代码:

CLI:

bash
$ pm2 start app.js --stop-exit-codes 0

或者通过配置文件,使用 stop_exit_codes 属性:

js
module.exports = [{
  script: 'app.js',
  stop_exit_codes: [0]
}]

指数退避重启延迟

在 PM2 Runtime 上实现了一种新的重启模式,使您的应用程序以更智能的方式重启。 exponential backoff restart 不会在异常发生时疯狂地重新启动您的应用程序,而是会逐渐增加重新启动之间的时间,从而减少您的数据库或外部供应商的压力......非常容易使用:

CLI:

bash
$ pm2 start app.js --exp-backoff-restart-delay=100

通过配置文件,使用 exp_backoff_restart_delay 属性:

js
module.exports = {
  script: 'app.js',
  exp_backoff_restart_delay: 100
}

当应用程序意外崩溃并激活选项 --exp-backoff-restart-delay 时,您将能够看到新的应用程序状态 等待重启

通过运行pm2 logs,您还将看到重启延迟增加:

bash
PM2 | App [throw:0] will restart in 100ms
PM2 | App [throw:0] exited with code [1] via signal [SIGINT]
PM2 | App [throw:0] will restart in 150ms
PM2 | App [throw:0] exited with code [1] via signal [SIGINT]
PM2 | App [throw:0] will restart in 225ms

如您所见,重启之间的重启延迟将以指数移动平均线增加,直到达到重启之间的最大值 15000 毫秒。

当应用程序返回稳定模式时(正常运行时间不超过 30 秒),重启延迟将自动重置为 0 毫秒。

文件更改时自动重启

当当前目录或其子目录中的文件被修改时,PM2 可以自动重启您的应用程序:

bash
pm2 start app.js --watch

或者通过配置文件设置选项 watch: true

如果应用程序是使用 --watch 选项启动的,停止应用程序不会阻止它在文件更改时重新启动。 要完全禁用手表功能,请执行:pm2 stop app --watch 或通过 pm2 restart app --watch 在应用程序重启时切换手表选项。

要查看特定路径,请使用生态系统文件watch 可以采用字符串或路径数组。 默认为“真”:

javascript
module.exports = {
  apps: [{
    script: 'app.js',
    watch: ['server', 'client'],
    // Delay between restart
    watch_delay: 1000,
    ignore_watch: ['node_modules', 'client/img'],
  }]
}