Django Q Documentation Release 0.9.0

语言	格式	评分
英语	.pdf	3
摘要
文档详细介绍了Django Q的功能和配置，包括任务队列管理、消息队列使用、调度设置、监控和管理等功能。文档提供了详细的配置示例，说明了如何通过Q_CLUSTER设置来优化任务处理，并介绍了任务调度、错误处理、信号订阅等核心功能。内容涵盖任务管理、队列监控、调度配置等多个方面，适用于Django开发者的任务处理需求。
AI总结
### Django Q 0.9.0 文档总结 #### 1. 特性 - 安装：通过 `pip install django-q` 安装。 - 配置：通过 `Q_CLUSTER` 字典在 `settings.py` 中配置，支持 `workers`、`timeout`、`save_limit` 等参数。 - 经纪人（Brokers）：支持多种任务队列实现，如 Django ORM 和 Redis，默认使用 Django ORM。 - 任务（Tasks）：支持异步任务执行，提供 `async()` 方法，可设置超时、保存结果、组任务等功能。 - 组任务（Groups）：允许将任务分组，便于管理和监控。 - 可迭代（Iterables）：支持按顺序执行任务。 - 链（Chains）：允许任务按顺序执行，支持动态生成任务。 - 调度（Schedules）：支持定时任务，可设置重复次数和运行间隔。 - 集群（Cluster）：管理多个 worker 进程，提供连接池和停止机制。 - 监控（Monitor）：提供任务状态监控和结果管理功能。 - 管理页面（Admin Pages）：展示成功任务、失败任务和排队任务，支持筛选和删除。 - 错误处理：支持插件式错误报告，如 Rollbar 和 Sentry。 - 信号（Signals）：允许在任务执行前后订阅信号。 - 架构：包含调度器、守护进程（sentinel）、推送者（pusher）和 worker 等组件。 - 示例：提供邮件发送、任务调度等示例。 #### 2. 核心功能 - 任务执行：通过 `async()` 方法异步执行任务，支持同步模式（`sync=True`）。 - 集群管理：支持动态调整 worker 数量，提供任务队列和结果队列的监控。 - 错误处理：支持插件式错误报告，便于集成到现有监控系统。 - 任务调度：支持定时任务，可设置重复次数和运行间隔。 - 监控页面：提供任务状态和结果的可视化管理，支持筛选和删除。 #### 3. 示例 - 邮件发送： ```python from django_q.tasks import async async('django.core.mail.send_mail', 'Welcome', 'message', 'from@example.com', [user.email]) ``` - 定时任务： ```python from django_q.tasks import schedule schedule('my.task', 300) # 每5分钟执行一次 ``` #### 4. 注意事项 - 兼容性：支持 Python 2.7、3.6 及以上版本，兼容 Django 1.8、1.11 和 2.0。 - 依赖管理：通过 `requirements.txt` 管理依赖版本，确保兼容性。 #### 5. 总结 Django Q 0.9.0 提供了强大的任务队列和调度功能，支持异步任务、定时任务、任务分组和集群管理。通过插件式错误报告和监控页面，便于任务管理和调试。适合需要处理异步任务和定时任务的 Django 项目。