Django Q Documentation Release 0.6.4

语言	格式	评分
英语	.pdf	3
摘要
文档介绍了Django Q 0.6.4版本的功能、安装配置和使用方法。Django Q是一个用于在Django项目中实现任务队列和调度器的工具，支持异步任务、计划任务和重复任务。文档详细说明了安装步骤、配置选项、支持的消息代理（如Redis、Disque、IronMQ和SQS）以及任务管理功能，包括任务分组、结果查询和监控界面。此外，文档还提供了如何集成Django管理命令和处理任务失败与成功的指导。
AI总结
### Django Q 0.6.4 文档总结 #### 概述 Django Q 是一个用于处理异步任务、调度和集群管理的 Django 应用，支持多种消息代理（如 Redis、Disque、IronMQ 和 SQS）。文档介绍了其安装、配置、核心功能及使用示例。 --- #### 1. 安装与配置 - 安装：使用 pip 安装最新版本： ```bash $ pip install Django-q ``` - 配置：将 `django_q` 添加到 `INSTALLED_APPS`，并运行 Django 迁移： ```bash $ python manage.py migrate ``` - 依赖项： - 必要：Django（1.7.10、1.8.4）、Django-picklefield、Arrow。 - 可选：Redis-py、Psutil、Hiredis、Boto3、Iron-mq。 --- #### 2. 核心功能 - 任务： - 异步任务：通过 `async()` 执行任务，支持结果组 `result_group()` 和结果查询 `fetch_group()`。 - 同步测试：设置 `sync=True` 可立即执行任务，适用于调试。 - 连接池：支持 Redis 连接池，优化高并发场景。 - 调度： - 支持定时任务（如 `HOURLY`、`DAILY`、`MINUTES`、`MONTHLY`）。 - 重复运行：通过 `repeats` 参数设置有限次执行。 - 捕获遗漏：默认情况下，长时间未运行的调度任务会追上进度，可设置 `catch_up=False` 禁用。 - 集群： - 支持多节点集群，使用 Redis 或 Disque 提供高性能。 - 支持 CPU 亲和性设置（需安装 Psutil）。 - 监控： - 提供 Django Admin 界面，展示成功、失败和计划任务。 - 成功任务：可搜索、过滤和删除。 - 失败任务：支持重试。 - 调度任务：显示状态、创建、编辑和删除。 - 管理命令： - 支持集成 Django 管理命令，如 `clearsessions`。 --- #### 3. 功能亮点 - 异步与并行：支持 multiprocessing worker pool。 - 灵活调度：支持重复任务和自定义时间表。 - 高可用性：支持多集群监控和 PaaS 集成。 - 扩展性：支持多种消息代理（Redis、Disque、IronMQ、SQS）。 - 兼容性：支持 Python 2.7 和 3.4，Django 1.7.10 和 1.8.4。 --- #### 示例 - 任务执行： ```python from django_q import async, fetch task_id = async('math.copysign', 2, -2, sync=True) task = fetch(task_id) ``` - 调度任务： ```python from django_q import schedule schedule('math.sqrt', 9, hook='hooks.print_result', schedule_type='H') ``` --- #### 总结 Django Q 提供了强大的异步任务、调度和集群管理功能，适用于需要高并发和任务调度的 Django 项目。其灵活的配置和对多种消息代理的支持，使其成为分布式任务处理的理想选择。