Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/binocarlos/telegraft
Do work on remote servers
https://github.com/binocarlos/telegraft
Last synced: 10 days ago
JSON representation
Do work on remote servers
- Host: GitHub
- URL: https://github.com/binocarlos/telegraft
- Owner: binocarlos
- License: mit
- Created: 2013-04-20T01:15:16.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2014-10-29T14:42:46.000Z (about 10 years ago)
- Last Synced: 2024-10-31T19:39:51.778Z (19 days ago)
- Language: JavaScript
- Size: 213 KB
- Stars: 5
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
telegraft
=========
Telegraft is a ZeroMQ and node.js framework which manages sockets to worker processes.
## Installation
You need to have ZeroMQ on your system:
For Ubuntu:
sudo apt-get install libzmq3 libzmq3-dev
Then:
npm install telegraft
Note - if you still get errors installing try:
sudo apt-get install build-essential
## Usage
First - the HQ service that runs the network:
```js
var telegraft = require('telegraft');
var endpoints = {
server:'tcp://127.0.0.1:5678',
radio:'tcp://127.0.0.1:5679'
}
telegraft.server(endpoints);
```
Then - a worker process somewhere else on the network:
```js
var telegraft = require('telegraft');
var endpoints = {
server:'tcp://127.0.0.1:5678',
radio:'tcp://127.0.0.1:5679'
}
var graft = telegraft.client(endpoints);
var timeserver = graft.rpcserver({
id:4548,
protocol:'rpc',
address:'tcp://127.0.0.1:56493'
})
timeserver.on('request', function (req, reply){
// reply is a standard node callback function - error, result
reply(null, new Date().getTime());
})
timeserver.bind('/api/time');
```
And a different worker process on another server and mounted on a different path:
```js
var telegraft = require('telegraft');
var endpoints = {
server:'tcp://127.0.0.1:5678',
radio:'tcp://127.0.0.1:5679'
}
var graft = telegraft.client(endpoints);
var pingserver = graft.rpcserver({
id:4549,
protocol:'rpc',
address:'tcp://127.0.0.1:56495'
})
pingserver.on('request', function (req, answer){
answer(null, 'hello world');
})
timeserver.bind('/api/ping');
```
Cool - we now have our network running - time to make a client and speak to it (somewhere else on the network):
```js
var telegraft = require('telegraft');
var endpoints = {
server:'tcp://127.0.0.1:5678',
radio:'tcp://127.0.0.1:5679'
}
var graft = telegraft.client(endpoints);
/*
a proxy will automatically route based on the path we provide
*/
var proxy = graft.rpcproxy();
/*
args are strings
*/
proxy.send('/api/time', '{arg:838}', function(error, val){
console.log('the time is: ' + val);
});
proxy.send('/api/ping', '{arg:10}', function(error, val){
console.log('the ping says: ' + val);
});
```
## Running Tests
make test
## Licence
MIT