Django Q Documentation Release 0.7.15

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

摘要

Django Q is a native Django task queue, scheduler, and worker application that uses Python multiprocessing. It supports multiple message brokers including Redis, Disque, IronMQ, SQS, and MongoDB. The documentation covers installation, configuration, compatibility, and integration with Django admin. Key features include multiprocessing worker pools, asynchronous tasks, scheduled and repeated tasks, encrypted and compressed packages, failure and success tracking, result hooks, groups, and chains. Django Q is tested with Python 2.7 & 3.5 and Django 1.8.8 & 1.9.1.

AI总结

《Django Q Documentation Release 0.7.15》是关于Django Q库的官方文档，版本为0.7.15，发布于2016年1月27日。Django Q是一个使用Python multiprocessing的原生Django任务队列、调度程序和工作者应用程序。

### 主要内容总结：

1. **安装与配置**：
- 使用`pip install Django-q`安装。
- 将`'django_q'`添加到`INSTALLED_APPS`。
- 运行Django迁移以创建数据库表。
- 配置消息经纪人（如Redis、Disque、IronMQ、SQS、MongoDB等），并安装相应的客户端库。

2. **兼容性**：
- 支持Python 2.7和3.5，以及Django 1.8.8和1.9.1。
- 注意：Django 1.7.10或更早版本与Python 3.5不兼容。

3. **操作系统**：
- **OS X**：multiprocessing.Queue.qsize()不支持，建议安装psutil。
- **Windows**：不支持fork，但可通过设置`sync=True`使用单线程集群。

4. **依赖项**：
- 必要依赖：Django、Django-picklefield、Arrow、Blessed。
- 可选依赖：psutil（CPU亲和性）、hiredis（性能优化）、boto3（AWS SQS）、pymongo（MongoDB）、iron-mq（IronMQ）、rollbar（错误通知）。

5. **监控与统计**：
- 提供`Stat`类用于获取集群状态，包括任务队列大小、进程ID、运行状态等。
- 支持通过命令行工具监控集群运行情况。

6. **管理页面**：
- 集成Django admin，显示成功任务、失败任务和统计信息。
- 支持通过过滤器和搜索功能管理任务。

7. **核心功能**：
- **任务**：异步任务处理，支持链式任务和组任务。
- **调度**：支持定时任务和重复任务。
- **集群**：多进程池，支持多集群监控。
- **结果存储**：支持数据库或缓存存储任务结果。
- **扩展性**：支持多种消息broker（Redis、Disque、IronMQ、SQS、MongoDB）。
- **错误处理**：集成Rollbar，支持错误监控和管理。

### 总结：
Django Q是一个功能强大的任务队列和调度工具，适用于Django项目的异步任务处理和集群监控。支持多种消息broker和操作系统，具有良好的扩展性和监控能力，适合需要高效任务处理的场景。