ar-octopus 0.0.1 → 0.0.2

data/.gitignore

@@ -0,0 +1 @@
+pkg/*.*

data/README.mkdn

@@ -12,7 +12,8 @@
 - Moving data between shards with migrations.
 - Tools to manage database configurations. (soon)
 
-<p> To see the complete list of features and syntax, please check out our <a href="http://wiki.github.com/tchandy/octopus/"> Wiki</a> 
+<p> To see the complete list of features and syntax, please check out our <a href="http://wiki.github.com/tchandy/octopus/"> Wiki</a></p>
+<p>Wanna see sample rails applications using octopus features? please check it out: <a href="http://github.com/tchandy/octopus_sharding_example">Sharding Example</a> and <a href="http://github.com/tchandy/octopus_replication_example">Replication Example</a> </p> 
   
 <h2>Thanks</h2>
 

data/Rakefile

@@ -12,7 +12,7 @@ begin
     gem.homepage = "http://github.com/tchandy/octopus"
     gem.authors = ["Thiago Pradi", "Mike Perham", "Amit Agarwal"]
     gem.add_development_dependency "rspec", ">= 1.2.9"
-    gem.version = "0.0.1"
+    gem.version = "0.0.2"
   end
   Jeweler::GemcutterTasks.new
 rescue LoadError

data/ar-octopus.gemspec

@@ -0,0 +1,95 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ar-octopus}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Thiago Pradi", "Mike Perham", "Amit Agarwal"]
+  s.date = %q{2010-06-14}
+  s.description = %q{This gem allows you to use sharded databases with ActiveRecord. this also provides a interface for replication and for running migrations with multiples shards.}
+  s.email = %q{tchandy@gmail.com}
+  s.extra_rdoc_files = [
+    "README.mkdn"
+  ]
+  s.files = [
+    ".gitignore",
+     "README.mkdn",
+     "Rakefile",
+     "VERSION",
+     "ar-octopus.gemspec",
+     "doc/api.textile",
+     "doc/features.textile",
+     "doc/libraries.textile",
+     "doc/shards.yml",
+     "lib/octopus.rb",
+     "lib/octopus/controller.rb",
+     "lib/octopus/migration.rb",
+     "lib/octopus/model.rb",
+     "lib/octopus/proxy.rb",
+     "spec/config/shards.yml",
+     "spec/database_connection.rb",
+     "spec/database_models.rb",
+     "spec/migrations/10_create_users_using_replication.rb",
+     "spec/migrations/11_add_field_in_all_slaves.rb",
+     "spec/migrations/1_create_users_on_master.rb",
+     "spec/migrations/2_create_users_on_canada.rb",
+     "spec/migrations/3_create_users_on_both_shards.rb",
+     "spec/migrations/4_create_users_on_shards_of_a_group.rb",
+     "spec/migrations/5_create_users_on_multiples_groups.rb",
+     "spec/migrations/6_raise_exception_with_invalid_shard_name.rb",
+     "spec/migrations/7_raise_exception_with_invalid_multiple_shard_names.rb",
+     "spec/migrations/8_raise_exception_with_invalid_group_name.rb",
+     "spec/migrations/9_raise_exception_with_multiple_invalid_group_names.rb",
+     "spec/octopus/controller_spec.rb",
+     "spec/octopus/migration_spec.rb",
+     "spec/octopus/model_spec.rb",
+     "spec/octopus/octopus_spec.rb",
+     "spec/octopus/proxy_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/tchandy/octopus}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Easy Database Sharding for ActiveRecord}
+  s.test_files = [
+    "spec/database_connection.rb",
+     "spec/database_models.rb",
+     "spec/migrations/10_create_users_using_replication.rb",
+     "spec/migrations/11_add_field_in_all_slaves.rb",
+     "spec/migrations/1_create_users_on_master.rb",
+     "spec/migrations/2_create_users_on_canada.rb",
+     "spec/migrations/3_create_users_on_both_shards.rb",
+     "spec/migrations/4_create_users_on_shards_of_a_group.rb",
+     "spec/migrations/5_create_users_on_multiples_groups.rb",
+     "spec/migrations/6_raise_exception_with_invalid_shard_name.rb",
+     "spec/migrations/7_raise_exception_with_invalid_multiple_shard_names.rb",
+     "spec/migrations/8_raise_exception_with_invalid_group_name.rb",
+     "spec/migrations/9_raise_exception_with_multiple_invalid_group_names.rb",
+     "spec/octopus/controller_spec.rb",
+     "spec/octopus/migration_spec.rb",
+     "spec/octopus/model_spec.rb",
+     "spec/octopus/octopus_spec.rb",
+     "spec/octopus/proxy_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

data/lib/octopus.rb

@@ -2,25 +2,17 @@ require "yaml"
 
 module Octopus
   def self.env()
-    if defined?(Rails)
-      Rails.env.to_s
-    else
-      "production"
-    end
+    @@env ||= defined?(Rails) ? Rails.env.to_s : "production"      
   end
   
   def self.config()
     @@config ||= YAML.load_file(Octopus.directory() + "/config/shards.yml") 
   end
 
+  # Returns the Rails.root_to_s when you are using rails
+  # Running the current directory in a generic Ruby process
   def self.directory()
-    if defined?(Rails)
-      # Running in a normal Rails application
-      Rails.root.to_s
-    else
-      # Running in a generic Ruby process
-      Dir.pwd
-    end
+    @@directory ||= defined?(Rails) ?  Rails.root.to_s : Dir.pwd     
   end
 end
 

data/lib/octopus/controller.rb

@@ -1,2 +1,15 @@
-class Octopus::Controller
-end
+module Octopus::Controller
+  def using(shard, &block)
+    older_shard = ActiveRecord::Base.connection_proxy.current_shard
+    ActiveRecord::Base.connection_proxy.block = true
+    ActiveRecord::Base.connection_proxy.current_shard = shard
+    begin
+      yield
+    ensure
+      ActiveRecord::Base.connection_proxy.block = false
+      ActiveRecord::Base.connection_proxy.current_shard = older_shard
+    end
+  end
+end
+
+ActionController::Base.send(:include, Octopus::Controller) if defined?(ActionController)

data/lib/octopus/model.rb

@@ -28,6 +28,8 @@ module Octopus::Model
         end
       end
       
+      self.reset_table_name() if self != ActiveRecord::Base && self.respond_to?(:reset_table_name)
+      
       if block_given?
         older_shard = self.connection_proxy.current_shard
         self.connection_proxy.block = true
@@ -40,6 +42,7 @@ module Octopus::Model
         end
       else
         self.connection_proxy.current_shard = shard
+        self.connection_proxy.using_enabled = true
         return self
       end
     end

data/lib/octopus/proxy.rb

@@ -1,7 +1,7 @@
 require "set"
 
 class Octopus::Proxy
-  attr_accessor :shards, :current_shard, :block, :groups, :current_group,  :replicated, :slaves_list, :replicated_models
+  attr_accessor :shards, :current_shard, :block, :groups, :current_group,  :replicated, :slaves_list, :replicated_models, :using_enabled
 
   delegate :increment_open_transactions, :decrement_open_transactions,  :to => :select_connection
 
@@ -13,6 +13,7 @@ class Octopus::Proxy
     @replicated = config[Octopus.env()]["replicated"] || false
     @shards[:master] = ActiveRecord::Base.connection_pool()
     @current_shard = :master
+    @using_enabled = false
 
     config[Octopus.env()]["shards"].each do |key, value|
       if value.has_key?("adapter")
@@ -72,19 +73,25 @@ class Octopus::Proxy
   def set_replicated_model(model)
     replicated_models << model.to_s
   end
+  
+  def add_transaction_record(record)
+    if !select_connection().instance_variable_get(:@_current_transaction_records).nil?
+      select_connection().add_transaction_record(record)
+    end
+  end
 
-  def transaction(start_db_transaction = true, &block)
+  def transaction(options = {}, &block)
     if should_send_queries_to_multiple_shards?
-      self.send_transaction_to_multiple_shards(current_shard, start_db_transaction, &block)
+      self.send_transaction_to_multiple_shards(current_shard, options, &block)
       self.current_shard = :master
     elsif should_send_queries_to_multiple_groups?
-      self.send_transaction_to_multiple_groups(start_db_transaction, &block)
+      self.send_transaction_to_multiple_groups(options, &block)
       self.current_group = nil      
     elsif should_send_queries_to_a_group_of_shards?
-      self.send_transaction_to_multiple_shards(@groups[current_group], start_db_transaction, &block)
+      self.send_transaction_to_multiple_shards(@groups[current_group], options, &block)
       self.current_group = nil
     else
-      select_connection.transaction(start_db_transaction, &block) 
+      select_connection.transaction(options, &block) 
     end
   end
 
@@ -92,6 +99,7 @@ class Octopus::Proxy
     if should_clean_connection?(method)
       conn = select_connection()
       self.current_shard = :master
+      @using_enabled = nil
       conn.send(method, *args, &block)
     elsif should_send_queries_to_replicated_databases?(method)
       send_queries_to_selected_slave(method, *args, &block)      
@@ -166,30 +174,33 @@ class Octopus::Proxy
   end
 
   def send_queries_to_selected_slave(method, *args, &block)        
-    #TODO: ugly code, needs refactor
+    #TODO: UGLY code, needs refactor
+    old_shard = self.current_shard
+
     if args.last =~ /#{replicated_models.to_a.join('|')}/
-      old_shard = self.current_shard
-      self.current_shard = slaves_list.shift.to_sym
-      slaves_list << self.current_shard      
+      if !using_enabled
+        self.current_shard = slaves_list.shift.to_sym
+        slaves_list << self.current_shard
+      end
     else
-      old_shard = self.current_shard
       self.current_shard = :master
     end
 
     sql = select_connection().send(method, *args, &block)     
     self.current_shard = old_shard
+    @using_enabled = nil
     return sql    
   end
 
-  def send_transaction_to_multiple_shards(shard_array, start_db_transaction, &block)
+  def send_transaction_to_multiple_shards(shard_array, options, &block)
     shard_array.each do |shard_symbol|
-      @shards[shard_symbol].connection().transaction(start_db_transaction, &block)
+      @shards[shard_symbol].connection().transaction(options, &block)
     end
   end
 
-  def send_transaction_to_multiple_groups(start_db_transaction, &block)
+  def send_transaction_to_multiple_groups(options, &block)
     current_group.each do |group_symbol|
-      self.send_transaction_to_multiple_shards(@groups[group_symbol], start_db_transaction, &block)
+      self.send_transaction_to_multiple_shards(@groups[group_symbol], options, &block)
     end
   end
 end

data/spec/migrations/10_create_users_using_replication.rb

@@ -0,0 +1,9 @@
+class CreateUsersUsingReplication < ActiveRecord::Migration
+  def self.up
+    Cat.create!(:name => "Replication")
+  end
+
+  def self.down
+    Cat.delete_all()
+  end
+end

data/spec/migrations/11_add_field_in_all_slaves.rb

@@ -0,0 +1,11 @@
+class AddFieldInAllSlaves < ActiveRecord::Migration
+  using(:slave1, :slave2, :slave3, :slave4)
+  
+  def self.up
+    Cat.create!(:name => "Slaves")
+  end
+
+  def self.down
+    Cat.delete_all()
+  end
+end

data/spec/octopus/controller_spec.rb

@@ -2,6 +2,36 @@ require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
 
 describe Octopus::Controller do
   it "should have the using method to select the shard" do
-    pending()
+    a = ActionController::Base.new
+    a.respond_to?(:using).should be_true
+  end
+  
+  it "should use #using method to in all requests" do
+    class UsersControllers < ActionController::Base
+      around_filter :select_shard      
+      def create
+        User.create!(:name => "ActionController")
+        render :nothing => true
+      end
+      
+      def select_shard
+        using(:brazil) do
+          yield
+        end
+      end
+      
+      def self._router
+        ActionDispatch::Routing::RouteSet.new
+      end      
+    end
+    
+    UsersControllers.action_methods.include?("create").should be_true
+    a = UsersControllers.new
+    a.stub!(:request).and_return(mock({:fullpath => "", :filtered_parameters => {}, :formats => ["xml"], :method => "GET"}))
+    a.instance_variable_set(:@_response, mock(:content_type => "xml", :body= => "", :status => 401))
+    a.process(:create)
+    
+    User.using(:brazil).find_by_name("ActionController").should_not be_nil
+    User.using(:master).find_by_name("ActionController").should be_nil
   end
 end

data/spec/octopus/migration_spec.rb

@@ -2,50 +2,40 @@ require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
 
 describe Octopus::Migration do    
   it "should run just in the master shard" do
-    ActiveRecord::Migrator.run(:up, MIGRATIONS_ROOT, 1)
-
-    User.using(:master).find_by_name("Master").should_not be_nil    
-    User.using(:canada).find_by_name("Master").should be_nil
-
-    ActiveRecord::Migrator.run(:down, MIGRATIONS_ROOT, 1)
+    migrating_to_version 1 do 
+      User.using(:master).find_by_name("Master").should_not be_nil    
+      User.using(:canada).find_by_name("Master").should be_nil
+    end
   end
 
   it "should run on specific shard" do
-    ActiveRecord::Migrator.run(:up, MIGRATIONS_ROOT, 2)
-
-    User.using(:master).find_by_name("Sharding").should be_nil    
-    User.using(:canada).find_by_name("Sharding").should_not be_nil
-
-    ActiveRecord::Migrator.run(:down, MIGRATIONS_ROOT, 2)
+    migrating_to_version 2 do 
+      User.using(:master).find_by_name("Sharding").should be_nil    
+      User.using(:canada).find_by_name("Sharding").should_not be_nil
+    end
   end
 
   it "should run on specifieds shards" do
-    ActiveRecord::Migrator.run(:up, MIGRATIONS_ROOT, 3)
-
-    User.using(:brazil).find_by_name("Both").should_not be_nil    
-    User.using(:canada).find_by_name("Both").should_not be_nil
-
-    ActiveRecord::Migrator.run(:down, MIGRATIONS_ROOT, 3)
+    migrating_to_version 3 do 
+      User.using(:brazil).find_by_name("Both").should_not be_nil    
+      User.using(:canada).find_by_name("Both").should_not be_nil
+    end
   end
 
   it "should run on specified group" do
-    ActiveRecord::Migrator.run(:up, MIGRATIONS_ROOT, 4)
-
-    User.using(:canada).find_by_name("Group").should_not be_nil
-    User.using(:brazil).find_by_name("Group").should_not be_nil    
-    User.using(:russia).find_by_name("Group").should_not be_nil
-
-    ActiveRecord::Migrator.run(:down, MIGRATIONS_ROOT, 4)
+    migrating_to_version 4 do 
+      User.using(:canada).find_by_name("Group").should_not be_nil
+      User.using(:brazil).find_by_name("Group").should_not be_nil    
+      User.using(:russia).find_by_name("Group").should_not be_nil
+    end
   end
 
   it "should run on multiples groups" do
-    ActiveRecord::Migrator.run(:up, MIGRATIONS_ROOT, 5)
-
-    User.using(:canada).where(:name => "MultipleGroup").all.size.should == 2
-    User.using(:brazil).where(:name => "MultipleGroup").all.size.should == 2
-    User.using(:russia).where(:name => "MultipleGroup").all.size.should == 2
-
-    ActiveRecord::Migrator.run(:down, MIGRATIONS_ROOT, 5)
+    migrating_to_version 5 do 
+      User.using(:canada).where(:name => "MultipleGroup").all.size.should == 2
+      User.using(:brazil).where(:name => "MultipleGroup").all.size.should == 2
+      User.using(:russia).where(:name => "MultipleGroup").all.size.should == 2
+    end
   end
 
   describe "should raise a exception when" do
@@ -66,13 +56,26 @@ describe Octopus::Migration do
     end
   end 
 
-  describe "when using replication" do
+  describe "when using replication" do    
     it "should run writes on master when you use replication" do
-      pending()
+      using_enviroment :production_replicated do 
+        migrating_to_version 10 do 
+          Cat.using(:master).where(:name => "Replication").first.should_not be_nil
+          Cat.where(:name => "Replication").first.should be_nil
+        end
+      end
     end
 
     it "should run in all shards, master or another shards" do
-      pending()
+      using_enviroment :production_replicated do 
+        migrating_to_version 11 do 
+          [:slave4, :slave1, :slave2, :slave3].each do |sym|
+            Cat.using(sym).find_by_name("Slaves").should_not be_nil
+          end
+          
+          Cat.using(:master).find_by_name("Slaves").should be_nil
+        end
+      end
     end
   end
 end

data/spec/octopus/model_spec.rb

@@ -30,26 +30,26 @@ describe Octopus::Model do
       User.using(:brazil).count.should == 0
       User.count.should == 0
     end
-    
+
     describe "passing a block" do
       it "should allow queries be executed inside the block, ponting to a specific shard" do
-         User.using(:canada) do
-           User.create(:name => "oi")
-         end
+        User.using(:canada) do
+          User.create(:name => "oi")
+        end
 
-         User.using(:canada).count.should == 1
-         User.using(:master).count.should == 0
-         User.count.should == 0      
-       end
+        User.using(:canada).count.should == 1
+        User.using(:master).count.should == 0
+        User.count.should == 0      
+      end
 
-       it "should allow execute queries inside a model" do
-         u = User.new
-         u.awesome_queries()
-         User.using(:canada).count.should == 1
-         User.count.should == 0
-       end
+      it "should allow execute queries inside a model" do
+        u = User.new
+        u.awesome_queries()
+        User.using(:canada).count.should == 1
+        User.count.should == 0
+      end
     end
-    
+
     describe "when you have a relationship" do
       it "should find all models in the specified shard" do
         pending()
@@ -63,7 +63,7 @@ describe Octopus::Model do
         # c.items.should == [item_brazil]
       end
     end
-    
+
     describe "raising errors" do
       it "should raise a error when you specify a shard that doesn't exist" do
         lambda { User.using(:crazy_shard) }.should raise_error("Nonexistent Shard Name: crazy_shard")
@@ -72,51 +72,30 @@ describe Octopus::Model do
   end
 
   describe "using a postgresql shard" do
-    after(:each) do
-      User.using(:postgresql_shard).delete_all
-    end
-    
     it "should update the Arel Engine" do
       User.using(:postgresql_shard).arel_engine.connection.adapter_name.should == "PostgreSQL"
       User.using(:alone_shard).arel_engine.connection.adapter_name.should == "MySQL"
     end
-    
+
     it "should works with writes and reads" do
-      pending()
-      #u = User.using(:postgresql_shard).create!(:name => "PostgreSQL User")
-      #       #User.using(:postgresql_shard).arel_table.columns.should == ""
-      #       User.using(:postgresql_shard).scoped.should ==  ""
-      #       User.using(:alone_shard).find(:all).should == []
+      u = User.using(:postgresql_shard).create!(:name => "PostgreSQL User")      
+      User.using(:postgresql_shard).all.should == [u]      
+      User.using(:alone_shard).find(:all).should == []
     end
   end
-  
+
   describe "#replicated_model method" do
-    before(:each) do
-      Octopus.stub!(:env).and_return("production_replicated")
-      @proxy = Octopus::Proxy.new(Octopus.config())
-      #TODO - This is ugly, but is better than mocking
-      ActiveRecord::Base.class_eval("@@connection_proxy = nil")
-      #TODO - This is ugly, but is better than mocking
-    end
-    
-    after(:each) do
-      #TODO - One little Kitten dies each time this code is executed.
-      ActiveRecord::Base.class_eval("@@connection_proxy = nil")
-    end
-    
     it "should be replicated" do
-      ActiveRecord::Base.connection_proxy.replicated.should be_true
+      using_enviroment :production_replicated do 
+        ActiveRecord::Base.connection_proxy.replicated.should be_true
+      end
     end
-    
+
     it "should mark the Cat model as replicated" do
-      Cat.all.should == []
-      ActiveRecord::Base.connection_proxy.replicated_models.first.should == "Cat"
-    end
-  end
-  
-  describe "#sharded_by method" do
-    it "should send all queries to the specify shard" do
-      pending()
+      using_enviroment :production_replicated do 
+        Cat.all.should == []
+        ActiveRecord::Base.connection_proxy.replicated_models.first.should == "Cat"
+      end
     end
   end
 end

data/spec/octopus/proxy_spec.rb

@@ -62,7 +62,6 @@ describe Octopus::Proxy do
     before(:each) do
       Octopus.stub!(:env).and_return("production_replicated")
       @proxy = Octopus::Proxy.new(Octopus.config())
-      #TODO - THIS IS SO UGLY
       ActiveRecord::Base.class_eval("@@connection_proxy = nil")
     end
     

data/spec/spec_helper.rb

@@ -2,6 +2,8 @@ MIGRATIONS_ROOT = File.expand_path(File.join(File.dirname(__FILE__),  'migration
 require 'spec'
 require 'spec/autorun'
 require "database_connection"
+require "action_pack"
+require "action_controller"
 require 'octopus'
 
 Spec::Runner.configure do |config|  
@@ -24,4 +26,24 @@ def clean_all_shards()
       ActiveRecord::Base.using(shard_symbol).connection.execute("DELETE FROM #{tables};") 
     end
   end
+end
+
+def migrating_to_version(version, &block)
+  begin
+    ActiveRecord::Migrator.run(:up, MIGRATIONS_ROOT, version)
+    yield
+  ensure
+    ActiveRecord::Migrator.run(:down, MIGRATIONS_ROOT, version)
+  end
+end
+
+def using_enviroment(enviroment, &block)
+  begin
+    Octopus.class_eval("@@env = '#{enviroment.to_s}'")
+    ActiveRecord::Base.class_eval("@@connection_proxy = nil")
+    yield
+  ensure
+    Octopus.class_eval("@@env = 'production'")      
+    ActiveRecord::Base.class_eval("@@connection_proxy = nil")
+  end
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - Thiago Pradi
@@ -16,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-06-11 00:00:00 -03:00
+date: 2010-06-14 00:00:00 -03:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -42,9 +42,11 @@ extensions: []
 extra_rdoc_files: 
 - README.mkdn
 files: 
+- .gitignore
 - README.mkdn
 - Rakefile
 - VERSION
+- ar-octopus.gemspec
 - doc/api.textile
 - doc/features.textile
 - doc/libraries.textile
@@ -57,6 +59,8 @@ files:
 - spec/config/shards.yml
 - spec/database_connection.rb
 - spec/database_models.rb
+- spec/migrations/10_create_users_using_replication.rb
+- spec/migrations/11_add_field_in_all_slaves.rb
 - spec/migrations/1_create_users_on_master.rb
 - spec/migrations/2_create_users_on_canada.rb
 - spec/migrations/3_create_users_on_both_shards.rb
@@ -106,6 +110,8 @@ summary: Easy Database Sharding for ActiveRecord
 test_files: 
 - spec/database_connection.rb
 - spec/database_models.rb
+- spec/migrations/10_create_users_using_replication.rb
+- spec/migrations/11_add_field_in_all_slaves.rb
 - spec/migrations/1_create_users_on_master.rb
 - spec/migrations/2_create_users_on_canada.rb
 - spec/migrations/3_create_users_on_both_shards.rb