redbeat

RedBeat is a Celery Beat Scheduler that stores the scheduled tasks and runtime metadata in Redis.

Github stars Tracking Chart

RedBeat

.. image:: https://img.shields.io/pypi/v/celery-redbeat.svg
:target: https://pypi.python.org/pypi/celery-redbeat
:alt: PyPI

.. image:: https://img.shields.io/circleci/project/github/sibson/redbeat.svg
:target: https://circleci.com/gh/sibson/redbeat/
:alt: Circle CI

.. image:: https://readthedocs.org/projects/redbeat/badge/?version=latest&style=flat
:target: https://redbeat.readthedocs.io/en/latest/
:alt: ReadTheDocs

RedBeat <https://github.com/sibson/redbeat>_ is a
Celery Beat Scheduler <http://celery.readthedocs.org/en/latest/userguide/periodic-tasks.html>_
that stores the scheduled tasks and runtime metadata in Redis <http://redis.io/>_.

Why RedBeat?

#. Dynamic live task creation and modification, without lengthy downtime
#. Externally manage tasks from any language with Redis bindings
#. Shared data store; Beat isn't tied to a single drive or machine
#. Fast startup even with a large task count
#. Prevent accidentally running multiple Beat servers

For more background on the genesis of RedBeat see this blog post <https://blog.heroku.com/redbeat-celery-beat-scheduler>_

Getting Started

Install with pip:

.. code-block:: console

pip install celery-redbeat

Configure RedBeat settings in your Celery configuration file:

.. code-block:: python

redbeat_redis_url = "redis://localhost:6379/1"

Then specify the scheduler when running Celery Beat:

.. code-block:: console

celery beat -S redbeat.RedBeatScheduler

RedBeat uses a distributed lock to prevent multiple instances running.
To disable this feature, set:

.. code-block:: python

redbeat_lock_key = None

More details available on Read the Docs <https://redbeat.readthedocs.io/en/latest/>_

Development

RedBeat is available on GitHub <https://github.com/sibson/redbeat>_

Once you have the source you can run the tests with the following commands::

pip install -r requirements.dev.txt
py.test tests

You can also quickly fire up a sample Beat instance with::

celery beat --config exampleconf

Main metrics

Overview
Name With Ownersibson/redbeat
Primary LanguagePython
Program languagePython (Language Count: 2)
Platform
License:Apache License 2.0
所有者活动
Created At2015-08-20 13:10:07
Pushed At2025-10-26 05:17:28
Last Commit At2020-06-08 01:31:10
Release Count29
Last Release Namev2.3.3 (Posted on 2025-07-02 21:08:13)
First Release Namev0.8pre (Posted on 2016-01-09 15:11:21)
用户参与
Stargazers Count1k
Watchers Count19
Fork Count138
Commits Count617
Has Issues Enabled
Issues Count142
Issue Open Count26
Pull Requests Count120
Pull Requests Open Count6
Pull Requests Close Count36
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private