Django Q Documentation Release 0.7.11

以下是对文档内容的简要总结： **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` 配置字典，例如： ```python 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 界面等部分的核心要点。