Fastly develop micro services in node.js
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib fix path in load Feb 20, 2018


Fastly develop micro services in node.js

Build Status


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


npm install micrun


Example usage without Consul

const micrun = require('micrun');

    port: 9000,
    ip: '',
    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');

    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:

├── 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



Example project using micrun.


npm run test