image.png

1.Docker 集成

使用容器?我们得到了你的支持。从今天开始使用pm2-runtime,这是在生产环境中充分利用 Node.js 的完美伴侣。
pm2-runtime 的目标是将您的应用程序包装到合适的 Node.js 生产环境中。它解决了在容器内运行 Node.js 应用程序时的主要问题,例如:

  • 高应用程序可靠性的第二个进程回退
  • 流程控制
  • 自动应用程序监控,使其始终保持理智和高性能
  • 自动源映射发现和解析支持

此外,使用 PM2 作为容器和应用程序之间的层带来了 PM2 强大的功能,如应用程序声明文件可定制的日志系统和其他强大的功能,可以在生产环境中管理您的 Node.js 应用程序。

2.在容器内使用 PM2

在你的 Dockerfile 中添加这一行来安装 PM2:

  1. RUN npm install pm2 -g

然后将node二进制文件替换为pm2-runtime

CMD ["node", "app.js"]

到:

CMD ["pm2-runtime", "app.js"]

你现在一切都准备好了!您的 Node.js 应用程序现在已封装到适当的 Node.js 生产环境中。

2.1.启动配置文件

您可以将原始 Node.js 应用程序声明为配置文件(或进程文件)并设置一些配置变量,例如启用集群模式,而不是使用 PM2 运行原始 Node.js 应用程序。

让我们使用以下内容创建一个 ecosystem.config.js 文件:

module.exports = [{
  script: 'app.js',
  name: 'app',
  exec_mode: 'cluster',
  instances: 2
}, {
  script: 'worker.js',
  name: 'worker'
}]

此处列出了所有可用选项。

然后,您可以通过以下方式替换CMD指令:

CMD ["pm2-runtime", "process.yml"]

要在其自己的 Docker 中拆分每个进程,您可以使用 –only [app-name] 选项:

CMD ["pm2-runtime", "process.yml", "--only", "APP"]

2.2.将 exec_mode 集群与 nuxtjs 一起使用

在集群模式下运行ecosystem.config.jspm2 时,由于 nuxtjs 解析其 rootDir 的方式,将附加到您的 cwd 路径,以解决您必须在 args 部分指定配置路径的问题:

module.exports = {
  apps: [
    {
      name: 'my-nuxtjs-app',
      exec_mode: 'cluster',
      instances: 2,
      cwd: '/var/www',
      script: './node_modules/nuxt-start/bin/nuxt-start.js',
      args: '-c /var/www/nuxt.config.js'
    }
  ]
}

2.3.记录格式选项

如果要更改日志输出格式,可以选择以下选项之一:

  • –json : 将以 JSON 格式输出日志 (logstash)
  • –format : 将以 = 样式格式输出日志
  • –raw : 将按原样输出日志

要使用此标志之一,您只需将它们传递给 pm2-runtime:

CMD ["pm2-runtime", "--json", "process.yml"]

2.4.启用正常关机

当容器收到关闭信号时,PM2 将此信号转发给您的应用程序,允许关闭所有数据库连接,等待所有查询都已处理或任何其他最终处理已完成,然后才能成功正常关闭。

捕捉关机信号很简单。您需要在 Node.js 应用程序中添加一个侦听器并在停止应用程序之前执行所需的任何操作:

process.on('SIGINT', function() {
   db.stop(function(err) {
     process.exit(err ? 1 : 0);
   });
});

默认情况下,PM2 在发送最终 SIGKILL 信号之前将等待 1600 毫秒。您可以通过设置kill_timeout应用程序配置文件中的选项来修改此延迟。

在此处阅读有关应用程序状态管理的更多信息

2.5.开发环境

您可能希望告诉开发人员在容器内编程,以在开发、测试和生产之间保持一致的环境。

pm2-dev替换pm2-runtime将启用监视和重启功能。当主机文件作为 VOLUME 公开给容器时,这在开发容器中非常有趣。

2.6.使用 PM2.io

Keymetrics.io是一个建立在 PM2 之上的监控服务,它允许轻松监控和管理应用程序(日志、重启、异常监控……)。在 Keymetrics 上创建 Bucket 后,您将获得一个公钥和一个私钥。

要使用 pm2 -runtime启用 Keymetrics 监控,您可以使用 CLI 选项–public XXX–secret YYY或传递环境变量KEYMETRICS_PUBLICKEYMETRICS_SECRET

通过 Dockerfile 使用 CLI 选项的示例:

CMD ["pm2-runtime", "--public", "XXX", "--secret", "YYY", "process.yml"]

或者通过环境变量:

ENV PM2_PUBLIC_KEY=XXX
ENV PM2_SECRET_KEY=YYY

或者通过 Docker 运行命令:

docker run --net host -e "PM2_PUBLIC_KEY=XXX" -e "PM2_SECRET_KEY=XXX" <...>

3.pm2-运行时助手

这是 pm2-runtime 助手:

>>> pm2-runtime -h

  Usage: pm2-runtime app.js

  pm2 runtime是替换node.js二进制文件中的一个插件,具有一些有趣的生产特性

  Options:

    -V, --version              输出版本号
    -i --instances <number>    启动自动负载平衡的进程[数量]。提高整体性能和性能稳定性。
    --secret [key]             [监控]keymetrics密钥
    --public [key]             [监控]keymetrics公钥
    --machine-name [name]      [监控]keymetrics计算机名称
    --raw                      原始日志输出
    --json                     json格式的输出日志
    --format                   格式化为 key=val 的输出日志
    --delay <seconds>          将配置文件的启动延迟<秒>
    --web [port]               在[端口]上启动进程web api(默认为9615)
    --only <application-name>  仅对配置的一个应用程序执行操作
    --no-auto-exit             如果所有进程都出错/停止或启动了0个应用程序,请不要退出
    --env [name]               在流程配置文件中注入环境变量
    --watch                    在文件更改时监视并重新启动应用程序
    --error <path>             错误日志文件目标(默认禁用)
    --output <path>            输出日志文件目标(默认禁用)
    -h, --help                 输出使用信息


  Commands:

    *
    start <app.js|json_file>  start an application or json ecosystem file