Resque::Plugins::RealSerialQueues
This plugin modifies resque's' job reservation process to first check if there is another job from the same queue as the potential job currently being processed by one of your workers and tells the worker to check again after its sleep cycle.
It is primarily meant to be used to queue long running background jobs across multiple queues in conjunction with something like resque-scheduler
A key difference between this and resque-lonely_job is that the queue is not touched when we check to see if we can process the job (thus there is no danger of your queues getting processed in a different order). However, because we must check all the workers currently working on the system this plugin may not scale well to large numbers of workers.
This gem is under active development - so please use caution if your jobs are responsible for controlling rocket ships or providing food and shelter to young children.
Installation
Add this line to your application's Gemfile:
gem 'resque-real-serial-queues'
And then execute:
$ bundle
Or install it yourself as:
$ gem install resque-real-serial-queues
Usage
Just load up plugin somewhere in your project's initializers:
require 'resque_real_serial_queues'
In rails adding
resque_real_serial_queues.rb
to your
config/initializers
directory with the above line should do the trick.
Note that this will currently affect all queues
Configuration and Adding Non-Serial Queues
By default all queues are considered serial if you just install the plugin. If you'd like to have some queues that do not get processed serially - you can add them via a configuration option after you require the plugin:
# you can pass it straight in as a hash
Resque::Plugins::RealSerialQueues.config = {
non_serial_queues: ['non_serial_queue_one', 'non_serial_queue_two']
}
# or you can place it in a config file
require 'yaml'
Resque::Plugins::RealSerialQueues.config = YAML.load_file('your_config_file.yml')
If you choose to use a YAML config file - the queue names must be specified as a list:
non_serial_queues:
- non_serial_queue_one
- non_serial_queue_two
Not specifying any configuration will cause all queues to be processed serially.
Contributing
- Fork it ( https://github.com/[my-github-username]/resque-real-serial-queues/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