egg-cluster

Cluster Manager for EggJS

---

Install

npm i egg-cluster --save

Usage

const startCluster = require('egg-cluster').startCluster;
startCluster({
  baseDir: '/path/to/app',
  framework: '/path/to/framework',
});

You can specify a callback that will be invoked when application has started. However, master process will exit when catch an error.

startCluster(options, () => {
  console.log('started');
});

Options

Param	Type	Description
baseDir	String	directory of application
framework	String	specify framework that can be absolute path or npm package
plugins	Object	plugins for unittest
workers	Number	numbers of app workers
sticky	Boolean	sticky mode server
port	Number	port
reusePort	Boolean	(Required Node.js >= 22.12.0) allows multiple sockets on the same host to bind to the same port. Incoming connections are distributed by the operating system to listening sockets. This option is available only on some platforms, such as Linux 3.9+, DragonFlyBSD 3.6+, FreeBSD 12.0+, Solaris 11.4, and AIX 7.2.5+. Default: false
debugPort	Number	the debug port only listen on http protocol
https	Object	start a https server, note: key / cert / ca should be full path to file
require	Array|String	will inject into worker/agent process
pidFile	String	will save master pid to this file
startMode	String	default is 'process', use 'worker_threads' to start the app & agent worker by worker_threads
ports	Array	startup port of each app worker, such as: [7001, 7002, 7003], only effects when the startMode is 'worker_threads' and reusePort is false
env	String	custom env, default is process.env.EGG_SERVER_ENV

Env

EGG_APP_CLOSE_TIMEOUT: app worker boot timeout value

EGG_AGENT_CLOSE_TIMEOUT: agent worker boot timeout value

License

MIT

Contributors

Made with contributors-img.