Django Q Documentation Release 0.7.11

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

摘要

文档阐述了Django Q 0.7.11版本的功能和使用方法。Django Q是一个原生的Django任务队列、调度器和worker应用程序，使用Python的多处理。它支持多处理worker池、异步任务、定时任务、加密和压缩的数据包、失败和成功数据库或缓存、结果钩子、组和链，以及Django Admin集成等功能。此外，它还支持多种消息代理如Redis、Disque、IronMQ、SQS、MongoDB或ORM。安装步骤包括使用pip安装、添加django_q到INSTALLED_APPS、运行迁移命令以及配置消息代理。配置通过settings.py中的Q_CLUSTER字典进行，支持多种选项如工人数量、回收、超时、压缩等。监控功能通过manage.py qmonitor命令启动，显示集群的实时信息，如主机名、集群ID、状态、池等信息。

AI总结

以下是对文档内容的简要总结：

**Django Q 0.7.11 文档总结**

---

### 项目简介
Django Q 是一个基于 Python 多进程的本地 Django 任务队列、调度器和工作节点应用程序。它支持多种功能，包括：
- 多进程工作池
- 异步任务
- 定时和重复任务
- 加密和压缩的任务包
- 失败与成功记录（支持数据库或缓存）
- 结果钩子、组和链式调用
- Django Admin 集成
- 多实例和多集群监控
- 支持 Redis、Disque、IronMQ、SQS、MongoDB 或 ORM
-兼容 Python 2 和 3

---

### 功能特点
- **任务处理**：支持异步任务、定时任务和重复任务。
- **集群监控**：提供实时监控功能，显示集群状态、主机信息、进程 ID 等。
- **任务管理**：包括任务加密、压缩、失败重试和资源回收。
- **Admin 集成**：通过 Django Admin 提供任务管理界面，支持成功任务、失败任务和定时任务的查看与操作。

---

### 安装及配置
1. **安装**：
- 使用 pip 安装：`pip install django-q`
- 添加 `django_q` 到 `INSTALLED_APPS`。
- 运行迁移命令：`python manage.py migrate`。
- 选择消息代理（如 Redis、Disque 等）并安装对应的客户端库。

2. **配置**：
- 在 `settings.py` 中添加 `Q_CLUSTER` 配置字典，例如：

     Q_CLUSTER = {
         'name': 'myproject',
         'workers': 8,
         'recycle': 500,
         'timeout': 60,
         # 其他配置项
     }

- 配置项包括工作线程数、任务回收、超时时间、压缩、任务限制等。

---

### 集群监控
- 使用 `python manage.py qmonitor` 启动监控工具。
- 监控信息包括：
- 主机（Host）：服务器 hostname。
- 集群 ID（Id）：集群进程 ID。
- 集群状态（State）：启动中、空闲、工作中、停止中、已停止。

---

### Admin 界面
Django Q 提供以下模型管理员界面：
- **成功任务**（Successful tasks）：显示所有成功执行的任务，支持按名称、函数或组筛查。
- **失败任务**（Failed tasks）：显示因错误未完成的任务，支持重新提交失败任务。
- **定时任务**（Scheduled tasks）：显示定时任务信息。

---

### 其他信息
- **兼容性**：
- 测试通过的 Python 版本：2.7 和 3.5。
- 测试通过的 Django 版本：1.7.10、1.8.5 和 1.9b1。
- **依赖项**：
- `django-picklefield`：用于存储任务参数和结果。
- `arrow`：用于任务调度。
- `blessed`：用于监控终端界面布局。

---

以上是文档的核心内容和关键信息，重点突出了功能、安装、配置、监控和 Admin 界面等部分的核心要点。