(This project is no longer under active development. Temporal will eventually deprecate usage of Ringpop.)

Ringpop is a library that brings cooperation and coordination to distributed applications (see Uber announcement blogpost). It maintains a consistent hash ring on top of a membership protocol and provides request forwarding as a routing convenience. It can be used to shard your application in a way that's scalable and fault tolerant.

To install ringpop-go:

go get github.com/temporalio/ringpop-go

First make certain that thrift v0.9.3 (OSX: brew install https://gist.githubusercontent.com/chrislusf/8b4e7c19551ba220232f037b43c0eaf3/raw/01465b867b8ef9af7c7c3fa830c83666c825122d/thrift.rb) and glide are in your path (above). Then,

make setup

to install remaining golang dependencies and install the pre-commit hook.

Finally, run the tests by doing (note ensure you have enough file descriptors using ulimit -n - atleast 8192 reccomended.):

make test

Interested in where to go from here? Read the docs at ringpop.readthedocs.org