mperham--sidekiq/docs/Pro-3.0-Upgrade.md

1.3 KiB

Welcome to Sidekiq Pro 3.0!

Sidekiq Pro 3.0 is designed to work with Sidekiq 4.0.

What's New

  • Redis 2.8.0 or greater is required. Redis 2.8 was released two years ago and contains many useful features which Sidekiq couldn't leverage until now. Redis 3.0.3 or greater is recommended for large scale use.

  • Sidekiq Pro no longer uses Celluloid. If your application code uses Celluloid, you will need to pull it in yourself.

  • Pausing and unpausing queues is now instantaneous, no more polling!

  • Reliable fetch has been re-implemented due to the fetch changes in Sidekiq 4.0.

  • Support for platforms without persistent hostnames. Since the reliable_fetch algorithm requires a persistent hostname, an alternative reliability algorithm is now available for platforms like Heroku and Docker:

Sidekiq.configure_server do |config|
  config.timed_fetch!
end

The wiki contains much more detail about each reliability option.

  • The old 'sidekiq/notifications' features have been removed.

Upgrade

First, make sure you are using Redis 2.8 or greater. Next:

  • Upgrade to the latest Sidekiq Pro 2.x.
gem 'sidekiq-pro', '< 3'
  • Fix any deprecation warnings you see.
  • Upgrade to 3.x.
gem 'sidekiq-pro', '< 4'