Nx-PM2 Plugin

The nx-pm2-plugin serves as a high-functionality add-on for an Nx monorepo, designed to facilitate the execution of any Node.js applications utilizing the pm2 process manager. This plugin offers seamless integration, optimizing the management and maintenance of your application's runtime processes.

Installation

Use the package manager npm to install nx-pm2-plugin.

1
2npm  install  nx-pm2-plugin
3

Usage

create a task in nx (example):

1"pm2": {
2	"executor": "nx-pm2-plugin:pm2-executor",
3	"options": {
4		"command": "nx-pm2-example:serve:production",
5		"name": "example"
6	}
7}

execute task

1npx nx run  nx-pm2-example:pm2
2

Documentation

Executor options

(Shema):

Property	Type	Description
name	string	The name of the application
instances	number	Number of instances to start, if set, automatically in cluster mode
max_memory_restart	string	Max memory amount after which app needs to restart
log_date_format	string	Date format for logs
merge_logs	boolean	Whether to merge logs
autorestart	boolean	Whether to auto-restart the application when it crashes or ends
log_file	string	Path to the file where both out and error logs will be written
out_file	string	Path to the file where application stdout will be written
error_file	string	Path to the file where application stderr will be written
pid_file	string	Path to the file where application pid will be written
command	string	Nx project command to be executed by PM2

Picking up pm2 configuration from env:

In the following example the INSTANCE_NAME & NO_OF_INSTANCES will be picked up from process.env

1"pm2": {
2	"executor": "nx-pm2-plugin:pm2-executor",
3	"dependsOn": ["build"],
4	"options": {
5		"command": "nx-pm2-example:serve:production",
6		"instances": "${NO_OF_INSTANCES}",
7		"name": "${INSTANCE_NAME}"
8	}
9}
10

Mandatory options:

The following executor options are mandatory:

Property	Type	Description
command	string	Nx project command to be executed by PM2
name	string	The name of the PM2 instance

Test

To run tests, use the following command:

1
2npm test
3

License

MIT

Contact

If you have any questions or need further clarification, feel free to reach out.

• Github: Jonathan Dsouza

• Email: mail2jona@yahoo.com

Changelog

See the CHANGELOG.md file for details.