1 unstable release

Uses old Rust 2015

0.0.0 Jun 7, 2018

#26 in #etcd

MIT/Apache

2KB

Mum - distributed kv store base on raft

Usage

Server

# server side 
RUST_LOG=server,mum cargo run --bin server -- --id 1 --snap_dir example_dir/1/snap/ --wal_dir example_dir/1/ --addrs  127.0.0.1:9005 --addrs  127.0.0.1:9006 --addrs  127.0.0.1:9007

RUST_LOG=server,mum cargo run --bin server -- --id 2 --snap_dir example_dir/2/snap/ --wal_dir example_dir/2/ --addrs  127.0.0.1:9005 --addrs  127.0.0.1:9006 --addrs  127.0.0.1:9007

RUST_LOG=server,mum cargo run --bin server -- --id 3 --snap_dir example_dir/3/snap/ --wal_dir example_dir/3/ --addrs  127.0.0.1:9005 --addrs  127.0.0.1:9006 --addrs  127.0.0.1:9007

Client

# kv --op (get/set/del/scan)
# conf --op (add/remove)
RUST_LOG=ctl,mum ./target/debug/ctl kv --op get --y hello1 --value world1 --kv_addr 127.0.0.1:9005

Features

Wanted

  • Use raft-rs, grpc-rs, tokio to build a simple HA key-value service
  • Provide basic get, set, delete, and scan operations
  • The data saved in one node must be persistent in the disk (restart can’t lose data).
  • Need to show - Kill minority node, the service can still work.
  • Need to show - Kill majority node, the service can not work.
  • Need to support add/remove node dynamically
  • Use a benchmark tool to find some performance problems.

Simple MVCC K/V Storage

K/V Storage Features

  • A Single-File Presistent Storage
  • Copy-On-Write, Read-Lock-Free (MVCC)
  • Auto garbage collection
  • Snapshot (Maybe)

K/V Storage TODOs

  • Get(Key) -> Option
  • Set(Key, Value)
  • Delete(Key) -> Option
  • Scan() -> Iter
  • MVCC support
  • Snapshot support

Simple Write Ahead Log

WAL Features

  • Multi segments
  • Reply logs for Disaster Recovery

WAL TODOs

  • Write logs
  • Read all logs

No runtime deps