Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…
Cannot retrieve contributors at this time
23 lines (14 sloc) 1.43 KB

Octopus Replication Example

This is a sample rails application demonstrating replication features in octopus. The application have 1 master, (specified in database.yml) and 4 slaves (specified in shards.yml).

Feature list:

All writes will be sent to master, and the read queries will be sent to the slaves. unless you have a transaction, so , all queries will be sent to master.

The application have two different models: Client and User. User is a replicated model, and Client isn't replicated. So, when you create a new User, you will see a exception, because you don't have configuration for replication and Rails tries to read the user from a slave database, and the write query have been sent to master (Default behaviour when using replication). When you create a new client, everything should works fine, it will read and write in the master database.


You will need two commands to setup the application:

 rake db:octopus && rake db:migrate 

More info could be found at Octopus Wiki


This project is sponsored by the Ruby Summer of Code, and my mentors Mike Perham and Amit Agarwal.


Copyright (c) 2010 Thiago Pradi, released under the MIT license.

Jump to Line
Something went wrong with that request. Please try again.