Multi-tenancy for Spree 3.0.x using the Apartment gem and Postgres as the database.
Add this line to your Spree application's Gemfile:
gem 'shopping_mall'
Then run the bundle command to install it:
bundle install
After installing ShoppingMall, run the generator:
rails generate shopping_mall:install
This will adds a shopping_mall.rb
initializer to your app, and adds the following to your production and development environment:
Rails.application.configure do |config|
...
'config.cache_store = :memory_store, { namespace: -> { ShoppingMall::Store.current } }'
...
end
Some sane defaults have been added for auto tracking of Tenants for migrations and seeds. ShoppingMall.configure
is just a pass-thru so anything that is available to Apartment
can be passed here
Check here: https://github.com/influitive/apartment for configuration options
If you have some models that should always access the public
(global) tenant, you can specify this by configuring Apartment using ShoppingMall.configure
. This will yield a config object for you. You can set excluded models like so:
config.excluded_models = ["Spree::User", ...] # these models will not be multi-tenanted, but remain in the global (public) namespace
Out of the box ShoppingMall has the following Spree model excluded: Spree::Tenant
NOTE: Rails will always access the
public
tenant when accessing excluded models, but note that tables will be created in all schemas. This may not be ideal, but its done this way because otherwise rails wouldn't be able to properly generate theschema.rb
file.
The tenant name will change depending on the elevator you are using. See the Apartment Elevators section for more information.
rake tenant:create['tenant_name_here']
If the tenant already exists, it will not be overwritten. It will need to be dropped before it can be recreated.
This elevator will use the entire subdomain, including nested subdomains. If your domain is foo.example.com
, the rake task you would need to run is:
rake tenant:create['foo']
If your domain is foo.bar.example.com
, the rake task you would need to run is:
rake tenant:create['foo.bar']
You can also exclude certain subdomains. Create a file named subdomain_exclusions.rb
in config/initializers/apartment
. Inside it add:
Apartment::Elevators::Subdomain.excluded_subdomains = ['www']
Typical subdomains may include: public
, www
and admin
Domains elevators exclude subdomains and TLD such as .com
or .co.uk
. If your domain is www.example.com
, example.com
or www.example.co.uk
, the rake task you would need to run is:
rake tenant:create['example']
Note that if the URL is anything other than www
, it will be used as part of the tenant. This means foo.example.com
would need to be:
rake tenant:create['foo.example']
This is similar to the Subdomain elevator. This will use the first available subdomain. If your domain is foo.example.com
or foo.bar.example.com
, the rake task you would need to run is:
rake tenant:create['foo']
While creating a tenant, you will be asked to create an admin at the same time. If you accept, you will be prompted to supply an email address and a password for the new admin user. If the user already exists, whether the user is an admin or not, the user will neither be created nor assigned to the admin role.
NOTE: This admin user will be created on the tenant provided in the
tenant:create
Rake task. Ifusers
is a shared table and the admin needs to be a global admin, this should be applied to the user in the Spree admin rather than in the Rake task.
You must confirm dropping the tenant before the action runs. To drop a tenant, run the following Rake task:
rake tenant:drop['tenant_name_here']
NOTE: Dropping a tenant is a destructive action. Dropping a tenant will remove all data for this tenant. There is no way to retrieve the data in the future unless backups are available.
NOTE: The
public
tenant cannot be dropped from here.
Generate a dummy application
bundle exec rake test_app
Running tests
bundle exec rake spec
- Fork it ( https://github.com/groundctrl/shopping_mall/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request