hapi-lbstatus

3.0.4 • Public • Published

Hapi lbstatus

Build Status NPM version Dependencies

Shared code for the _lbstatus endpoint. Essentially a poor-man's service discovery, will be used until the front-door service is ready.

Reads the specified file and looks for the value 'ON' or 'OFF' and returns ON or OFF from the endpoint.

If the file is missing, or empty, or an exception occurs, then default value is OFF.

Also performs a liveness check by injecting a request to a specified endpoint (using server.inject). If the response is an error (or times out) it returns "OFF".

Installation:

npm install hapi-lbsstatus

Usage:

var server = hapi.createServer();

server.pack.require("hapi-lbstatus",
  {
    file: '/etc/lbstatus/myappname',
    liveness: '/my/api/123',
    headers: {
    // optional headers to apply when making the liveness check
      'accept-language': 'en-US'
    },
    on: "MYAPP_ON", // override the default return value of 'ON'
    off: "MYAPP_OFF" // override the default return value of 'OFF'
  },
  function (err){
    if(err){
      throw err;
    }
  }
);

// also exposes the lbstatus function

server.plugins['hapi-lbstatus'].lbstatus(function(on){
  // returns true if ON, false if OFF
});

Response Codes:

  • ON: 200
  • OFF: 503

Notes:

  • Supports pack servers as well as single instances
  • Supports hapi v5+

Readme

Keywords

Package Sidebar

Install

npm i hapi-lbstatus

Weekly Downloads

2

Version

3.0.4

License

MIT

Last publish

Collaborators

  • acolchado
  • arnoldzokas
  • matteofigus
  • christriddle
  • ryantomlinson
  • andyroyle
  • stevejhiggs
  • lobut