●Change8

Migrating to Celery v5.5.0rc5

Version v5.5.0rc5 introduces 1 breaking change. This guide details how to update your code.

Released: 2/25/2025

1
Breaking Changes
8
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

worker_soft_shutdown_timeoutworker_enable_soft_shutdown_on_idlebroker_native_delayed_delivery_queue_typetask_default_queue_typeworker_detect_quorum_queuesREMAP_SIGTERMgroupchaincassandra backend port handlingdjango db connection close handling

Breaking Changes

●Issue #1

Minimum required Kombu version has been bumped to 5.5.0; projects using an older Kombu must upgrade to Kombu >=5.5.0 to avoid import errors.

Migration Steps

  1. 1
    If using Quorum Queues, configure broker_native_delayed_delivery_queue_type as needed.
  2. 2
    Set task_default_queue_type and/or worker_detect_quorum_queues to enable Quorum Queue detection.
  3. 3
    Enable soft shutdown by adding worker_soft_shutdown_timeout (seconds) to your Celery configuration.
  4. 4
    Optionally set worker_enable_soft_shutdown_on_idle to true if you want soft shutdown to trigger even when the worker is idle.
  5. 5
    If you rely on SIGTERM for shutdown, enable REMAP_SIGTERM via configuration to map it to SIGQUIT.
  6. 6
    Update any code that explicitly creates a group with a single item; it will now be unrolled into a chain.
  7. 7
    Upgrade Python to 3.13 if you want the latest compatibility improvements.
  8. 8
    Refresh dependency versions: elasticsearch <=8.17.1, elastic-transport <=8.17.0, google-cloud-firestore 2.20.0, mypy 1.14.1, pytest-github-actions-annotate-failures 0.3.0.

Release Summary

Celery 5.5.0rc5 adds full Quorum Queue support, a new soft shutdown mechanism, Google Pub/Sub transport, and Pydantic task model support, while bumping the minimum Kombu version to 5.5.0 and fixing several bugs.

Need More Details?

View the full release notes and all changes for Celery v5.5.0rc5.

View Full Changelog