micrun

Fastly develop micro services in node.js

Features

• build in consul support for KV store and health check
• configuration can be stored in consul or locally

Install

npm install micrun

Usage

Example usage without Consul

const micrun = require('micrun');

micrun.createServer({
    port: 9000,
    ip: '127.0.0.1',
    useConsul: false,

    postInterfacesDir: '<path to directory>',
    api_key: 'secret',

    getInterfacesDir: '<path to directory>'
});

Example usage with Consul as a configuration store.

const micrun = require('micrun');

micrun.createServer({
    useConsul: true,
    consulNamespace: 'my-super-app'
});

Available options:

|name |description |required | |---- |------------------------------------- |-------- | |port |Port on which service will be running | yes | |ip |IP of service | yes | |useConsul |if true Consul will be used as configuration store | no | |consulNamespace |Name of directory in Consul KV store | yes if using consul | |consulConfig |Optional configuration for consul (details) | no | |postInterfacesDir |Path to directory where methods are stored | no | |api_key |API key for post methods | yes if using post methods | |getInterfacesDir |Path to directory where methods are stored | no |

Creating endpoints

All methods are grouped in interfaces, eg. there can be getSingleUser method in users interface. It could be exposed by service over HTTP GET or POST method.

Creating POST endpoints

1. Create directory in your project, eg. my-post-endpoints
2. In configuration of micrun pass absolute path to my-post-endpoints as postInterfacesDir. For POST methods api_key is also required.
3. To create new interface create directory inside my-post-endpoints. Name of that directory will be also name of interface.
4. Inside interface directory create .js file for every method. Name of the file must include word Method.

For example getSingleUser method in users interface will have file structure:

my-post-interfaces
├── users
│   ├── getSingleUserMethod.js

getSingleUserMethod.js must export object as below:

const configStore = require('micrun').config;
const config = configStore.getConfig(); // getConfig() can be used to retrieve configuration

module.exports = {
    name: 'getSingleUser', // This is the name of method used in service
    method: function(params) { // This function must return Promise. Params are passed in POST body
        return new Promise((resolve, reject) => {
            // Do something and resolve promise

            return resolve();
        });
    }
};

Using POST endpoint

Make a POST request to http://<ip>:<port> With JSON body:

{
    "API_KEY": "<api_key>",
    "interface": "<interface>",
    "method": "<method>",
    "additional_data": "some_data"
}

Creating GET endpoints

Creating GET methods is similar to creating POST methods. In configuration of micrun pass absolute path to directory with GET interfaces as getInterfacesDir.

getSingleUserMethod.js as a GET method:

module.exports = {
    name: 'get_single_user', // This is the name of method used in service
    method: function(req, res) { 
        return res.json({
            // some data
        });
    }
};

Using GET endpoint

To call GET method simply make request to: `http://:/:interface/:method

Eg. http://127.0.0.1:9000/users/get_single_user

Example

Example project using micrun.

Testing

npm run test