mirror of
https://github.com/Unitech/pm2.git
synced 2025-12-08 20:35:53 +00:00
250 lines
7.3 KiB
Markdown
250 lines
7.3 KiB
Markdown
<div align="center">
|
|
<br/>
|
|
<a href="http://pm2.io/doc/?utm_source=github" title="PM2 Keymetrics link">
|
|
<img width=710px src="https://raw.githubusercontent.com/Unitech/pm2/master/pres/pm2-v4.png" alt="pm2 logo">
|
|
</a>
|
|
<br/>
|
|
<br/>
|
|
<b>P</b>(rocess) <b>M</b>(anager) <b>2</b><br/>
|
|
<i>Runtime Edition</i>
|
|
<br/><br/>
|
|
|
|
<a href="https://badge.fury.io/js/pm2" title="NPM Version Badge">
|
|
<img src="https://badge.fury.io/js/pm2.svg" alt="npm version">
|
|
</a>
|
|
|
|
<a href="https://img.shields.io/node/v/pm2.svg" title="Node Limitation">
|
|
<img src="https://img.shields.io/node/v/pm2.svg" alt="node version">
|
|
</a>
|
|
|
|
<a href="https://travis-ci.org/Unitech/pm2" title="PM2 Tests">
|
|
<img src="https://travis-ci.org/Unitech/pm2.svg?branch=master" alt="Build Status"/>
|
|
</a>
|
|
|
|
|
|
<br/>
|
|
<br/>
|
|
<br/>
|
|
</div>
|
|
|
|
|
|
PM2 is a production process manager for Node.js applications with a built-in load balancer. It allows you to keep applications alive forever, to reload them without downtime and to facilitate common system admin tasks.
|
|
|
|
Starting an application in production mode is as easy as:
|
|
|
|
```bash
|
|
$ pm2 start app.js
|
|
```
|
|
|
|
PM2 is constantly assailed by [more than 1800 tests](https://travis-ci.org/Unitech/pm2).
|
|
|
|
Official website: [https://pm2.io/doc/](https://pm2.io/doc/)
|
|
|
|
Works on Linux (stable) & macOS (stable) & Windows (stable). All Node.js versions are supported starting Node.js 8.X.
|
|
|
|
[](https://nodei.co/npm/pm2/)
|
|
|
|
### Installing PM2
|
|
|
|
```bash
|
|
$ npm install pm2 -g
|
|
```
|
|
|
|
*npm is a builtin CLI when you install Node.js - [Installing Node.js with NVM](https://blog.pm2.io/2018-02-19/Installing-Node-js-with-NVM/)*
|
|
|
|
### Start an application
|
|
|
|
You can start any application (Node.js, Python, Ruby, binaries in $PATH...) like that:
|
|
|
|
```bash
|
|
$ pm2 start app.js
|
|
```
|
|
|
|
Your app is now daemonized, monitored and kept alive forever.
|
|
|
|
[More about Process Management](https://pm2.io/doc/en/runtime/guide/process-management/?utm_source=github)
|
|
|
|
### Container Support
|
|
|
|
With the drop-in replacement command for `node`, called `pm2-runtime`, run your Node.js application in a hardened production environment.
|
|
Using it is seamless:
|
|
|
|
```
|
|
RUN npm install pm2 -g
|
|
CMD [ "pm2-runtime", "npm", "--", "start" ]
|
|
```
|
|
|
|
[Read More about the dedicated integration](https://pm2.io/doc/en/runtime/integration/docker/?utm_source=github)
|
|
|
|
### Managing Applications
|
|
|
|
Once applications are started you can manage them easily:
|
|
|
|
|
|
|
|
To list all running applications:
|
|
|
|
```bash
|
|
$ pm2 list
|
|
```
|
|
|
|
Managing apps is straightforward:
|
|
|
|
```bash
|
|
$ pm2 stop <app_name|id|'all'|json_conf>
|
|
$ pm2 restart <app_name|id|'all'|json_conf>
|
|
$ pm2 delete <app_name|id|'all'|json_conf>
|
|
```
|
|
|
|
To have more details on a specific application:
|
|
|
|
```bash
|
|
$ pm2 describe <id|app_name>
|
|
```
|
|
|
|
To monitor logs, custom metrics, application information:
|
|
|
|
```bash
|
|
$ pm2 monit
|
|
```
|
|
|
|
[More about Application Management](https://pm2.io/doc/en/runtime/guide/process-management/?utm_source=github)
|
|
|
|
### Cluster Mode: Node.js Load Balancing & Zero Downtime Reload
|
|
|
|
The Cluster mode is a special mode when starting a Node.js application, it starts multiple processes and load-balance HTTP/TCP/UDP queries between them. This increase overall performance (by a factor of x10 on 16 cores machines) and reliability (faster socket re-balancing in case of unhandled errors).
|
|
|
|
Starting a Node.js application in cluster mode that will leverage all CPUs available:
|
|
|
|
```bash
|
|
$ pm2 start api.js -i <processes>
|
|
```
|
|
|
|
`<processes>` can be `'max'`, `-1` (all cpu minus 1) or a specified number of instances to start.
|
|
|
|
**Zero Downtime Reload**
|
|
|
|
Hot Reload allows to update an application without any downtime:
|
|
|
|
```bash
|
|
$ pm2 reload all
|
|
```
|
|
|
|
Seamlessly supported by all major Node.js frameworks and any Node.js applications without any code change:
|
|
|
|
|
|
|
|
[More informations about how PM2 make clustering easy](https://keymetrics.io/2015/03/26/pm2-clustering-made-easy/)
|
|
|
|
### Terminal Based Monitoring
|
|
|
|
|
|
|
|
Monitor all processes launched straight from the command line:
|
|
|
|
```bash
|
|
$ pm2 monit
|
|
```
|
|
|
|
### Log Management
|
|
|
|
To consult logs just type the command:
|
|
|
|
```bash
|
|
$ pm2 logs
|
|
```
|
|
|
|
Standard, Raw, JSON and formated output are available.
|
|
|
|
Examples:
|
|
|
|
```bash
|
|
$ pm2 logs APP-NAME # Display APP-NAME logs
|
|
$ pm2 logs --json # JSON output
|
|
$ pm2 logs --format # Formated output
|
|
|
|
$ pm2 flush # Flush all logs
|
|
$ pm2 reloadLogs # Reload all logs
|
|
```
|
|
|
|
[More about log management](https://pm2.io/doc/en/runtime/guide/log-management/?utm_source=github)
|
|
|
|
### Startup Hooks Generation
|
|
|
|
PM2 can generates and configure a Startup Script to keep PM2 and your processes alive at every server restart.
|
|
|
|
Init Systems Supported: **systemd**, **upstart**, **launchd**, **rc.d**
|
|
|
|
```bash
|
|
# Generate Startup Script
|
|
$ pm2 startup
|
|
|
|
# Freeze your process list across server restart
|
|
$ pm2 save
|
|
|
|
# Remove Startup Script
|
|
$ pm2 unstartup
|
|
```
|
|
|
|
[More about Startup Hooks](https://pm2.io/doc/en/runtime/guide/startup-hook/?utm_source=github)
|
|
|
|
### PM2 Modules
|
|
|
|
PM2 embeds a simple and powerful module system. Installing a module is straightforward:
|
|
|
|
```bash
|
|
$ pm2 install <module_name>
|
|
```
|
|
|
|
Here are some PM2 compatible modules (standalone Node.js applications managed by PM2):
|
|
|
|
[**pm2-logrotate**](https://www.npmjs.com/package/pm2-logrotate) automatically rotate logs and limit logs size<br/>
|
|
[**pm2-server-monit**](https://www.npmjs.com/package/pm2-server-monit) monitor the current server with more than 20+ metrics and 8 actions<br/>
|
|
|
|
### Updating PM2
|
|
|
|
```bash
|
|
# Install latest PM2 version
|
|
$ npm install pm2@latest -g
|
|
# Save process list, exit old PM2 & restore all processes
|
|
$ pm2 update
|
|
```
|
|
|
|
*PM2 updates are seamless*
|
|
|
|
## PM2+ Monitoring
|
|
|
|
|
|
|
|
If you manage your NodeJS app with PM2, PM2+ makes it easy to monitor and manage apps across servers. Feel free to try it:
|
|
|
|
[Discover the monitoring dashboard for PM2](https://app.pm2.io/)
|
|
|
|
Thanks in advance and we hope that you like PM2!
|
|
|
|
## More about PM2
|
|
|
|
- [Zero Downtime Reload](https://pm2.io/doc/en/runtime/guide/load-balancing/)
|
|
- [Watch File & Restart](https://pm2.io/doc/en/runtime/features/watch-restart/)
|
|
- [Restart Strategies](https://pm2.io/doc/en/runtime/features/restart-strategies/)
|
|
- [Startup Script Generation](https://pm2.io/doc/en/runtime/guide/startup-hook/)
|
|
- [Memory Limit Auto Reload](https://pm2.io/doc/en/runtime/features/memory-limit/)
|
|
- [Source Map Support](https://pm2.io/doc/en/runtime/features/javascript-source-maps/)
|
|
- [Using PM2 API](https://pm2.io/doc/en/runtime/reference/pm2-programmatic/)
|
|
- [Graceful Shutdown](https://pm2.io/doc/en/runtime/best-practices/graceful-shutdown/)
|
|
|
|
## CHANGELOG
|
|
|
|
[CHANGELOG](https://github.com/Unitech/PM2/blob/master/CHANGELOG.md)
|
|
|
|
## Contributors
|
|
|
|
[Contributors](http://pm2.keymetrics.io/hall-of-fame/)
|
|
|
|
## License
|
|
|
|
PM2 is made available under the terms of the GNU Affero General Public License 3.0 (AGPL 3.0).
|
|
For other licenses [contact us](mailto:contact@keymetrics.io).
|
|
|
|
[](https://github.com/igrigorik/ga-beacon)
|