2.2、重启策略

重启策略

https://pm2.keymetrics.io/docs/usage/restart-strategies/

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

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

在 cron 时间重新启动

通过 CLI：

$ pm2 start app.js --cron-restart="0 0 * * *"
# Or when restarting an app
$ pm2 restart app --cron-restart="0 0 * * *"

通过配置文件，使用 cron_restart 属性：

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 重启：

pm2 restart app --cron-restart 0

重新启动文件更改

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

通过 CLI：

$ pm2 start app.js --watch

注意：如果应用程序以该选项启动--watch，则停止应用程序不会阻止它在文件更改时重新启动。要完全禁用手表功能，请执行以下操作：pm2 stop app --watch或通过在应用程序重新启动时切换手表选项pm2 restart app --watch。

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

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

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

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 秒启动一次，因此您可能需要稍等片刻达到内存阈值后，进程会自动重新启动。

命令行界面：

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

通过配置文件，使用max_memory_restart属性：

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

注：单位可以是 K(ilobyte)（如512K）、M（egabyte）（如128M）、G（igabyte）（如1G）。

延迟重启

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

命令行界面：

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

通过配置文件，使用restart_delay属性：

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

无自动重启

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

命令行界面：

$ pm2 start app.js --no-autorestart

通过配置文件，使用autorestart属性：

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

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

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

在这种情况下，您仍然可以使用 PM2 并stop_exit_codes设置一个选项以退出应该跳过自动重启的代码：

命令行界面：

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

或者通过配置文件，使用stop_exit_codes属性：

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

指数退避重启延迟

在 PM2 Runtime 上实现了一种新的重启模式，使您的应用程序以更智能的方式重启。当异常发生时（例如数据库关闭），指数退避重启将逐渐增加重启之间的时间，从而减少数据库或外部提供商的压力，而不是疯狂地重启您的应用程序……非常容易使用：

命令行界面：

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

通过配置文件，使用exp_backoff_restart_delay属性：

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

当应用程序意外崩溃并--exp-backoff-restart-delay激活该选项时，您将能够看到一个新的应用程序状态 waiting restart。

通过运行pm2 logs你还会看到重启延迟增加：

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 毫秒。