Skip to content

matrixorigin/matrixcube

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
pb
 
 
 
 
 
 
 
 
 
 
txn
 
 
 
 
vfs
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

MatrixCube — Distributed System Made Easy

MatrixCube is a Golang library for building distributed systems with high reliability and scalability. It tries to abstract away complexity of distributed systems and let developers to focus on their business logics.

The current implementation is based on a multi-group Raft design in which data is distributed and replicated across many Raft groups each with multiple replicas for high data availability. Strong consistentcy provided by the Raft protocol allows developers to more easily reason about their data when compared with weaker form of consistency, e.g. eventually consistent systems.

Internally, a well defined Key-Value storage interface allow different storage engines to be integrated with MatrixCube to be presented as Replicated State Machines. Such Replicated State Machines are accessed via a simple client interface so that all complexities such as routing and timeout retries are transparently handled by our library.

With high availability and performance on the top of our priority list, MatrixCube employs a Google Placement Driver style component for automatic movement of data to balance load or repair Raft groups with failed replicas.

MatrixCube's architecture is visualized in the following diagram -

arch

To the maximum of our knowledge, MatrixCube is currently the only open source library that provides all above features in a single Go library.

Features

  • Multi-group Raft for high availability
  • Strongly consistent storage
  • Unlimited horizontal scalability
  • Automatic load rebalancing & failure recovery
  • Pure Go implementation

Usage

To add MatrixCube to your project -

go get github.com/matrixorigin/matrixcube@latest

Example

See our TinyKV example on how to use MatrixCube for building a highly scalable & strongly consistent Key-Value store.

License

MatrixCube is licensed under the Apache version 2.0 license. It contains source code licensed from 3rd parties, details are here.