Old django celery integration project.
Looking for sponsor for working on django 1.11 to 2.2 support https://github.com/celery/django-celery/issues/568
.. image:: https://user-images.githubusercontent.com/26336/59113881-917c5180-890b-11e9-9863-f5a98d0e235e.png
:Version: 3.3.1 :Web: http://celeryproject.org/ :Download: http://pypi.python.org/pypi/django-celery/ :Source: http://github.com/celery/django-celery/ :Keywords: celery, task queue, job queue, asynchronous, rabbitmq, amqp, redis, python, django, webhooks, queue, distributed
--
.. warning::
**THIS PROJECT IS ONLY REQUIRED IF YOU WANT TO USE DJANGO RESULT BACKEND
AND ADMIN INTEGRATION**
Please follow the new tutorial at:
http://docs.celeryproject.org/en/latest/django/first-steps-with-django.html
django-celery provides Celery integration for Django; Using the Django ORM
and cache backend for storing results, autodiscovery of task modules
for applications listed in INSTALLED_APPS
, and more.
To enable django-celery
for your project you need to add djcelery
to
INSTALLED_APPS
::
INSTALLED_APPS += ("djcelery", )
then add the following lines to your settings.py
::
import djcelery
djcelery.setup_loader()
Everything works the same as described in the Celery User Manual
_, except you
need to invoke the programs through manage.py
:
===================================== =====================================
Program Replace with
===================================== =====================================
celery
python manage.py celery
celery worker
python manage.py celery worker
celery beat
python manage.py celery beat
celery ...
python manage.py celery ...
===================================== =====================================
The other main difference is that configuration values are stored in
your Django projects' settings.py
module rather than in
celeryconfig.py
.
If you're trying celery for the first time you should start by reading
Getting started with django-celery
_
If you're using mod_wsgi
to deploy your Django application you need to
include the following in your .wsgi
module::
import djcelery
djcelery.setup_loader()
The Celery User Manual
_ contains user guides, tutorials and an API
reference. It also has a dedicated subsection about the Django integration
_.
.. _Celery User Manual
: http://docs.celeryproject.org/
.. _subsection about the Django integration
:
http://docs.celeryproject.org/en/latest/django/
.. _Getting started with django-celery
:
http://docs.celeryproject.org/en/latest/django/first-steps-with-django.html
You can install django-celery
either via the Python Package Index (PyPI)
or from source.
To install using pip
,::
$ pip install django-celery
To install using easy_install
,::
$ easy_install django-celery
You will then want to create the necessary tables. If you generating schema migrations, you'll want to run::
$ python manage.py migrate djcelery
Download the latest version of django-celery
from
http://pypi.python.org/pypi/django-celery/
You can install it by doing the following,::
$ tar xvfz django-celery-0.0.0.tar.gz
$ cd django-celery-0.0.0
# python setup.py install # as root
You can clone the git repository by doing the following::
$ git clone git://github.com/celery/django-celery.git
For discussions about the usage, development, and future of celery,
please join the celery-users
_ mailing list.
.. _celery-users
: http://groups.google.com/group/celery-users/
Come chat with us on IRC. The #celery channel is located at the Freenode
_
network.
.. _Freenode
: http://freenode.net
If you have any suggestions, bug reports or annoyances please report them to our issue tracker at http://github.com/celery/django-celery/issues/
http://wiki.github.com/celery/celery/
Development of django-celery
happens at Github:
http://github.com/celery/django-celery
You are highly encouraged to participate in the development. If you don't like Github (for some reason) you're welcome to send regular patches.
This software is licensed under the New BSD License
. See the LICENSE
file in the top distribution directory for the full license text.
.. # vim: syntax=rst expandtab tabstop=4 shiftwidth=4 shiftround