Celery 2.3 Documentation

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

摘要

Celery是一个开源的分布式任务队列/作业队列，基于分布式消息传递协议。它专注于实时操作，但也支持调度功能。任务作为执行单元，可以在一个或多个工作者节点上使用多进程、Eventlet或gevent并发执行。Celery支持异步执行（在后台）或同步执行（等待完成）。它广泛应用于生产系统，每天处理数百万任务。Celery使用Python编写，但协议可以使用其他语言实现，支持RabbitMQ、Redis、Beanstalk、MongoDB、CouchDB和数据库（使用SQLAlchemy或Django ORM）。Celery易于与Django、Pylons和Flask集成，使用相应的扩展包。文档还介绍了配置、资源获取、贡献指南和许可证信息。

AI总结

### Celery 2.3 文档总结

#### 1. 版本信息
- **发布日期**：2014年2月4日
- **主要版本**：2.3
- **支持的 Python 版本**：2.4、2.5、2.6、2.7

#### 2. 主要改进与新功能
1. **任务调度器优化**
- 修复了 ETA 调度器的严重问题，之前每秒只能执行一个任务，现已优化。
- 新增 `CELERYD_ETA_SCHEDULE_PRECISION` 配置，控制调度的最小睡眠时间，默认值为 0.8 秒。
2. **远程控制命令**
- 新增 `stats` 命令，显示 worker 的信息，如进程 ID 和任务执行统计。
3. **兼容性改进**
- 解决了 RabbitMQ 1.8.0 的严格等价性检查问题，可能需要手动删除 `celerycrq` 交换机。
- 支持 SQLAlchemy 0.5.x 和 Python 2.7。
4. **任务装饰器兼容性**
- 修复了任务装饰器的 pickling 问题，确保任务可以被正确序列化。

#### 3. 修复的问题
1. **任务调度器**
- 修复了 ETA 调度器的睡眠机制，避免每秒只能执行一个任务的问题。
2. **进程管理**
- 修复了池子（pool）的信号量释放问题，避免因 worker 提前终止导致的死锁。
3. **日志和文档**
- 修复了 Sphinx 1.0b2 引起的文档渲染错误。
4. **其他**
- 修复了 `purge/discard_all` 的工作异常问题。
- 解决了 Windows 环境下 multiprocessing 池子的兼容性问题。

#### 4. 弃用和移除的功能
1. **弃用的功能**
- `celery.task.ping` 和 `celery.task.PingTask` 已弃用，建议使用 `ping` 远程控制命令。
- `celery.task.base`、`celery.task.sets` 和 `celery.decorators/celery.task` 已弃用，推荐使用 `app.create_task_cls` 和 `app.TaskSet`。
2. **移除的功能**
- 移除了 `CELERY_AMQP_CONSUMER_QUEUES` 等旧配置项，推荐使用 `CELERY_QUEUES` 和其他新设置。
- 移除了对 Python 2.4 的部分支持。

#### 5. 资源与贡献
- **获取帮助**：
- 邮件列表：[e-mail]
- IRC 频道：Freenode 网络的 #celery
- **问题报告**：
- 通过 GitHub 仓库提交问题：http://github.com/ask/celery/issues/
- **贡献指南**：
- 鼓励通过 GitHub 提交代码补丁或参与开发。
- **许可证**：
- 软件使用 New BSD License。

#### 6. 其他内部信息
- **依赖项**：
- 依赖于 Kombu 1.3.1。
- **日志改进**：
- 修复了日志消息在处理非 ASCII 数据时的显示问题。
- **任务执行**：
- `Task.request.hostname` 现在包含当前 worker 的主机名。

#### 7. 已存档和新功能分支
- **已存档分支**：
- 2.1-archived、2.0-archived、1.0-archived
- **新功能分支**：
- 用于开发新功能的专用分支，合并后将被移除。

#### 8. 标签
- **版本标签**：
- 格式为 `vX.Y.Z`，例如 `v2.3.1`。
- **实验性标签**：
- 格式为 `vX.Y.Z-id`，例如 `v3.0.0-rc1`。

#### 9. 贡献指南
- **开发流程**：
- 建议使用 Git 进行代码管理，建议 Fork 仓库并设置 upstream 远程仓库。
- 遵循 [贡献指南](http://ask.github.com/celery/contributing.html) 进行开发。

---

以上为 Celery 2.3 文档的核心内容总结，涵盖了版本更新、功能改进、问题修复、弃用功能以及资源信息。