Heroku users: Simply add the IronMQ add-on and you can skip the rest of this section. It will be setup automatically when you add the IronMQ add-on.
To start using delayed_job_ironmq, you need to sign up for Iron.io and setup your credentials.
- Go to http://iron.io/ and sign up.
- Get an Oauth Token at http://hud.iron.io/tokens
- Add an iron.json file or setup environment variables for authentication. See http://dev.iron.io/articles/configuration/ for details.
Add the gems to your
gem 'delayed_job' gem 'delayed_job_ironmq'
Optionally: Add an initializer (
Delayed::Worker.configure do |config| # optional params: config.available_priorities = [-1,0,1,2] # Default is . Please note, adding new priorities will slow down picking the next job from queue. Also note that these priorities must include all priorities of your Delayed Jobs. config.queue_name = 'default' # Specify an alternative queue name config.delay = 0 # Time to wait before message will be available on the queue config.timeout = 5.minutes # The time in seconds to wait after message is taken off the queue, before it is put back on. Delete before :timeout to ensure it does not go back on the queue. config.expires_in = 7.days # After this time, message will be automatically removed from the queue. end
That's it. Use delayed_job as normal.
class User def background_stuff puts "I run in the background" end end
Then in one of your controllers:
user = User.new user.delay.background_stuff
Start worker process
That will start pulling jobs off the queue and processing them.
Compatibility with delayed_job 4.0.4 and higher
If you are using the last versions of delayed_job gem you can see the following error while running the above example :
Error while reserving job: undefined class/module User
To fix it move the user.rb file to lib/tasks/user.rake (user.rb should be renamed to user.rake) or add the path to user.rb in Rakefile:
require File.expand_path('path_to_user.rb', __FILE__)
Demo Rails Application
Here's a demo rails app you can clone and try it out: https://github.com/treeder/delayed_job_ironmq_example
Using with Heroku
To use with Heroku, just add the IronMQ Add-on and you're good to go.
You can find more documentation here: