Shibuya is a tiny library that provides easy and intuitive RPC interface that works on top of messaging systems (currently only RabbmitMQ).
All services in Shibuya are clustered. Whenever a call is made by one of the clients, a service instance is selected by the queue-provider/Shibuya's distribution logic (usually "Round-Robin"). Services should be authored as "business state free", meaning that they cannot store any client-specific state exclusively, since there is no guarantee that the same certain service will be selected on all single client requests.
To declare a service, use the following syntax:
var shibuya = require('shibuya')({...configuration...});
var serviceInstance = {
add: function(opts, cb){
return opts["firstNumber"] + opts["secondNumber"];
}
};
shibuya.registerService('service.name', serviceInstance);
var shibuya = require('shibuya')({...configuration...});
shibuya.remoteCall('service.name', 'add', {
firstNumber: 3,
secondNumber: 2
});
Using messaging systems as a "backbone" for your system's communication provides the following benefits:
- Easier services configuration - Every service should only know it's messaging-queue instance, that's all.
- Effortless Load-balancing - Most queue systems provide an organic way to distribute the load of processing queue-messages.
- Resilience to faults - Whenever a service drops, traffic is automatically diverted away from it.
- Extensive debug - All calls between the system parts can be monitored for analysis.
npm install shibuya