Django Q Documentation Release 0.5.3

语言	格式	评分
英语	.epub	3
摘要
Django Q 是一个基于 Django 的任务队列、调度和工作进程应用，使用 Python 多进程技术。它支持异步任务、 scheduled 和重复任务，提供加密和压缩功能，并与 Redis 集成。文档介绍了其安装、配置、任务管理以及集群监控等功能，包括如何使用 Django 管理命令启动和停止集群，如何处理任务的成功与失败，以及如何通过 Django 行政界面进行管理。
AI总结
### Django Q 0.5.3 文档总结 #### 1. 简介 Django Q 是一个基于 Django 的任务队列、调度和工作者应用程序，使用 Python 多进程技术。它支持异步任务、计划任务和重复任务，并提供 Django Admin 集成。 --- #### 2. 核心功能 - 多进程工作池：使用 Python 的 multiprocessing 模块管理一组工作者。 - 异步任务：支持异步任务处理。 - 计划和重复任务：支持按计划或重复执行任务。 - 加密和压缩包：任务数据经过加密和压缩。 - 结果数据库：记录任务的成功与失败结果。 - 结果钩子和分组：支持任务完成后调用钩子函数，以及任务分组管理。 - Django Admin 集成：通过 Django 的 admin 界面管理任务。 - 多实例 PaaS 兼容性：支持多实例部署。 - 多集群监控：支持多集群管理。 - Redis 中间件：使用 Redis 作为任务队列 broker。 - Python 2 和 3 支持：兼容 Python 2.7 和 3.4，以及 Django 1.7.10 和 1.8.4。 --- #### 3. 安装与配置 - 安装：使用 pip 安装： ```bash $ pip install Django-q ``` - 配置：在 Django 项目中添加 `django_q` 到 `INSTALLED_APPS`，并运行 Django 迁移： ```bash $ python manage.py migrate ``` - 依赖： - Django - Django-picklefield - Redis-py - Arrow - Blessed --- #### 4. 任务管理 - 异步任务：使用 `async()` 函数将任务加入队列。 - 计划任务：使用 `schedule()` 函数创建计划任务。 - 任务结果： - 成功任务：记录成功执行的任务，可通过 admin 界面查看和删除。 - 失败任务：记录失败的任务，支持重新提交失败任务。 - 任务分组：支持任务分组，便于管理和筛选。 --- #### 5. 集群管理 - 启动集群：使用 `manage.py qcluster` 启动： ```bash $ python manage.py qcluster ``` - 停止集群：通过 `Ctrl-C` 或信号（`SIGTERM` 和 `SIGKILL`）停止。 - 配置选项： - 工人数（workers） - 超时时间（timeout） - 任务回收（recycle） - CPU 亲和性（cpu_affinity） --- #### 6. Django Admin 集成 - 成功任务：显示所有成功执行的任务，支持按组筛选。 - 失败任务：显示所有失败的任务，支持重新提交。 - 计划任务：显示所有计划任务，支持按组筛选。 --- #### 7. 示例 - 发送邮件：将耗时的邮件发送任务排队处理。 - 信号处理：在 Django 模型信号触发后异步执行任务。 - Redis 连接池：优化 Redis 连接复用，避免连接数耗尽。 --- #### 8. 参考 - async() 函数：用于将任务加入队列，支持自定义超时、保存设置和同步执行。 - 配置参数：包括队列大小、Redis 连接池配置等。 - 任务状态：可通过 admin 界面查看任务的执行状态和结果。 --- #### 9. 总结 Django Q 是一个功能强大的任务队列和调度工具，适合在 Django 项目中处理异步任务和计划任务。其多进程、Redis 支持和 Django Admin 集成使其在开发和生产环境中具有广泛的应用场景。