Spree Guides

1 Using Foreman

All application processes are managed using Foreman and a default Procfile is generated for you in the following location:

/data/spree/shared/config/Procfile

By default this includes a single Unicorn master process, the unicorn workers are configured via the Deployment Server UI.

Default Procfile contents:

web: bundle exec unicorn_rails -c /data/app_name/shared/config/unicorn.rb -p $PORT -E ENV

The provided Capistrano deployment script symlinks the Procfile into location after each deploy. Capistrano Procfile Snippet:

namespace :deploy do
  desc "Symlink shared configs and folders on each release."
  task :symlink_shared do
    run "ln -nfs #{shared_path}/config/database.yml #{release_path}/config/database.yml"
    run "ln -nfs #{shared_path}/config/Procfile #{release_path}/Procfile"
  end
end

after 'deploy:update_code', 'deploy:symlink_shared'

2 Upstart

After each deployment of your application the Procfile is exported to Upstart compatible configuration files which the operating system (Ubuntu) uses to manage your application’s processes.

Upstart is responsible for starting, stopping and restarting the processes and will detect if a process has stopped for some reason and automatically restart it. Upstart does not monitor for memory size growth, and will not restart leaky processes automatically. Controlling Processes

Using Upstart you control the processes of application in a number of ways:

2.1 All Processes

You can use following commands to start, stop or restart all the processes in your application at once:

sudo stop spree
sudo start spree
sudo restart spree

2.2 Processes by type

To control all processes of a specific type (for example web, worker, solr, etc) you can use:

sudo start spree-web
sudo stop spree-worker
sudo restart spree-solr

2.3 Individual Processes

You can control individual processes by prepending the process number (i.e. 1 for first, 2 for second, etc) at the end:

sudo start spree-web-1
sudo stop spree-worker-3
sudo restart spree-solr-2

3 Customizing Processes

To add additional processes such as Delayed Job (or other) workers to your application, complete the following steps:

• Copy the contents of the default Procfile and save it in the root our application.
• Make any additions or changes you require.
• Remove the Procfile symlink link line from your config/deploy.rb file.
• Commit your changes and deploy the application.
• When your application is deployed the new processes will be automatically started.

Sample Procfile containing Delayed Job workers:

web: bundle exec unicorn_rails -c /data/app_name/shared/config/unicorn.rb -p $PORT -E production
worker: bundle exec rake jobs:work

4 Changing process concurrency

By default the provided Capistrano script will export a single process for each entry in Procfile, for some process types you want to increase the number of processes started, for example Delayed Job workers. You can customize the number of process exported for each process type by editing the foreman:export task in the Capistrano script. Custom Capistrano deploy.rb – creating 3 worker processes:

namespace :foreman do
  desc "Export the Procfile to Ubuntu's upstart scripts"
  task :export, :roles => :app do
    run "cd #{current_path} && bundle exec foreman export upstart /etc/init -a #{application} -c worker=3 -u spree"
  end

  ... 
end

The -c (or —concurrency) switch accepts the process type and an integer for the number of processes to start up. You specify mulitple types by comma separating as follows: processname=2,processname=4

.