Shopping Mall

Multi-tenancy for Spree 3.0.x using the Apartment gem and Postgres as the database.

Installation

Add this line to your Spree application's Gemfile:

gem 'shopping_mall'

Then run the bundle command to install it:

bundle install

Generators

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

Configuration

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

Excluding Models

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 the schema.rb file.

Create Tenant (Rake Task)

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.

Subdomain

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

Domain

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']

FirstSubdomain

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']

Admin User

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. If users 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.

Drop Tenant (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.

Testing

Generate a dummy application

bundle exec rake test_app

Running tests

bundle exec rake spec

Contributing

1. Fork it ( https://github.com/groundctrl/shopping_mall/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