NanoCluster is a non intrusive leader-election library for .NET.
Use it when :
- a set of endpoints are mutating the same state and you want to allow just one
- you want to enforce authority or to coordinate a set of services
- implementing Bully algorithm is not your competitive advantage
- Zookeeper is an overkill
All the boilerplate code is encapsulated in the implementation details which we took care of.
No leaking abstractions, code against small foot print Api.
1 Clone this, build, copy from bin into your project's lib folder 2 DLL's NanoCluster.dl and NetMQ.dll
2 Reference both DLL's in any endpoint which needs coordination
3 Agree with you it's not fun, sorry no nuget yet
The configuration model supports 2 modes. Static configuration mode which is provided at start-up from a config file. The second option is Zero configuration mode.
The configuration model is populated by analyzing the UDP broadcast. If you are running in the cloud make sure UDP broadcast is available. You set this mode by running the parameter-less constructor overload at your endpoint start up.
var cluster = new NanoClusterEngine();At run-time you can check the IsCoordinatorProcess on NanoClusterEnginev
This is the way to run it when the node ip addresses are well known and rarely change.
- define the list of host:port for each member you want to participate in the cluster
- use host:port to create an instance of
NanoClusterEnginein each app domain - at run-time you can check the
IsCoordinatorProcessonNanoClusterEngine
var cluster = new NanoClusterEngine(
// engine host
"tcp://localhost:5555",
// all members, ascending prioritized, from least to most important
"tcp://localhost:5555,tcp://localhost:5556,tcp://localhost:5557"
);
while (true)
{
Thread.Sleep(1000);
var whoami = (cluster.IsCoordinatorProcess ? "leader" : "follower");
Console.WriteLine("Cli \\> " + whoami);
}The project comes along with samples. For now we have examples of 2 clusters, static and automatic discovery configuration.
Contributors: @ruslanrusu
Send me pull requests so I can add you to the contributor list