Django Q Documentation Release 0.7.17

语言	格式	评分
英语	.pdf	3
摘要
The document provides a comprehensive guide to Django Q, focusing on its installation, configuration, and usage. It covers compatibility with different operating systems and Python versions, task scheduling features, cluster management, monitoring, and integration with various message brokers such as Redis, Disque, IronMQ, SQS, MongoDB, and the ORM. The guide also details settings for workers, task recycling, timeouts, encryption, and compression, along with monitoring statistics and administration pages.
AI总结
### Django Q 文档总结 #### 1. 特性 - 安装：使用 `pip install Django-q` 安装，添加到 `INSTALLED_APPS` 并运行 `migrate` 创建数据库表。 - 配置：通过 `Q_CLUSTER` 字典配置，支持 `Redis`、`Disque`、`IronMQ`、`SQS` 等消息队列。 - 任务：支持异步任务、计划任务和重复任务，结果可存储在数据库或缓存。 - 调度：支持按天（`D`）、周（`W`）、月（`M`）、季度（`Q`）、年（`Y`）的频率运行任务。 - 集群：使用 `multiprocessing` 模块管理任务处理池，支持多进程和 CPU 亲和性。 - 监控：提供集群状态监控，包括任务队列大小和进程状态。 - 扩展：支持自定义 Broker、Rollbar 集成、Tynd Disque、IronMQ、SQS 等扩展服务。 #### 2. 兼容性 - 操作系统：支持 OS X 和 Windows，但部分功能受限（如 CPU 亲和性、进程fork）。 - Python 版本：支持 Python 2.7 和 3.5，Django 1.8 和 1.9。 - 依赖：依赖最新版本的 `Python` 和 `Django`，需安装 `psutil` 解决部分兼容性问题。 #### 3. 配置选项 - 基本配置：`workers`（默认 CPU 核心数）、`recycle`（任务处理数）、`timeout`（任务超时）、`compress`（压缩）、`save_limit`（结果保留数）。 - 高级配置：`queue_limit`（队列限制）、`cpu_affinity`（CPU 亲和性）、`broker_class`（自定义 Broker）、`cached`（缓存结果）、`scheduler`（启用调度器）、`rollbar`（集成 Rollbar）。 #### 4. 任务调度 - 时间频率：支持每天、每周、每月、每季度、每年运行任务。 - 注意事项：月度任务在非31天月份会调整为最后一天，季度和年度任务在闰年调整。 #### 5. 集群管理 - 启动：使用 `python manage.py qcluster` 启动集群，显示 worker 进程状态。 - 停止：通过 `ctrl-c` 或信号停止，逐步关闭进程。 - 监控：提供 `Stat` 对象监控集群状态，包括任务队列大小、进程 ID 等。 #### 6. 行政界面 - 集成：使用 Django Admin 管理成功任务，支持按组过滤和搜索。 #### 7. 第三方服务集成 - Rollbar：集成 Rollbar 监控任务错误，需安装 `rollbar`。 - Tynd Disque、IronMQ、SQS：提供相应配置示例，支持扩展服务集成。 #### 8. 注意事项 - 加密：任务数据加密，无法解密的任务将被丢弃。 - 平台兼容性：部分功能在不同平台和版本上可能受限，需安装 `psutil` 解决。总结：Django Q 是一个功能强大的任务队列系统，支持多种消息队列和扩展服务，适用于异步任务和计划任务的管理。