Package Exports

recluster

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (recluster) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

recluster

Clustering library with support for zero-downtime reloading

usage

If server.js is your regular http server (e.g. express), create cluster.js and add:

var recluster = require('recluster'),
    path = require('path'),
    split = require('split');
 
var cluster = recluster(path.join(__dirname, 'server.js'));

cluster.run();
console.log("spawned cluster, kill -s SIGUSR2", process.pid, "to reload");

then run it

node cluster.js

To hot-reload the server, simply run

kill -s SIGUSR2 <cluster_pid>

options

var cluster = recluster(file, opt)

where

file

Absolute path to the module that defines the server

opt.workers

Number of active workers (default = cores)

opt.timeout

Timeout to kill old workers after reload (seconds).

Defaults to 1 second in development, 1 hour in production.

opt.respawn

Minimum time between worker respawns when workers die (seconds)

cluster

The returned object has the following methods:

cluster.run

Starts the cluster by running child processes

cluster.reload

Hot-reloads new code. some of the children will remain active for opt.timeout seconds after reload

cluster.terminate

Terminates the entire cluster and removes all listeners.