Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Build Status Gem Version

mini_scheduler

MiniScheduler adds recurring jobs to Sidekiq.

Installation

Add this line to your application's Gemfile:

gem 'mini_scheduler'

And then execute:

$ bundle

Or install it yourself as:

$ gem install mini_scheduler

In a Rails application, create files needed in your application to configure mini_scheduler:

bin/rails g mini_scheduler:install
rake db:migrate

An initializer is created named config/initializers/mini_scheduler.rb which lists all the configuration options.

Configuring MiniScheduler

By default each instance of MiniScheduler will run with a single worker. To amend this behavior:

if Sidekiq.server? && defined?(Rails)
  Rails.application.config.after_initialize do
    MiniScheduler.start(workers: 5)
  end
end

This is useful for cases where you have extremely long running tasks that you would prefer did not starve.

Usage

Create jobs with a recurring schedule like this:

class MyHourlyJob
  include Sidekiq::Worker
  extend MiniScheduler::Schedule

  every 1.hour

  def execute(args)
    # some tasks
  end
end

Options for schedules:

  • queue followed by a queue name, like "queue :email", default queue is "default"
  • every followed by a duration in seconds, like "every 1.hour".
  • daily at: followed by a duration since midnight, like "daily at: 12.hours", to run only once per day at a specific time.

To view the scheduled jobs, their history, and the schedule, go to sidekiq's web UI and look for the "Scheduler" tab at the top.

How to reach us

If you have questions about using mini_scheduler or found a problem, you can find us at https://meta.discourse.org.

About

Adds recurring jobs for Sidekiq

Resources

Packages

No packages published
You can’t perform that action at this time.