ancorcruz / resque-heroku-signals

Patch resque to be compatible with Heroku

resque-heroku-signals

This gem patches resque to be compatible with the Heroku platform. Specifically it modifies the UNIX signaling logic to be compatible with the Heroku worker shutdown process.

Read this GitHub comment for more context & details.

The version of this gem corresponds to the version of Resque that it is compatible with.

Installation

Add this line to your application's Gemfile:

gem 'resque-heroku-signals'

Since this gem monkeypatches the Heroku worker the gemspec is locked to a x.x.x version of Resque. Issue a PR if this is not compatible with the version of resque you are using.

Example Procfile

worker: env QUEUE=* TERM_CHILD=1 INTERVAL=0.1 RESQUE_PRE_SHUTDOWN_TIMEOUT=20 RESQUE_TERM_TIMEOUT=8 bundle exec rake resque:work

• RESQUE_PRE_SHUTDOWN_TIMEOUT time a job has to finish up before the TermException exception is raised
• RESQUE_TERM_TIMEOUT time the job has to cleanup & save state
• Total shutdown time should be less than 30s. This is the time Heroku gives you to cleanup before a SIGKILL is issued
• INTERVAL seconds to wait between jobs

Also, make you don't buffer logs: import log messages could fail to push to stdout during the worker shutdown process:

$stdout.sync = true

License

The gem is available as open source under the terms of the MIT License.