pm2 常用命令:
### 普通General
npm install pm2 -g # 安装 PM2
pm2 start app.js # 启动,守护进程,自动重启应用程序 Start, Daemonize and auto-restart application (Node)
pm2 start app.py # 启动,守护进程,自动重启python应用程序 Start, Daemonize and auto-restart application (Python)
pm2 start npm -- start # 启动,守护进程,自动重启node应用程序 Start, Daemonize and auto-restart Node application
pm2 start npm --name test -- run dev # 执行 npm run dev , 并命名进程为 test
pm2 start npm --name test -- start # 执行 npm start , 并命名进程为 test
### 集群模式 (只支持node进程) Cluster Mode (Node.js only)
pm2 start app.js -i 4 # 在集群模式下,启动4个应用程序实例 Start 4 instances of application in cluster mode
# 同时,将网络请求,负载均衡到每个应用实例 it will load balance network queries to each app
pm2 reload all # 0秒重启所有应用 Zero Second Downtime Reload
pm2 scale [app-name] 10 # 将应用进程调整到10 Scale Cluster app to 10 process
### 进程监控 Scale Cluster app to 10 process
pm2 list # 列出所有用PM2启动的进程 List all processes started with PM2
pm2 monit # 显示每个应用占用的cpu和内存 Display memory and cpu usage of each app
pm2 show [app-name] # 显示某个进程的所有信息 Show all informations about application
### 日志管理 Log management
pm2 logs # 显示所有应用的日志 Display logs of all apps
pm2 logs [app-name] # 显示某个应用的日志 Display logs for a specific app
pm2 logs --json # json化日志 Logs in JSON format
pm2 flush
pm2 reloadLogs
### 进程状态管理 Process State Management
pm2 start app.js --name="api" # 启动一个应用并命名为api。 Start application and name it "api"
pm2 restart app.js --name "newApi" # 重启一个应用并修改进程名字为 "newApi"
pm2 start app.js -- -a 34 # 启动一个应用,并传递“-a 34”的参数。 Start app and pass option "-a 34" as argument
pm2 start app.js --watch # 当文件改变时重启应用。Restart application on file change
pm2 start script.sh # 启动一个bash脚本。Start bash script
pm2 start app.json # 启动在app.json中声明的所有应用。Start all applications declared in app.json
### 你也可以执行用其他语言编写的app ( fork 模式):
pm2 start bash.sh -x --interpreter bash
pm2 start python.py -x --interpreter python
pm2 reset [app-name] # 重置所有计数器。Reset all counters
pm2 stop all # 停止所有应用。Stop all apps
pm2 stop 0 # 停止id 为0的应用。Stop process with id 0
pm2 restart all # 重启所有应用。Restart all apps
pm2 gracefulReload all # 在集群模式下,平稳的重加载所有应用。Graceful reload all apps in cluster mode
pm2 delete all # 杀掉所有应用。Kill and delete all apps
pm2 delete 0 # 杀掉id为0的进程。Delete app with id 0
### 启动/引导管理 Startup/Boot management
pm2 startup # 检测init系统,在启动时生成和配置pm2。Detect init system, generate and configure pm2 boot on startup
pm2 save # 保存当前进程列表。Save current process list
pm2 resurrect # 恢复以前保存的进程。Restore previously save processes
pm2 unstartup # 停用和删除启动系统。Disable and remove startup system
pm2 update # 保存进程,终止PM2并恢复进程。Save processes, kill PM2 and restore processes
pm2 generate # 生成样本json配置文件。Generate a sample json configuration file
### 部署 Deployment
pm2 deploy app.json prod setup # 设置“生产环境”远程服务器。 Setup "prod" remote server
pm2 deploy app.json prod # 更新“生产环境”远程服务器。 Update "prod" remote server
pm2 deploy app.json prod revert 2 # 将“生产环境”远程服务器恢复2。Revert "prod" remote server by 2
### 模块系统 Module system
pm2 module:generate [name] # 生成名称为[name]的示例模块。Generate sample module with name [name]
pm2 install pm2-logrotate # 安装模块(这里是日志循环系统)。Install module (here a log rotation system)
pm2 uninstall pm2-logrotate # 卸载模块。Uninstall module
pm2 publish # 增量版本,git push和npm发布。Increment version, git push and npm publish
配置文件启动pm2
pm2 支持配置 js、yml、json 文件格式。尤其 pm2 在管理多个应用程序的时候,使用配置文件管理更方便,js添加注释方便
常用配置项
module.exports = {
apps: [
{
name: "mini_bread", //项目进程名,方便后期查找操作
script: "bin/www", //启动文件
//修改日志文件目录,一定要停止pm2进程,然后运行指令 pm2 delete +进程id /all ,去删除进程,然后重新pm2启动才生效
error_file: "./logs/error.log", //出错日志存放目录,若禁用日志记录,值改为/dev/null
out_file: "./logs/run.log", //输出日志存放目录,若禁用日志记录,值改为/dev/null
merge_logs: true, //仅适用于集群模式 (node.js) 中的应用程序; 如果您希望集群进程的所有实例都登录到同一个文件中,您可以使用选项 --merge-logs 或 merge_logs: true
log_date_format: "YYYY-MM-DD HH:mm Z", //日志输出时间格式,指定格式日期
//watch: true, //监听文件改动,自动更新服务,这里不推荐写在配置文件中,如果停止服务,重新启动改动文件会发现失效,开启+停止服务只有在命令行后添加 --watch 才会真正生效
ignore_watch: ["node_modules", "logs"], // 忽略监听改动的文件夹
//instances : 3, //创建多少个进程实例
//exec_mode : "cluster", //集群模式,默认是fork单进程模式
// 在不同环境中的变量之间切换,请指定 --env [env name] 选项
// pm2 start xxx.js --env production
// pm2 restart xxx.js --env development
env_production: {
NODE_ENV: "production", //生产环境
},
env_development: {
NODE_ENV: "development", //开发环境
},
},
],
};
//注意:修改配置文件,需要删除创建的进程实例,重新启动才生效,修改配置项后搭配 pm2 save 指令一起使用
配置集群的例子:
┌────┬──────────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id │ name │ namespace │ version │ mode │ pid │ uptime │ ↺ │ status │ cpu │ mem │ user │ watching │
├────┼──────────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 6 │ mini_bread │ default │ 0.0.0 │ cluster │ 0 │ 0 │ 0 │ stopped │ 0% │ 0b │ songke │ disabled │
│ 7 │ mini_bread │ default │ 0.0.0 │ cluster │ 0 │ 0 │ 0 │ stopped │ 0% │ 0b │ songke │ disabled │
│ 8 │ mini_bread │ default │ 0.0.0 │ cluster │ 0 │ 0 │ 0 │ stopped │ 0% │ 0b │ songke │ disabled │
│ 4 │ www │ default │ 0.0.0 │ fork │ N/A │ 0 │ 4 │ stopped │ 0% │ 0b │ songke │ disabled │
└────┴──────────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘
常见场景:
1、开机自启动:
# 启动nodeJs应用
pm2 start pm2.config.js
# 创建开机自启动命令 (systemd 表示系统平台,为可选参数,不填写的话 pm2 会自动检测)
pm2 startup [systemd]
# 保存当前应用列表
pm2 save
image.png
image.png
2、升级pm2
1、保存进程
pm2 save
2、升级pm2
npm install pm2 -g
3、更新pm2
pm2 update
3、升级nodejs
升级Node.js版本时,节点二进制路径将更改。要更新PM2启动脚本,执行命令:
pm2 unstartup
pm2 startup
pm2-logrotate 日志管理
pm2管理日志的黄金搭档,它是依赖pm2运行的插件,可管理日志文件大小,对日志按日期分隔
安装指令:
pm2 install pm2-logrotate
常用配置项:
//修改配置项目,输入上面的单独一行命令,修改最后的值即可,修改完,重启 服务,执行命令:pm2 restart all
//提示:修改配置还有一种配置文件的方式,可自行百度并测试
pm2 set pm2-logrotate:max_size 10M //分隔触发的文件大小
pm2 set pm2-logrotate:retain 7 //文件数量最多存在数量
pm2 set pm2-logrotate:compress false //是否对分隔后的文件进行压缩
pm2 set pm2-logrotate:dateFormat YYYY-MM-DD_HH-mm-ss //文件日期后缀格式
pm2 set pm2-logrotate:workerInterval 30 //检查日志的定时时间(秒)
pm2 set pm2-logrotate:rotateInterval 0 0 * * * //日志分隔cron表达式,每天0点进行日志分隔
pm2 set pm2-logrotate:rotateModule true //是否把 pm2 本身的日志文件也进行分割,默认true
//查看最新的配置,可运行指令
pm2 conf pm2-logrotate
停止 pm2-logrotate服务
"旧版本"的 pm2-logrotate 想要停止,就只能卸载服务,卸载命令:"pm2 uninstall pm2-logrotate"
"新版本"的可使用 "pm2 list" 查看-> pm2-logrotate 进程id ,执行 "pm2 stop 进程id" 即可停止服务
cron表达式简单介绍:
* * * * * *
┬ ┬ ┬ ┬ ┬ ┬
│ │ │ │ │ |
│ │ │ │ │ └ day of week (0 - 7) (0 or 7 is Sun)
│ │ │ │ └───── month (1 - 12)
│ │ │ └────────── day of month (1 - 31)
│ │ └─────────────── hour (0 - 23)
│ └──────────────────── minute (0 - 59)
└───────────────────────── second (0 - 59, OPTIONAL)
https://ezdoc.cn/docs/pm2/general/process
https://pm2.keymetrics.io/docs/usage/quick-start/
网友评论