gossipdb

Distributed Embedded Key-Value store

What it does?

An in memory cache which listens to neighbouring nodes and replicates messages using gossip protocol.

gossipdb provides the replication and in-memory persistance layer for the nodes of the cluster. It provides APIs to put and fetch data in a key value pair. It also provides an API to fetch the active members of the cluster.

Example

The 'example' directory contains an example application which has can be used to add keys using an API call and fetching it from any of the nodes.

You can build the example using the following steps:

cd example
glide install
go build

You then need to run two instances of the app on different tabs of your terminal:

./example -http_port 8000 -rpc_port 9000 -members
'0.0.0.0:9000,0.0.0.0:9001'

./example -http_port 8001 -rpc_port 9001 -members
'0.0.0.0:9000,0.0.0.0:9001'

Sample payload for the '/add_key' API is shown below:

{
"key": "ping",
"value": "pong"
}

The key can then be fetched by using the query '/value?key=ping'

Roadmap

GossipDb is currently an early alpha project. Api interface is likely to change, and is not recommended for production usages.

Todos

Improve test coverage
CI pipeline and code linting tools
Config Objects for DB
Better capability from Key-Value store, like ttl, and deletes
Improved Object parser
Cluster health and Status
Instrumentation on replication
Benchmarking
Example usage

Building

CI Status:

try,
  make init
  make deps
  make test (or clean)
or,
  make

License