Cloud Health Connect provides a Connect Middleware for use in Express.js, Loopback and other frameworks that uses Cloud Health to provide:
- Readiness checks
- Liveness checks
- Shutdown handling
to enable applications for use with Kubernetes and Cloud Foundry based clouds.
Cloud Health Connect takes the status reported by Cloud Health and makes it available on the liveness and/or readiness URL endpoints that the middleware is configured to use.
The middleware writes the data returned by the Cloud Health module as JSON, and sets the HTTP Status Code as follows:
Cloud Health Status | Readiness Status Code | Liveness Status Code |
---|---|---|
STARTING | 503 UNAVAILABLE | 200 OK |
UP | 200 OK | 200 OK |
DOWN | 503 UNAVAILABLE | 503 UNAVAILABLE |
STOPPING | 503 UNAVAILABLE | 503 UNAVAILABLE |
STOPPED | 503 UNAVAILABLE | 503 UNAVAILABLE |
- | 500 SERVER ERROR | 500 SERVER ERROR |
- Installation:
npm install @cloudnative/health-connect
- Set up a HealthChecker:
const health = require('@cloudnative/health-connect');
let healthcheck = new health.HealthChecker();
- Register a Liveness endpoint:
app.use('/health', health.LivenessEndpoint(healthcheck))
If no livessness checks are registered, this will report 200 OK
and UP
.
- Register a readiness endpoint:
app.use('/ready', health.ReadinessEndpoint(healthcheck))
If no readiness checks are registered, this will report 200 OK
and UP
.
For information on how to register startup, liveness and shutdown checks, see the Cloud Health documentation.
The Cloud Health Connect module is created in TypeScript and as such provides out of the box TypeScript support.
This module adopts the Module Long Term Support (LTS) policy, with the following End Of Life (EOL) dates:
Module Version | Release Date | Minimum EOL | EOL With | Status |
---|---|---|---|---|
1.x.x | July 2018 | Dec 2019 | Current |