https://github.com/leandromoreira/cassandra-lock
A ruby lib to achieve consensus with Cassandra
https://github.com/leandromoreira/cassandra-lock
Last synced: 5 months ago
JSON representation
A ruby lib to achieve consensus with Cassandra
- Host: GitHub
- URL: https://github.com/leandromoreira/cassandra-lock
- Owner: leandromoreira
- License: mit
- Created: 2014-12-29T15:41:12.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2020-02-28T19:23:46.000Z (over 5 years ago)
- Last Synced: 2025-01-13T04:50:11.099Z (5 months ago)
- Language: Ruby
- Size: 13.7 KB
- Stars: 12
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](http://badge.fury.io/rb/cassandra_lock)
# cassandra\_lock
A ruby lib to achieve [consensus](http://en.wikipedia.org/wiki/Consensus_%28computer_science%29) with Cassandra, inspired by [consensus on cassandra](http://www.datastax.com/dev/blog/consensus-on-cassandra). It can be used as lock in distributed systems.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'cassandra_lock'
```
And then execute:
```$ bundle```
Or install it yourself as:
```$ gem install cassandra_lock```
## Usage
Create the keyspace, see the example bellow.
```SQL
CREATE KEYSPACE test_lock WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'datacenter1' : 1 };
```
Create the table, see the example bellow.
```SQL
CREATE TABLE test_lock.leases (
name text PRIMARY KEY,
owner text,
value text
) with default_time_to_live = 5
```
And finally to use in your code:
```ruby
#to create
contact_points = ["127.0.0.1"]
keyspace = "test_lock"
client = CassandraLock::Client.new(contact_points, keyspace)
#to lock
if client.lock("my_resource")
puts "I acquired the lock"
else
puts "Someone took the lock"
end
#to unlock
client.unlock("my_resource")
#to keep_alive
client.keep_alive("my_resource")
```
## Contributing
1. Fork it ( https://github.com/leandromoreira/cassandra_lock/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request