Celery 2.1 Documentation

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

摘要

文档描述了Celery 2.1.4版本的功能和使用方法，包括任务队列的概念、消息代理的选择（如RabbitMQ、Redis）、任务的执行方式、监控工具如celeryctl、Django Admin Monitor等，以及配置选项。文档还提供了版本更新日志，介绍了新功能和错误修复，并涵盖了 Celery 的安装、集成和社区资源。 Celery 是一个开源的异步任务队列，支持实时操作和调度，能够在多个 worker 节点上并行执行任务。

AI总结

以下是对《Celery 2.1 Documentation》的中文总结，内容涵盖了核心功能、安装、配置、监控以及其他关键信息的概要：

---

### **1. 简介**
- **Celery** 是一个开源的异步任务队列/分布式任务队列，基于分布式消息传递设计。
- 支持实时操作，同时兼容任务调度。
- 任务(__Tasks__) 可以在一个或多个工作节点上并发执行，支持异步（后台）或同步（阻塞直到完成）运行。
- Celery 每日可处理数百万级任务，在生产环境中得到广泛应用。
- 编写语言为 Python，但协议可以在其他语言中实现，支持通过 Webhooks 与其他语言配合使用。
- 推荐使用 **RabbitMQ** 作为消息代理，但也支持 **Redis** 和数据库（如 SQLAlchemy）。
- 方便与 **Django、Pylons** 和 **Flask** 集成，分别提供了 `django-celery`、`celery-pylons` 和 `Flask-Celery` 扩展包。

---

### **2. 安装**
- 可以从源代码或 PyPI 安装。
- 支持使用开发版本。
- 提供 `celeryctl` 命令行工具，用于管理和监控工作节点。

---

### **3. 配置说明**
- 配置文件为 `celeryconfig.py`，需包含在 Python 路径中。
- 主要配置指令包括：
- **并发设置**：如 `CELERYD_CONCURRENCY`。
- **任务结果后端**：支持数据库、Redis、MongoDB 等。
- **消息 broker 设置**：如 RabbitMQ、Redis。
- **任务执行设置**：如超时、重试策略。
- **日志与监控**：支持广播命令和事件监听。
- **定期任务服务器**：通过 `celerybeat` 实现。
- **自定义组件**：支持自定义任务、后端和工作者。

---

### **4. 监控与管理**
- 提供多种监控工具：
- **celeryctl**：命令行工具，支持查看节点状态、任务结果等。
- **Django Admin Monitor**：集成于 Django 的监控界面。
- **celeryev**：基于 Curses 的终端监控工具。
- **celerymon**：Web 监控界面。
- **Munin**：用于性能监测。
- 支持事件和快照功能，供自定义监控需求使用。

---

### **5. 包与模块**
- **任务相关**：包括 `celery.decorators`、`celery.task`、`celery.registry` 等。
- **执行与调度**：如 `celery.execute`、`celery.result`。
- **消息传递**：`celery.messaging`。
- **其他工具**：如 `celery.log`、`celery.utils`。

---

### **6. 版本更新日志**
- **2.1.4**：修复数据库存储任务结果时的潜在竞态条件，优化监控功能。
- **0.8.1**：新增 AMQP QoS（质量服务）支持，提升性能。
- **0.8.3**：修复数据库查询任务结果的竞态条件，优化脚本安装。
- **0.8.4**：废弃 `--detach` 参数，建议使用 `supervisord` 或 `launchd` 代替。

---

### **7. 获取帮助**
- **邮件列表**：讨论使用、开发及未来计划。
- **IRC 频道**：位于 Freenode 网络的 `#celery` 频道。
- **问题追踪**：通过 [GitHub Issues](http://github.com/ask/celery/issues/) 报告问题。
- **Wiki**：查阅 [GitHub Wiki](http://wiki.github.com/ask/celery/)。
- **贡献代码**：通过 GitHub 参与开发。

---

### **8. 许可证**
- **New BSD License**，详细内容见 `LICENSE` 文件。

---

以上是对《Celery 2.1 Documentation》的核心内容总结，涵盖了主要功能、配置、监控工具和安装指南等，旨在为读者提供一个清晰的框架和快速入门的参考。