1.2.2 • Published 5 years ago

http-shutdown v1.2.2

Weekly downloads
34,281
License
MIT
Repository
github
Last release
5 years ago

Http-Shutdown NPM version Build status Test coverage

Shutdown a Nodejs HTTP server gracefully by doing the following:

  1. Close the listening socket to prevent new connections
  2. Close all idle keep-alive sockets to prevent new requests during shutdown
  3. Wait for all in-flight requests to finish before closing their sockets.
  4. Profit!

Other solutions might just use server.close which only terminates the listening socket and waits for other sockets to close - which is incomplete since keep-alive sockets can still make requests. Or, they may use ref()/unref() to simply cause Nodejs to terminate if the sockets are idle - which doesn't help if you have other things to shutdown after the server shutsdown.

http-shutdown is a complete solution. It uses idle indicators combined with an active socket list to safely, and gracefully, close all sockets. It does not use ref()/unref() but, instead, actively closes connections as they finish meaning that socket 'close' events still work correctly since the sockets are actually closing - you're not just unrefing and forgetting about them.

Installation

$ npm install http-shutdown

Usage

There are currently two ways to use this library. The first is explicit wrapping of the Server object:

// Create the http server
var server = require('http').createServer(function(req, res) {
  res.end('Good job!');
});

// Wrap the server object with additional functionality.
// This should be done immediately after server construction, or before you start listening.
// Additional functionailiy needs to be added for http server events to properly shutdown.
server = require('http-shutdown')(server);

// Listen on a port and start taking requests.
server.listen(3000);

// Sometime later... shutdown the server.
server.shutdown(function(err) {
	if (err) {
		return console.log('shutdown failed', err.message);
	}
	console.log('Everything is cleanly shutdown.');
});

The second is implicitly adding prototype functionality to the Server object:

// .extend adds a .withShutdown prototype method to the Server object
require('http-shutdown').extend();

var server = require('http').createServer(function(req, res) {
  res.end('God job!');
}).withShutdown(); // <-- Easy to chain. Returns the Server object

// Sometime later, shutdown the server.
server.shutdown(function(err) {
	if (err) {
		return console.log('shutdown failed', err.message);
	}
  console.log('Everything is cleanly shutdown.');
});

Test

$ npm test
drakov-js@yarvis/ws@everything-registry/sub-chunk-1871telegram-test-apisumbal-tileserver-glspotify-personal-auth@coboxcoop/seeder@coboxcoop/serverjest-puppe-shots-envjbjareskeuss-serverkoa-enhanced-servergeovis-map-serversrc2imgsteedos-node-redstencila-nodestencila-node-0.26.0tehmusimhujantileserver-gltileserver-gl-lighttileserver-gl-light-customtrinity-jesttoor@ascot/http@ascot/http-server@arso-project/sonar-server@arsonar/server@andrew-codes/marco@aabelmann/ui-layer@absanger/npg_ranger@acalcutt/tileserver-gl@acalcutt/tileserver-gl-light@codersyndicate/graceful-shutdown@deepstream/server@danizean/cyberzoneyyl-seed-test-utilzona-xunito@grishah/npg_ranger@horwood/server@huma-shan/request-node@frinkly/request-node@gluedigital/tileserver-gl@gluedigital/tileserver-gl-light@inspirock/tileserver-gl@infinitebrahmanuniverse/nolb-http-s@kumologica/pocdk@kumologica/pocsdk@kumologica/runtime@leopradel/telegram-test-api@luminati-io/luminati-proxy@luminati-io/llpm@nexusapp/luminati-proxy@nickpeihl/tileserver-gl@nickpeihl/tileserver-gl-light@ezs/core@jdesboeufs/tileserver-gl-light@joshmossas/listhen@jdesboeufs/tileserver-gl@playlistduong/s-deploy@plaqard/core@smujaddid/drakov@simplej/spry-core@requestnetwork/request-node@serenity-js/local-servermu-koan-servermyclaspmockingjaysmeta-proxy-managermetaformnpg_rangeroly-httpnuxtpaginationspatepangdeuipam-http_ensandbox-test-serversedanbosoks3cf1gservice-template-nodenode-multi-webservernode-rtsp-stream-jsmpegnode-red-appnode-standuppileuleuyantearest-api-servicerefinejs-reporest-in-contractshowgallerysimmslevomat-tileserver-gl-lightskymet-proxy-managerskymet-proxy-manager-newgraceful-shutdown-expressinfra-workframehttps-proxy-serverhttp-test-serverhazyairh2o-proxylisthenluminati-proxy-stripped
1.2.2

5 years ago

1.2.1

6 years ago

1.2.0

8 years ago

1.1.0

9 years ago

1.0.3

10 years ago

1.0.2

10 years ago

1.0.1

10 years ago

1.0.0

10 years ago