https://github.com/apache/ratis

Open source Java implementation for Raft consensus protocol.
https://github.com/apache/ratis

consensus consensus-protocol java raft

Last synced: 26 days ago
JSON representation

Open source Java implementation for Raft consensus protocol.

• Host: GitHub
• URL: https://github.com/apache/ratis
• Owner: apache
• License: apache-2.0
• Created: 2017-01-31T08:00:07.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-05-17T03:26:14.000Z (6 months ago)
• Last Synced: 2024-05-21T07:21:11.040Z (6 months ago)
• Topics: consensus, consensus-protocol, java, raft
• Language: Java
• Homepage: https://ratis.apache.org/
• Size: 10.3 MB
• Stars: 1,192
• Watchers: 52
• Forks: 404
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


# Apache Ratis

*[Apache Ratis]* is a Java library that implements the Raft protocol [1],

where an extended version of the Raft paper is available at .

The paper introduces Raft and states its motivations in following words:

> Raft is a consensus algorithm for managing a replicated log.

> It produces a result equivalent to (multi-)Paxos, and it is as efficient as Paxos,

> but its structure is different from Paxos; this makes Raft more understandable than Paxos

> and also provides a better foundation for building practical systems.

Ratis aims to make Raft available as a java library that can be used by any system that needs to use a replicated log.

It provides pluggability for state machine implementations to manage replicated states.

It also provides pluggability for Raft log, rpc implementations and metric implementations to make it easy for integration with other projects.

Another important goal is to support high throughput data ingest so that it can be used for more general data replication use cases.

* To build the artifacts, see [BUILDING.md](BUILDING.md).

* To run the examples, see [ratis-examples/README.md](ratis-examples/README.md).

## Reference

1. Diego Ongaro and John Ousterhout,

_[In Search of an Understandable Consensus Algorithm][Ongaro2014]_,

2014 USENIX Annual Technical Conference (USENIX ATC 14) (Philadelphia, PA), USENIX Association, 2014, pp. 305-319.

[Ongaro2014]: https://www.usenix.org/conference/atc14/technical-sessions/presentation/ongaro

[Apache Ratis]: https://ratis.apache.org/