Django Q Documentation Release 0.3.6

以下是对《Django Q Documentation Release 0.3.6》中文总结，重点突出核心观点和关键信息，逻辑连贯，语言简洁明了： --- ### **Django Q Documentation Release 0.3.6 总结** #### **1. 功能概述** Django Q 是一个原生 Django 任务队列和 worker 应用，使用 Python 的 multiprocessing 实现。其核心功能包括： - **多进程 worker 池**：通过多进程处理任务以提高效率。 - **异步任务**：支持在后台异步执行任务。 - **定时任务和重复任务**：支持按时间或周期性执行任务。 - **加密和压缩**：任务包可以加密和压缩，确保安全。 - **失败和成功记录**：记录任务的失败和成功状态，便于追踪。 - **结果钩子**：支持在任务完成后执行自定义逻辑。 - **Django Admin 集成**：通过 Admin 界面管理任务。 - **多实例和集群监控**：支持 PaaS 多实例部署及集群监控。 - **Redis 支持**：依赖 Redis 作为消息队列。 - **兼容性**：支持 Python 2.7、3.4 和 Django 1.7.9、1.8.3。 #### **2. 安装与配置** - **安装**： 1. 使用 pip 安装：`pip install django-q` 2. 添加 `django_q` 到 `INSTALLED_APPS`。 3. 迁移数据库：`python manage.py migrate` 4. 确保 Redis 服务运行中。 - **配置**： - 任务结果保存策略：`save_limit` 控制成功任务的保存数量（默认 250，0 为无限，-1 为不保存）。 - Redis 连接设置：支持自定义 Redis 配置，若使用 `django-redis`，可直接指定缓存连接。 - 安全配置：Django Q 使用 `SECRET_KEY` 加密任务包，确保安全性。 - 性能优化：`cpu_affinity` 控制 worker 使用的 CPU 核数，优化高流量集群性能。 #### **3. 监控与状态** Django Q 提供监控功能，主要包括： - **集群状态**：显示当前集群的运行状态（如启动中、空闲、运行、停止中、已停止）。 - **任务队列**：实时监控任务队列和结果队列的数量变化。 - **进程信息**：显示 worker、monitor、sentinel 等进程的 PID。 - **操作方法**：提供 API 给出集群状态、任务队列信息等。 #### **4. Django Admin 界面** 在 Django Admin 中，Django Q 提供了三个主模型： 1. **成功任务**：记录所有成功执行的任务，支持查看详情或删除。 2. **失败任务**：记录因错误未完成的任务，支持重新提交失败任务。 3. **定时任务**：允许查看、创建、编辑或删除定时任务。 #### **5. 示例与用法** - **发送邮件示例**：通过 `async` 函数实现邮件异步发送，减少等待时间。 - **定时任务示例**：支持通过 `schedule` 函数创建定时任务，设置重复规则和执行时间。 #### **6. 其他配置选项** - **压缩**：默认不启用压缩，但对大任务数据有用。 - **失败任务保存**：失败任务始终保存，不受 `save_limit` 影响。 - **定时任务重复规则**：支持有限次或无限次执行，特殊规则适用于一次性任务。 --- 以上是对《Django Q Documentation Release 0.3.6》的核心内容总结，涵盖了功能、安装、配置、监控和实际使用示例，旨在快速帮助用户理解和使用 Django Q。