node-moleculer-web

Documentation RU

Install

npm install node-moleculer-web --save

or

yarn add node-moleculer-web

or

npm i github:sanchezzzhak/node-moleculer-web#v1.0.0

Uses

1 Create controller in folder controllers/home.js

const {AbstractController} = require('node-moleculer-web');

class HomeController extends AbstractController {

	async index() {
	    return `helo world`;
    }
}
module.exports = HomeController

2 Create service in folder services/app.service.js

const {UwsServer} = require('node-moleculer-web');
const {Service} = require('moleculer');

const HomeController = require('../controllers/home');

class AppService extends Service {
	constructor(broker) {
		super(broker);
		this.parseServiceSchema({
			name: 'app',
			settings: {
				// base port for server
				port: 3001,
                // on what ip to listen
				ip: '127.0.0.1',
				// web-service registration type
                // node (ports will be assigned +1 from the current one)
                // auto (ports will be assigned +1 from the current one if the port is free)
				portSchema: 'node',              
                // if statics are not needed, just remove this parameter
				publicDir: __dirname + '/../public',  
                // list of controllers
				controllers: {
				   home: HomeController
				}
			},
			mixins: [
				UwsServer
			],
			created: this.createService
		})
	}

	createService() {
		// register routing where home is the controller and index is the method	
		this.createRoute('get / #c:home.index')
		this.bindRoutes();
	}
}

module.exports = AppService

NGINX config if request proxying is used for once instance

server {
    listen 80;
    listen 443 ssl;
    listen [::]:80;
    listen [::]:443;

    server_name domain.com;
  
    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_set_header X-NginX-Proxy true;
        proxy_pass http://127.0.0.1:3001;
        proxy_redirect off;
    }
}

NGNIX config if clustering is used

Run locally

npx moleculer-runner -i 4 services

or

node node_modules/.bin/moleculer-runner -i 4 services

The config itself

upstream node_apps {
    server 127.0.0.1:3001;
    server 127.0.0.1:3002;
    server 127.0.0.1:3003;
    server 127.0.0.1:3004;
}

server {
  listen 80;
  listen 443 ssl;
  listen [::]:80;
  listen [::]:443;

  server_name domain.com;
  
  location / {
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     proxy_set_header Host $http_host;
     proxy_set_header X-NginX-Proxy true;
     proxy_pass http://node_apps;
     proxy_redirect off;
  }
}

cluster config moleculer.config.js

module.exports = {
	nodeID: 'DEMO',
	transporter: "TCP",
	registry: {
		// type of call strategy for microservices
		strategy: "RoundRobin",
		// If set to true, then each webserver will use only its own micro-services
		preferLocal: false,      
	},
	logger: console
};