Django Q Documentation Release 0.7.18

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

摘要

Django Q 是一个专为 Django 设计的原生任务队列、调度和工人应用程序，使用 Python 多进程。它支持异步任务、计划任务、加密和压缩任务包等功能，并提供集群监控和多种消息队列后端（如 Redis、Disque、SQS 等）。文档详细介绍了其安装配置、集群管理、监控功能以及与 Django 的集成方式，并提供了示例用法。

AI总结

《Django Q 0.7.18 文档总结》

Django Q 是一个基于 Django 的任务队列、调度和工人应用程序，使用 Python 的 multiprocessing 模块。其主要功能包括：

1. **核心功能**
- 多进程工作池
- 异步任务处理
- 计划和重复任务
- 加密和压缩的任务包
- 成功和失败结果的数据库或缓存存储
- 结果钩子、任务组和链
- Django Admin 集成
- 支持多实例的 PaaS 环境
- 多种消息队列后端（Redis、Disque、IronMQ、SQS、MongoDB 或 ORM）

2. **兼容性**
- Python 版本：2.7 & 3.5
- Django 版本：1.8.13 & 1.9.7

3. **安装与配置**
- 使用 pip 安装：`pip install Django-q`
- 将 `Django_q` 添加到 `INSTALLED_APPS`
- 运行 Django 迁移
- 配置消息代理并安装相应客户端库

4. **配置参数**
- `workers`：指定工作进程数量，默认为 CPU 核心数
- `recycle`：指定每个工人处理任务的数量上限
- `timeout`：任务超时时间
- `compress`：是否压缩任务数据
- `save_limit`：保存结果的最大数量
- `queue_limit`：队列中的任务数量限制
- `redis`：Redis 配置参数

5. **运行与监控**
- 使用 `manage.py qcluster` 启动集群
- 使用 `manage.py qmonitor` 监控集群状态
- 支持多集群部署，需满足相同 Broker、集群名称和 SECRET_KEY

6. **使用场景**
- **邮件发送**：异步处理邮件发送任务
- **信号处理**：在模型信号触发后异步执行相关操作
- **报告生成**：后台生成复杂报告
- **其他任务**：如搜索、索引等后台任务

7. **注意事项**
- 任务加密：工人无法解密的任务将被丢弃或标记为失败
- 多集群需确保使用相同的 Broker 和配置
- 推荐使用 ` Circus` 或 `Supervisor` 管理进程

Django Q 提供了一个强大且灵活的任务队列解决方案，适用于需要异步处理和任务调度的 Django 项目。