Celery 2.0 Documentation

• 语言: 英语
• 格式: .pdf
• 来源: docs.celeryq.dev

摘要

The document provides comprehensive documentation for Celery version 2.0.3, detailing its features, installation, configuration, and change history. Celery is an open-source, distributed task queue that supports asynchronous and real-time operations, utilizing message brokers like RabbitMQ, Redis, and databases. It offers integration with Django and supports periodic tasks, task sets, and result backends. The document also outlines significant updates and improvements in various releases, enhancing performance, stability, and functionality.

AI总结

《Celery 2.0 Documentation》是Celery 2.0.3版本的官方文档，以下是对其内容的中文总结：

---

### 文档概述
- **Celery简介**：
Celery是一个开源的异步任务队列/作业队列，基于分布式消息传递实现，专注于实时操作，支持定时调度。其执行单元（任务）可以在一个或多个worker服务器上并发执行，既可以异步执行（后台运行）也可以同步执行（等待完成）。Celery支持多种消息中间件（如RabbitMQ、Redis和数据库），并提供与Django的集成。

- **版本信息**：
当前文档版本为2.0.3，发布日期为2014年2月4日，来源包括官网、PyPI和GitHub。

---

### 主要功能与特性
1. **任务执行**：
- 任务可以通过装饰器定义，并支持任务集（TaskSet）、子任务和回调功能。
- 支持周期性任务（类似cron功能），可通过`celerybeat`实现。

2. **消息队列与后端**：
- 默认推荐使用RabbitMQ作为消息中间件，也支持Redis和数据库（通过SQLAlchemy）。
- 支持任务结果存储和查询，提供多种后端选择。

3. **worker与集群管理**：
- Worker服务器可以同时执行多个任务，支持通过`celeryd`启动并管理worker。
- 提供`celerybeat`用于周期性任务调度，`celerymon`用于监控集群状态，`celeryev`用于查看实时事件。

4. **其他功能**：
- 提供使用HTTP检查任务状态的功能，返回JSON格式的结果。
- 支持通过`camqadm`进行AMQP API的命令行操作。

---

### 更新日志与改进
1. **重要更新**：
- **2.0.3版本**：修复了一些与Unicode键和任务kwargs相关的问题。
- **TaskDaemon重命名为WorkController**：提升了性能和稳定性。
- **改进的缺点处理机制**：修复了AMQP连接泄漏问题，优化了QoS（质量控制）设置。

2. **历史版本更新亮点**：
- **0.8.3版本**：修复了任务结果存储的竞态条件问题，支持包含任务状态的HTTP查询。
- **0.1.6版本**：引入任务集（TaskSet）概念，支持任务进度跟踪，优化了异常处理。
- **0.1.0版本**：初始版本发布，名称从“crunchie”更改为“celery”。

3. **配置改动**：
- AMQP相关配置项被重命名为BROKER_*，如`AMQP_SERVER`改为`BROKER_HOST`。

---

### API Reference
- 主要API模块包括：
- 任务装饰器：`celery.decorators`
- 任务定义：`celery.task.base`
- 任务集与回调：`celery.task.sets`
- 任务执行与结果：`celery.execute`、`celery.result`
- 配置管理：`celery.conf`

---

### 安装与开发
- **安装方式**：
- 可从源码安装或使用开发版本。
- 提供与Django集成的`django-celery`包。

- **内部模块与模型**：
包括Worker、任务、执行模块、消息队列、结果后端等核心模块。

---

### 总结
本文档全面介绍了Celery 2.0.3版本的功能、更新日志和API参考，适合开发者快速了解Celery的核心特性和使用方法。