https://github.com/strongloop/strong-cluster-control
cluster control module, allowing run-time control and monitoring of cluster
https://github.com/strongloop/strong-cluster-control
Last synced: 9 months ago
JSON representation
cluster control module, allowing run-time control and monitoring of cluster
- Host: GitHub
- URL: https://github.com/strongloop/strong-cluster-control
- Owner: strongloop
- License: other
- Created: 2013-07-04T22:56:02.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2018-11-27T23:31:57.000Z (about 7 years ago)
- Last Synced: 2025-05-05T03:42:05.344Z (9 months ago)
- Language: JavaScript
- Size: 196 KB
- Stars: 99
- Watchers: 23
- Forks: 9
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# strong-cluster-control
node cluster API wrapper and extensions
It is an extension of the node cluster module, not a replacement.
- runs `size` workers (optionally), and monitors them for unexpected death
- soft shutdown as well as hard termination of workers
- throttles worker restart rate if they are exiting abnormally
It can be added to an existing application using the node cluster module without
modifying how that application is currently starting up or using cluster, and
still make use of additional features.
This is a component of the StrongLoop process manager, see http://strong-pm.io.
## Install
npm install --save strong-cluster-control
## Example
To instantiate cluster-control:
```javascript
var cluster = require('cluster');
var control = require('strong-cluster-control');
// global setup here...
control.start({
size: control.CPUS
}).on('error', function(er) {
console.error(er);
});
if(cluster.isWorker) {
// do work here...
}
```
## API
See [api](./api.md).
## License
strong-cluster-control uses a dual license model.
You may use this library under the terms of the [Artistic 2.0 license][],
or under the terms of the [StrongLoop Subscription Agreement][].
[Artistic 2.0 license]: http://opensource.org/licenses/Artistic-2.0
[StrongLoop Subscription Agreement]: http://strongloop.com/license