@bufferapp/shutdown-helper
v0.2.0
Published
A package to help you gracefully shutdown Express.js apps
Downloads
2,281
Maintainers
Keywords
Readme
@bufferapp/shutdown-helper
Provides a basic helper that listens to the SIGTERM
signal and will shutdown the given
Express.js server after the given delay in seconds.
Install
npm install @bufferapp/shutdown-helper -SE
Usage
To use with your Express.js app, you'll have to use Node's http
package to start your server.
Here is a full usage example:
const http = require('http')
const express = require('express')
const shutdownHelper = require('@bufferapp/shutdown-helper')
const createLogger = require('@bufferapp/logger')
const shutdownDelay = 20 // seconds
const logger = createLogger({ name: 'Images-Worker' })
const app = express()
const server = http.createServer(app)
server.listen(8080)
shutdownHelper.init({ server, shutdownDelay, logger })
The init
function takes one argument with the following options:
server
(http.Server) - An instance of a Node http servershutdownDelay
(Integer) - The delay in seconds after which to shut down the http server. Default20
seconds.logger
(@bufferapp/logger) - (optional) - If passed in log messages to@bufferapp/logger
otherwise logged toconsole
Elsewhere in your application, ideally in a health-check endpoint, you can use the isShutingDown
function to check if your application has received a SIGTERM
:
const { isShutingDown } = require('@bufferapp/shutdown-helper')
app.get('/health-check', (req, res) => {
const code = isShutingDown() ? 500 : 200
const status = code === 200 ? 'awesome' : 'shutting down'
res.status(code).json({ status })
})