Django Q Documentation Release 0.7.16

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

摘要

文档详细介绍了Django Q版本0.7.16的功能、安装及配置方法。Django Q是一个原生Django任务队列、调度器和工作应用，支持多进程、异步任务、定时任务、失败重试等功能。其配置通过settings.py中的Q_CLUSTER字典实现，可选项包括worker数量、超时设置、队列限制等。此外，文档还提供了使用示例，如异步发送邮件和利用Django信号触发任务，并涵盖了Admin界面对成功任务、失败任务和定时任务的管理。文档强调了Django Q对Python 2.7、3.5以及Django 1.8、1.9版本的兼容性，并提供了所需的依赖包及其版本信息。

AI总结

以下是对《Django Q Documentation Release 0.7.16》文档内容的总结：

---

### 总结

**Django Q 简介**
Django Q 是一个原生 Django 任务队列、调度器和 worker 应用，使用 Python 多进程技术。它支持多种功能，包括：
- 多进程 worker 集群
- 异步任务
- 定时任务和重复任务
- 加密和压缩任务包
- 失败和成功记录存储（数据库或缓存）
- 结果钩子、任务组和任务链
- Django 管理界面集成
- 多平台兼容，支持多实例和集群监控
- 支持 Redis、Disque、IronMQ、SQS、MongoDB 或 ORM

**兼容性**
- 测试通过 Python 2.7 & 3.5
- 测试通过 Django 1.8.11 & 1.9.4

---

### 核心功能
1. **异步任务**
- 通过 `async()` 函数执行异步任务，适用于耗时操作（如发送邮件）。
- 示例：

     async('django.core.mail.send_mail', '邮件标题', '邮件内容', '发件人', '收件人邮箱')  

2. **定时任务**
- 通过 `schedule()` 函数执行定时任务，支持一次性或重复执行。
- 示例：

     schedule('django.core.mail.send_mail', '邮件标题', '邮件内容', '发件人', '收件人邮箱',  
              schedule_type=Schedule.ONCE, next_run=timezone.now() + timedelta(hours=1))  

3. **信号集成**
- 使用 Django 模型信号触发异步任务，避免阻塞模型保存或创建操作。
- 示例：

     @receiver(pre_save, sender=User)  
     def my_signal(sender, instance, **kwargs):  
         async('myapp.tasks.my_task', instance)  

---

### 安装与配置
1. **安装**
- 使用 pip 安装：

     pip install django-q  

- 添加 `django_q` 到 `INSTALLED_APPS` 并运行迁移：

     python manage.py migrate  

2. **配置**
- 在 `settings.py` 中配置 `Q_CLUSTER`：

     Q_CLUSTER = {  
         'name': 'myproject',  
         'workers': 8,  # 默认为当前主机的 CPU 核数  
         'recycle': 500,  # 工作进程处理任务数后重启  
         'timeout': 60,  # 任务超时时间（秒）  
         'compress': True,  # 是否压缩任务数据  
         'save_limit': 250,  # 成功任务的最大保存数量  
         'redis': {  
             'host': '127.0.0.1',  
             'port': 6379,  
             'db': 0,  
         },  
     }  

---

### Admin 页面
Django Q 通过 Django 的模型管理界面提供以下功能：
- **成功任务**：显示所有成功执行的任务，可筛选和删除。
- **失败任务**：显示所有失败任务，可重提交到队列。
- **定时任务**：管理计划任务的执行状态。

---

### 依赖与兼容性
- **依赖包**：包括 `django-picklefield`、`arrow` 和 `blessed`。
- **兼容性**：
- 测试通过 Python 2.7 和 3.5。
- 测试通过 Django 1.8.11 和 1.9.4。
- 1.7 版本可能兼容，但不再测试。

---

以上是文档的核心内容和关键信息的总结，涵盖了功能、安装、配置和管理等主要方面。