开源软件名称：

kvrocks

开源软件地址：

https://gitee.com/mirrors/kvrocks

开源软件介绍：

Kvrocks is an open-source distributed key-value database which is based on rocksdb and compatible with Redis protocol. Intention to decrease the cost of memory and increase the capability while compared to Redis. The design of replication and storage was inspired by rocksplicator and blackwidow.

Kvrocks has the following key features:

Redis protocol, user can use redis client to visit the kvrocks
Namespace, similar to redis db but use token per namespace
Replication, async replication using binlog like MySQL
High Available, supports redis sentinel to failover when master or slave was failed
Cluster mode, centralized management but compatible with Redis cluster client access

Thanks for designers @田凌宇 and @范世丽 contribute the kvrocks logo for us.

Who uses kvrocks

Tickets a pull reqeust to let us known that you're using kvrocks and add your logo to README

Building kvrocks

requirements

g++ (required by c++11, version >= 4.8)
autoconf automake libtool snappy

Build

NOTE: You should install the snappy first:

# Centos/Redhatsudo yum install -y epel-release && sudo yum install -y git gcc gcc-c++ make snappy snappy-devel autoconf automake libtool which gtest gtest-devel# Ubuntu/Debiansudo apt updatesudo apt-get install gcc g++ make libsnappy-dev autoconf automake libtool# MACOSXbrew install autoconf automake libtool snappy googletest

It is as simple as:

$ git clone --recursive https://github.com/kvrockslabs/kvrocks.git$ cd kvrocks$ make -j4

Running kvrocks

$ ./src/kvrocks -c kvrocks.conf

Running test cases

NOTE: You should install the googletest first

make test

Supported platforms

centos 6/7
ubuntu
macosx

Try kvrocks using Docker

$ docker run -it -p 6666:6666 kvrocks/kvrocks$ redis-cli -p 6666127.0.0.1:6666> get a(nil)

Namespace

namespace was used to isolate data between users. unlike all the redis databases can be visited by requirepass, we use one token per namespace. requirepass was regraded as admin token, only admin token allows to access the namespace command, as well as some commands like config, slaveof, bgsave, etc…

# add token127.0.0.1:6666>  namespace add ns1 my_tokenOK# update token127.0.0.1:6666> namespace set ns1 new_tokenOK# list namespace127.0.0.1:6666> namespace get *1) "ns1"2) "new_token"3) "__namespace"4) "foobared"# delete namespace127.0.0.1:6666> namespace del ns1OK

DOCs

For more informations, can see: Kvrocks Wiki

Tools

Export the Kvrocks monitor metrics, please use kvrocks_exporter
Migrate from redis to kvrocks, use redis-migrate-tool which was developed by vipshop
Migrate from kvrocks to redis. use kvrocks2redis in build dir