Django Q Documentation Release 0.7.18

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

摘要

文档介绍了Django Q，这是一款原生Django任务队列、调度器和工作器应用，使用Python多处理技术。它支持多进程工作池、异步任务、定时和重复任务、加密压缩包、结果钩子、组和链式任务等功能。_configuration通过settings.py中的Q_CLUSTER字典进行，包含多个选项如workers、recycle、timeout等，以控制集群行为。Django Q兼容多种消息代理（Redis、Disque、IronMQ、SQS、MongoDB和ORM），并支持Django Admin集成和监控工具。软件测试与Python 2.7、3.5和Django 1.8.13、1.9.7兼容。

AI总结

《Django Q Documentation Release 0.7.18》文档内容总结如下：

### 1. **简介**
Django Q是一款本地化的Django任务队列、调度器和工作者应用，支持多进程。其核心功能包括：
- 多进程工作者池
- 异步任务处理
- 定时和重复任务
- 加密和压缩包
- 支持失败和成功结果存储（数据库或缓存）
- 结果钩子、组和链式调用
- 集成Django Admin
- 支持多实例部署
- 集群监控
- 支持Redis、Disque、IronMQ、SQS、MongoDB或ORM
- 集成Rollbar

### 2. **配置**
Django Q通过`settings.py`中的`Q_CLUSTER`字典进行配置。关键配置项包括：
- `name`: 用于区分项目，默认值为`default`。
- `workers`: 工作者数，默认为CPU核心数。
- `recycle`: 工作者处理任务数后重启，默认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. 运行迁移命令：`python manage.py migrate`
4. 选择一个消息代理，并安装对应的客户端库。

### 4. **兼容性**
- Python：兼容2.7和3.5。
- Django：测试通过1.8.13和1.9.7版本，不再对1.7.x版本进行测试。
- 依赖包：包括`django-picklefield`、`arrow`和`blessed`。

### 5. **监控**
集群监控通过`python manage.py qmonitor`启动，显示实时信息，包括：
- 主机名
- 集群ID（进程ID）
- 状态（启动中、空闲、运行中、停止中、已停止）

### 6. **Admin界面**
Django Q的Admin界面提供了以下模型：
1. **成功任务**：显示所有成功执行的任务，可通过`group`过滤。
2. **失败任务**：显示因错误未完成的任务，可重新提交。
3. **计划任务**：显示计划中的任务。

### 7. **消息代理**
支持的消息代理包括Redis、Disque、IronMQ、SQS和MongoDB。若使用ORM作为broker，则需配置数据库。

### 8. **其他**
- 任务加密：无法解密的任务将被丢弃。
- 支持任务链式调用和组管理。
- 提供终端布局功能（适用于OS X）。

以上是文档的核心内容和关键信息，涵盖了功能特点、配置方法、安装步骤、兼容性要求以及监控和管理功能。