django-celery 技术文档

1. 安装指南

通过 PyPI 安装

使用 pip 命令安装 django-celery:

$ pip install django-celery

或者使用 easy_install 命令：

$ easy_install django-celery

安装后，需要创建相应的数据库表。如果你使用的是自动生成模式迁移，运行以下命令：

$ python manage.py migrate djcelery

从源代码安装

从 PyPI 下载最新版本的 django-celery 源代码包，然后执行以下步骤进行安装：

$ tar xvfz django-celery-0.0.0.tar.gz
$ cd django-celery-0.0.0
# python setup.py install # 以 root 用户身份执行

使用开发版本

你可以通过以下命令克隆 git 仓库以获取开发版本：

$ git clone git://github.com/celery/django-celery.git

2. 项目的使用说明

为了在项目中启用 django-celery，需要将其添加到 INSTALLED_APPS 设置中：

INSTALLED_APPS += ("djcelery",)

然后在 settings.py 文件中添加以下代码：

import djcelery
djcelery.setup_loader()

在使用 django-celery 时，所有 Celery 相关的命令都需要通过 manage.py 来调用。例如：

原始命令	替换为
celery	python manage.py celery
celery worker	python manage.py celery worker
celery beat	python manage.py celery beat
celery ...	python manage.py celery ...

配置值应该存储在 Django 项目的 settings.py 模块中，而不是 celeryconfig.py。

如果是第一次尝试使用 celery，建议阅读 Getting started with django-celery。

对于使用 mod_wsgi 部署的用户，需要在 .wsgi 文件中包含以下内容：

import djcelery
djcelery.setup_loader()

3. 项目API使用文档

django-celery 的 API 使用与 Celery 用户手册中描述的相同，详细内容可以参考 Celery User Manual 以及其中的 Django integration 部分。

4. 项目安装方式

请参考安装指南部分，安装方式包括通过 PyPI 使用 pip 或 easy_install 安装，以及从源代码或 git 仓库安装。