@colucom/osseus-server
v1.0.6
Published
Osseus server
Downloads
43
Keywords
Readme
Osseus Server
express based osseus web server module
Install
$ npm install @colucom/osseus-server
Usage with MOLECULER-WEB AS MIDDELWARE
Configuration
Mandatory:
To use the moleculer-web api gateway module as a middleware of the express, this configuration are mandatory.
OSSEUS_MOLECULERWEB_LOAD: false
- the init of the osseus module will be preformed as part of this module code and not in the init of the osseus it self.
OSSEUS_SERVER_SHOULD_USE_MOLECULER_WEB_AS_MIDDLEWARE: true
- this flag indicates to the module to use the moleculer-web osseus module.
Optional:
Logging
To use custom logging as a middleware of the express, it's necessary to config this 2 configurations.
OSSEUS_SERVER_SHOULD_USE_CUSTOM_LOGGING_METHOD: true
OSSEUS_SERVER_CUSTOM_LOGGING_METHOD_PATH: 'Custom Path'
- the custom path of the logging middelware method in the original project that uses the osseus-server.
Custom middlewares
To use custom middelwares you should provide path to array of middleware functions.
OSSEUS_SERVER_MIDDLEWARES_PATH: 'Custom Path'
- the custom path of the array of middelware functions in the original project that uses the osseus-server.
Errors Map json
To use custom errors map json you should provide path to this json.
OSSEUS_SERVER_ERRORS_MAP_PATH: 'Custom Path'
Handle 404 Errors - Redirect the request to another server
If you wish to redirect the request to another server when 404 not found error occures you should provide base url of this server.
REDIRECT_BASE_URL: 'Custom URL'
Usage
Configuration
Mandatory:
OSSEUS_SERVER_PORT
Optional:
OSSEUS_SERVER_REQUEST_ID_HEADER
- set request id header name to enable cc-request-id middleware
OSSEUS_SERVER_MAINTENANCE_ENABLED
- set to
true
to enable maintenance mode on server
- set to
OSSEUS_SERVER_MAINTENANCE_MESSAGE
- maintenance message sent to clients when maintenance mode is enabled
OSSEUS_SERVER_MAINTENANCE_OVERRIDE_HEADER
- bypass maintenance mode with this header
OSSEUS_SERVER_ALLOWED_IP
- list of ip addresses allowed to bypass maintenance mode
OSSEUS_SERVER_COMPRESION_ENABLED
- set to
true
to enable compression middleware
- set to
OSSEUS_SERVER_COMPRESSION_LEVEL
- compressions level if compression is enabled
OSSEUS_SERVER_NO_COMPRESSION_HEADER
- don't compress responses with this request header
OSSEUS_SERVER_MORGAN_FORMAT
- format for morgan
- see morgan predefined formats
- default is tiny
OSSEUS_SERVER_CORS_WHITELIST
OSSEUS_SERVER_STATIC_ENGINE_TYPE
OSSEUS_SERVER_VIEWS_FOLDER
OSSEUS_SERVER_STATIC_FOLDER
OSSEUS_SERVER_ADD_HEALTHCHECK
- add
/healthcheck
endpoint which returnsOK
with status code 200
- add
OSSEUS_SERVER_ADD_IS_RUNNING
- add
/is_running
endpoint which returnsOK
with status code 200
- add
Example
First, create index.js
:
const Osseus = require('osseus')
const main = async () => {
try {
// init osseus
const osseus = await Osseus.init()
} catch (err) {
console.error(err)
}
}
main()
Running:
$ node index.js --OSSEUS_SERVER_PORT 8080
Will result in:
server is listening on port: 8080
Contributing
Please see contributing guidelines.
License
Code released under the MIT License.