Django Q Documentation Release 0.7.16

语言	格式	评分
英语	.pdf	3
摘要
The document provides comprehensive documentation for Django Q, a native Django task queue, scheduler, and worker application. It supports features such as asynchronous tasks, scheduled and repeated tasks, encrypted and compressed packages, and integration with multiple brokers like Redis, Disque, IronMQ, SQS, and MongoDB. The configuration is handled via the Q_CLUSTER dictionary in settings.py, allowing customization of worker count, timeouts, queue limits, and more. Django Q also provides result hooks, groups, and chains, and is compatible with Django versions 1.8.11 and 1.9.4.
AI总结
《Django Q Documentation Release 0.7.16》文档总结如下： --- ### 1. 特性 - 支持多进程worker池、异步任务、定时任务和重复任务。 - 任务包加密和压缩，确保安全性。 - 支持将成功和失败的任务存储到数据库或缓存。 - 提供结果钩子、任务组和链式调用功能。 - 集成Django Admin，支持多实例部署和集群监控。 - 支持多种消息代理：Redis、Disque、IronMQ、SQS、MongoDB等。 - 兼容PaaS环境，支持Rollbar错误报告。 --- ### 2. 安装 - 使用pip安装最新版本：`pip install django-q`。 - 添加`django_q`到`INSTALLED_APPS`。 - 运行数据库迁移：`python manage.py migrate`。 - 配置消息代理并安装对应的客户端库。 --- ### 3. 配置 - 通过`Q_CLUSTER`字典在`settings.py`中配置。 - 主要配置项： - `name`：项目名称，用于区分多个项目。 - `workers`：worker数量，默认为CPU核数。 - `timeout`：任务超时时间，默认为60秒。 - `retry`：broker等待任务完成的时间，默认60秒。 - `compress`：是否压缩任务包，，默认False。 - `save_limit`：成功任务存储数量，默认250。 - `queue_limit`：单个集群内存中的任务数量，默认为`workers2`。 - 其他选项包括`cpu_affinity`、`label`、`catch_up`等。 --- ### 4. 架构 - 签名任务：任务被Pickled后用Django的签名模块加密，确保任务只能被授权的节点读取。 - Broker：负责接收任务并分发给集群，支持至少一次投递。 - 失败处理**：任务失败后会被标记为失败并保留，支持重试机制。 --- ### 5. 消息代理 - 支持多种代理，如Redis、Disque、IronMQ、SQS等。 - 提供代理管理方法：创建、删除队列，检查队列大小，测试代理连通性等。 --- ### 6. 任务 - 通过`async()`函数快速创建任务： ```python from django_q.tasks import async task_id = async('math.copysign', 2, -2) ``` - 任务支持选项： - `hook`：任务完成后的回调函数。 - `group`：任务组别，用于批量操作。 - `timeout`：单次任务超时时间。 - `sync`：同步执行任务，适用于测试。 - 其他选项包括`cached`、`broker`、`task_name`等。 --- ### 7. 兼容性 - 支持Python 2.7 & 3.5，Django 1.8.11 & 1.9.4。 - 力求与Django的前两大版本兼容。 --- ### 总结 Django Q是一款功能强大的Django任务队列和调度工具，支持多种消息代理和丰富的配置选项，适用于异步任务处理、定时任务调度以及分布式集群管理。