https://github.com/mperham/sidekiq
Raw File
Tip revision: fc7b7d8532549553673d4e510894b10a063792b3 authored by Mike Perham on 19 April 2022, 20:56:50 UTC
bump, release
Tip revision: fc7b7d8
Pro-3.0-Upgrade.md
# 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:
```ruby
Sidekiq.configure_server do |config|
  config.timed_fetch!
end
```
  The wiki contains [much more detail about each reliability option](https://github.com/mperham/sidekiq/wiki/Pro-Reliability-Server).

* 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.
```ruby
gem 'sidekiq-pro', '< 3'
```
* Fix any deprecation warnings you see.
* Upgrade to 3.x.
```ruby
gem 'sidekiq-pro', '< 4'
```
back to top