Celery 2.3 Documentation

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

摘要

该文档是Celery 2.3版本的官方文档，主要介绍了Celery作为分布式任务队列的配置、使用和内部机制。文档涵盖了入门指南、用户指南（包括任务执行、工作器管理、周期性任务等）、配置与默认设置、常见问题解答、API参考和内部模块说明。配置部分要求用户创建celeryconfig.py模块，并提供了示例配置文件。用户指南详细说明了任务的基本操作、上下文、日志记录、重试机制、任务选项及最佳实践。工作器指南涉及启动、停止、重启、并发设置及时间限制。内部部分介绍了任务消息格式、序列化及工作器组件结构。文档还包含了版本更新日志，如2.3.3和2.3.2版本的修复内容，以及社区资源和教程链接。

AI总结

Celery 2.3 是一个分布式任务队列系统。文档主要包含以下核心内容：

**入门与用户指南**
- 介绍了如何安装 Broker、起步操作以及资源获取。
- 核心功能包括：任务（Tasks）的定义、执行与重试；Worker 的启动、停止与管理；周期性任务；任务分组、子任务和回调；HTTP 回调（Webhooks）；任务路由；监控与管理指南；以及并发优化。

**配置与默认值**
- 需创建 `celeryconfig.py` 模块进行配置。
- 配置项涵盖：并发设置、任务结果后端（支持数据库、AMQP、缓存、Redis、MongoDB 等）、消息路由、Broker 设置、任务执行、Worker（celeryd）、错误邮件、事件、广播命令、日志、自定义组件、周期性任务服务器（celerybeat）及监控服务器（celerymon）。

**变更历史（部分关键修复）**
- **2.3.3**：修复了因替换 `sys.stdout` 导致 Worker 崩溃的问题。
- **2.3.2**：改进了贡献指南；依赖 Kombu 1.3.1；`Task.request` 新增 `hostname` 属性。
- **2.3.1**：修复了 `purge/discard_all` 功能异常、日志非 ASCII 数据着色问题、Windows 下 `os.kill` 缺失问题、Worker 因硬时间限制而挂起的问题，以及 `ResultSet.iterate` 未按预期返回结果的问题。

**内部机制**
- 详细描述了 Worker 的数据结构、组件、任务消息格式及序列化。
- 提供了通过 `celery.Worker` 启动 Worker、访问配置（`celery.conf`）以及控制 Worker（`celery.control`）的 API 示例。

**其他资源**
- **Cookbook**：包含确保任务单次执行、将 Worker 作为守护进程运行（支持 init scripts、supervisord、launchd、Windows）等实用技巧。
- **社区资源**：列出了外部博客、教程和幻灯片链接。