This project provides a Node.js package that lets you use Windows Azure Service Bus as a back-end communications channel for primus.io applications.
Learn more about the module by watching the recent [Subscribe] (http://channel9.msdn.com/Blogs/Subscribe/Glenn-Block-Explains-SocketIO-Scale-Out-on-Service-Bus) episode.
- Service Bus Store
- Easily connect multiple socket.io server instances over Service Bus
Fixes to the presence system in the chat application. Not 100% there, but working much better in the multi-server case.
Service Bus topics and subscriptions are now created automatically if they don't already exist. Subscriptions are created with a five minute idle expiration time, so they won't stick around once the server is no longer polling them.
The cross-server presence indicators in the chat sample has been updated to properly handle the multi-server environment.
There's the start of a perf test harness in examples/timingtest.
To get the source code of the SDK via git just type:
git clone https://github.com/WindowsAzure/socket.io-servicebus
cd ./primus.io-servicebus
You can install the azure npm package directly.
npm install primus.io-servicebus
First, set up your Service Bus namespace. You will need a shared topic name; this can either be created in advance or the module will create them for you.
These can be created either via the Windows Azure portal or programmatically using the Windows Azure SDK for Node.
Then, configure primus.io to use the Service Bus Store:
var sio = require('socket.io');
var SbStore = require('primus.io-servicebus');
var io = sio.listen(server);
io.configure(function () {
io.set('store', new SbStore({
topic: topicName,
connectionString: connectionString
}));
});
The connection string can either be retrieved from the portal, or using our powershell / x-plat CLI tools. From here, communications to and from the server will get routed over Service Bus.
The current version (0.0.2) only routes messages; client connection state is stored in memory in the server instance. Clients need to consistently connect to the same server instance to avoid losing their session state.
Be sure to check out the Windows Azure Developer Forums on Stack Overflow if you have trouble with the provided code.
If you would like to become an active contributor to this project please follow the instructions provided in Windows Azure Projects Contribution Guidelines.
If you encounter any bugs with the library please file an issue in the Issues section of the project.
For documentation on how to host Node.js applications on Windows Azure, please see the Windows Azure Node.js Developer Center.
For documentation on the Azure cross platform CLI tool for Mac and Linux, please see our readme [here] (http://github.com/windowsazure/azure-sdk-tools-xplat)
Check out our new IRC channel on freenode, node-azure.