@colucom/osseus-server v1.0.6
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 middlewareOSSEUS_SERVER_MAINTENANCE_ENABLED
* set totrue
to enable maintenance mode on serverOSSEUS_SERVER_MAINTENANCE_MESSAGE
* maintenance message sent to clients when maintenance mode is enabledOSSEUS_SERVER_MAINTENANCE_OVERRIDE_HEADER
* bypass maintenance mode with this headerOSSEUS_SERVER_ALLOWED_IP
* list of ip addresses allowed to bypass maintenance modeOSSEUS_SERVER_COMPRESION_ENABLED
* set totrue
to enable compression middlewareOSSEUS_SERVER_COMPRESSION_LEVEL
* compressions level if compression is enabledOSSEUS_SERVER_NO_COMPRESSION_HEADER
* don't compress responses with this request headerOSSEUS_SERVER_MORGAN_FORMAT
format for morgan see morgan predefined formats * default is tinyOSSEUS_SERVER_CORS_WHITELIST
* configuring CORS w/ dynamic originOSSEUS_SERVER_STATIC_ENGINE_TYPE
OSSEUS_SERVER_VIEWS_FOLDER
* use template enginesOSSEUS_SERVER_STATIC_FOLDER
* serve static filesOSSEUS_SERVER_ADD_HEALTHCHECK
* add/healthcheck
endpoint which returnsOK
with status code 200OSSEUS_SERVER_ADD_IS_RUNNING
* add/is_running
endpoint which returnsOK
with status code 200
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.