Django Q Documentation Release 0.7.15

• 语言: 英语
• 格式: .epub
• 来源: django-q.readthedocs.io

摘要

文档阐述了Django Q作为一个本地Django任务队列、调度和工作节点的应用，它使用Python的多进程功能来处理异步任务和定时任务。安装步骤包括使用pip安装、添加到Django应用列表中并运行迁移。配置通过settings.py中的Q_CLUSTER字典完成，支持多种消息中间件如Redis和Disque。文档还提到兼容性问题，Django Q支持Django 1.8.8和1.9.1，但不再测试Django 1.7。文档还详细介绍了任务管理，包括成功任务、失败任务和已安排任务的处理，以及Admin界面的集成。

AI总结

《Django Q Documentation Release 0.7.15》文档总结：

### 1. 项目介绍
Django Q 是一个 native 的 Django 任务队列、调度器和 worker 应用程序，使用 Python 的 multiprocessing模块。它支持多种功能，包括：
- 多进程 worker 池
- 异步任务
- 定时任务和重复任务
- 加密和压缩的任务包
- 处理任务失败和成功的数据库或缓存
- 任务钩子、组和链
-集成 Django Admin
- 支持 PaaS，兼容多实例和多集群
- 支持 Redis、Disque、IronMQ、SQS、MongoDB 或 ORM
- 支持 Rollbar

### 2. 配置
配置通过 settings.py 中的 Q_CLUSTER 字典完成，所有配置项都是可选的，主要包括：
- name：用于区分使用相同 broker 的项目，默认为 'default'。
- workers： worker 数量，默认为当前主机的 CPU 核数。
- recycle： worker 处理任务的数量后重启，用于释放内存，默认为 500。
- timeout：任务超时时间，单位为秒， 默认为 60。
- compress：是否压缩任务包，默认为 True。
- save_limit：成功任务的最大保存数量， 默认为 250。
- queue_limit：队列的最大任务数量， 默认为 500。
- redis：配置 Redis 服务，包括 host、port 和 db。

### 3. 安装
安装步骤如下：
1. 使用 pip 安装最新版本：

   pip install django-q

2. 将 'django_q' 添加到项目的 INSTALLED_APPS。
3. 运行 Django 数据库迁移命令：

   python manage.py migrate

4. 选择并配置一个消息 broker，并安装相应的客户端库。

### 4. 管理界面
Django Q 的管理界面基于 Django 的 model admin，包括以下三个模型：
- **成功任务**：显示所有成功执行的任务，支持按名称、func 和组筛选，最大保存数量由 save_limit 配置。
- **失败任务**：显示因错误未执行完成的任务，支持将任务重新提交到队列。
- **定时任务**：显示所有已调度的任务。

### 5. 依赖和兼容性
- **Python**：测试通过 Python 2.7 和 3.5。
- **Django**：支持 Django 1.8.8 和 1.9.1，兼容 Django 1.7 但不再进行测试。
- **依赖包**：包括 django-picklefield、arrow 和 blessed。

### 6. 功能亮点
- **多进程**：通过 worker 池实现并发任务处理。
- **异步任务**：支持异步执行任务。
- **结果处理**：支持任务结果的加密和压缩。
- **集成与扩展**：支持多种 broker 和 PaaS， 具备良好的扩展性。

通过以上内容，用户可以快速了解 Django Q 的功能、配置、安装和使用， 并针对实际需求进行部署和调整。