Zookeeper based elections
Node-leader is an distributed election library built on top of zookeeper. It is a straight implementation of the Zookeeper Leader-Election algorithm in node.
You can think of this election as a daisy chain of nodes.
Each node will only be aware of the node directly adjacent to it, e.g.
only aware of
c. The head of the daisy chain is special and is known
as the global leader.
/election/a-00 /election/b-01 /election/c-02 /election/d-03 /election/e-04
As new voters join, they will create new nodes with a monotonically increasing sequence number. When voters expire, their ephemeral nodes are automatically removed by zookeeper.
The library emits 4 events as part of its API:
topology This will emit a sorted array of nodes in the election:
[a,b,c,d,e] This is the only event that's emitted if you are only watching
gleader This will only be emitted once by the global leader of the election,
which in this case is
follower This is emitted everytime the current follower of self is updated.
b will get a
follower event, with
c as its follower.
leader This is emitted everytime the current leader of self is updated. e.g.
b will get a
leader event, with
a as the leader.
You can use node-leader to either watch an election, or participate in an
election. Watching an election means you will only get the
but will not actually create any emphemeral nodes of your own. This is useful
for clients or services that depend on the election. By participating in the
vote(), you will additionally emit the
follower events. Node-leader expects you to pass it a handle to a already
To watch an election:
var leader = ;...// create a client and connect to ZK.var zkClient = ......var watcher = leader;watcher;
To participate in an election:
var leader = ;...// create a client and connect to ZK.var zkClient = ......voter = leader;// i am the head of the chainvoter;// the guy in frontvoter;// the guy behind mevoter;voter;// join the election.voter;
Contributions are welcome. Please make sure
npm test runs cleanly.
The MIT License (MIT)
Copyright (c) 2014 Yunong J Xiao
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.