riak-cache is an implementation of ActiveSupport::Cache::Store that stores cached values in Riak. This is especially useful if you have configured Riak to use an in-memory backend.

riak-cache requires ActiveSupport version 3.x for its parent class, and riak-client to connect to Riak.

Development dependencies are handled with bundler. Install bundler (gem install bundler) and run this command:

$ bundle install

To pin to a specific version of ActiveSupport (rather than the latest 3.x version), specify the BUNDLE_GEMFILE environment variable:

$ BUNDLE_GEMFILE=Gemfile.rails31 bundle install

To use riak-cache with your Rails project, include it in your project's Gemfile and set it as the cache store inside your config/application.rb like so:

config.cache_store = :riak_store

To provide extra configuration (for example, which Riak nodes to connect to), use an array:

config.cache_store = [:riak_store, {:http_port => 10000}]

Otherwise, you can simply instantiate and use the class wherever you like:

cache = Riak::CacheStore.new
cache.fetch('pages/1234') { render_page }

Copyright ©2010-2012 Sean Cribbs and Basho Technologies, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.