Django Q Documentation Release 0.7.14

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

摘要

文档详细介绍了Django Q 0.7.14版本的功能、安装和配置。Django Q是一个原生Django任务队列、调度器和使用Python多处理的工作应用。它支持多处理工作者池、异步任务、定期任务、结果钩子、群组和链式调用，以及与Django Admin的集成。默认使用Redis作为消息代理，支持多种配置选项如超时设置、重试机制、压缩和资源回收。监控功能通过Django的缓存框架实现，提供任务队列管理和状态监控。安装步骤包括使用pip安装、添加到INSTALLED_APPS、运行迁移以及配置消息代理。

AI总结

《Django Q Documentation Release 0.7.14》总结

本文档是Django Q版本0.7.14的官方文档，Django Q是一个支持任务队列、调度和多进程 worker 的Django应用，兼容Django 1.8.8和1.9.1版本。以下是文档的核心内容和关键信息总结：

---

### **1. 主要特性**
- **任务管理**：
- 支持多进程 worker 池。
- 提供异步任务、定时任务和重复任务功能。
- **任务处理**：
- 支持加密和压缩的任务包。
-_failure 和 success 结果记录到数据库或缓存。
- 提供结果钩子、任务组和任务链。
- **集成与兼容性**：
-集成Django Admin。
-支持多实例PaaS部署。
-支持Redis、Disque、IronMQ、SQS、MongoDB或ORM等消息代理。
-支持Rollbar错误报告。

---

### **2. 安装**
- **步骤**：
1. 使用pip安装最新版本：`pip install django-q`。
2. 在`settings.py`中添加`'django_q'`到`INSTALLED_APPS`。
3. 运行迁移命令：`python manage.py migrate`。
4. 选择并配置消息代理者，并安装对应的客户端库。

---

### **3. 配置**
- 配置通过`settings.py`中的`Q_CLUSTER`字典完成，所有设置均为可选。
- **主要配置项**：
- **name**：用于区分项目，默认为`'default'`。
- **workers**：worker数量， 默认为CPU核心数，但可自定义。
- **recycle**：worker处理任务数后重启，默认500。
- **timeout**：任务超时时间，默认无限（`None`）。
- **compress**：是否压缩任务包，默认`False`。
- **save_limit**：成功任务保存数量限制，默认250。
- **queue_limit**：单个集群内存中保留的任务数，默认`workers**2`。

---

### **4. 消息代理者**
- **Redis**：
- 支持原子性操作。
- 需要`redis`库。
- 不支持递送收据。
- **Disque**：
- 支持递送收据，确保任务分发到worker。
- 需要Django缓存框架。
- 支持批量任务吞吐。
- **IronMQ**：
- 基于HTTP的队列服务。
- 支持递送收据和批量任务吞吐。
- 需要`iron-mq`库。

---

### **5. 监控**
- 使用`qmonitor`命令启动监控工具。
- 监控 mostra 是通过Django缓存框架实现的。
- **关键指标**：
- Host：运行集群的服务器主机名。
- State：集群状态（启动中、空闲、运行、停止中、停止）。
- Pool：当前worker池中的worker数量。
- Task Queue：队列中任务数，持续增高可能表明任务处理能力不足。

---

### **6. Admin界面**
- **模型**：
1. **成功任务**：显示成功执行的任务，记录详细信息，可通过名称、func或group筛选。
2. **失败任务**：记录任务失败的错误信息，可通过Admin重新提交失败任务。
3. **定时任务**：管理定时任务的状态、创建或删除操作。

---

### **7. 其他**
- **兼容性**：支持Python 2.7和3.5，建议使用Django 1.8.8或1.9.1。
- **错误处理**：任务失败时，错误信息会记录到结果字段中。

---

以上是文档的核心内容和关键信息，涵盖了Django Q的功能、安装、配置、消息代理者、监控和Admin界面等方面，旨在帮助用户快速了解Django Q的使用和配置。