rust raft with improvements
APACHE-2.0 License
This project intends to improve raft as the next-generation consensus protocol for distributed data storage systems (SQL, NoSQL, KV, Streaming, Graph ... or maybe something more exotic).
Currently, openraft is the consensus engine of meta-service cluster in databend.
🚀 Get started:
💡 Example Applications:
🙌 Questions?
drmingdrmer
. Let's get the conversation started!Whatever your style, we're here to support you. 🚀 Let's make something awesome together!
Openraft API is not stable yet. Before 1.0.0
, an upgrade may contain incompatible changes.
Check our change-log. A commit message starts with a keyword to indicate the modification type of the commit:
DataChange:
on-disk data types changes, which may require manual upgrade.Change:
if it introduces incompatible changes.Feature:
if it introduces compatible non-breaking new features.Fix:
if it just fixes a bug.Branch main has been under active development. The main branch is for the release-0.10.
Branch release-0.9:
Latest: ( v0.9.0 | Change log );
Upgrade guide: ⬆️ 0.8 to 0.9;
release-0.9
Won't accept new features but only bug fixes.
Branch release-0.8:
Latest: ( v0.8.8 | Change log );
Upgrade guide: ⬆️ 0.7 to 0.8, ⬆️ 0.8.3 to 0.8.4;
release-0.8
Won't accept new features but only bug fixes.
Branch release-0.7:
Latest: ( v0.7.6 | Change log );
Upgrade guide: ⬆️ 0.6 to 0.7;
release-0.7
Won't accept new features but only bug fixes.
Branch release-0.6:
Latest: ( v0.6.8 | Change log );
release-0.6
won't accept new features but only bug fixes.
single-term-leader
.The benchmark is focused on the Openraft framework itself and is run on a minimized store and network. This is NOT a real world application benchmark!!!
clients | put/s | ns/op |
---|---|---|
256 | 1,014,000 | 985 |
64 | 730,000 | 1,369 |
1 | 70,000 | 14,273 |
For benchmark detail, go to the ./cluster_benchmark folder.
RaftLogStorage
, RaftStateMachine
and RaftNetwork
traits, allowing flexibility in choosing storage and network solutions.Raft
type for creating and interacting with Raft tasks, with a straightforward API.trigger_elect()
).add_learner()
.trigger_snapshot()
).ensure_linearizable()
.enable_heartbeat
/ enable_elect
.trigger_snapshot()
/ trigger_elect()
.purge_log()
.Check out the CONTRIBUTING.md guide for more details on getting started with contributing to this project.
Made with contributors-img.
Openraft is licensed under the terms of the MIT License or the Apache License 2.0, at your choosing.