1
0
Fork 0
mirror of https://github.com/mperham/sidekiq.git synced 2022-11-09 13:52:34 -05:00
mperham--sidekiq/Pro-3.0-Upgrade.md
Mike Perham 99667863e8 Remove note about ephemeral_hostname
It was a hack and I don't want to document or support it long-term.  Instead call out timed_fetch as the right solution for most people.
2016-04-26 10:23:45 -07:00

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'