Celery v5.0.5 Documentation

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

摘要

文档描述了Celery 5.0.5版本的新增功能和错误修复，以及其在Python 3.6及以上版本的兼容性。该版本移除了对Python 2的支持，并提供了结果后端和任务执行的改进。同时，文档详细说明了从Celery 4.x升级到5.0的步骤，并强调了社区的贡献和支持。

AI总结

# Celery v5.0.5 Documentation 总结

## 概述

- **版本**：当前稳定版本为 Celery 5.0。
- ** Python 支持**：
- **移除了对 Python 2 的支持**，仅兼容 Python 3.6及以上版本。
- 也支持PyPy3。
- **主要功能**：作为分布式任务队列框架，专注于实时处理，同时支持任务调度。

## 版本更新

### 新增功能

- **兼容性改动**：
- **移除了对 Python 2 的支持**。
- 现代化代码以支持 Python 3.6 及更高版本。
- **弃用支持**：不再官方支持 Windows 版本，但仍可能正常运行，欢迎提交修复补丁。

### 修复和改进

#### 5.0.5 (2020-12-16)
- 修复了在从 S3 删除结果时确保键为字符串的 bug（#6537）。
- 修复了 `celery --help` 和 `celery events` 的问题（#6543）。

#### 5.0.4 (2020-12-08)
- 修复了 `cache+memory://` 后端的 `DummyClient` ，在多线程环境中共享状态（#6524），解决了在 pytest 集成时结果获取挂起的问题。

#### 5.0.3 (2020-12-03)
- 将 `--workdir` 改为立即处理（#6457）。
- 修复了在使用 MongoDB 后端时，`result_expires` 为 0 或 None 时的清理问题（#6462）。
- 修复了 `purge` 命令中传递队列的问题（#6469）。
- 恢复了 `app.start()` 和 `app.worker_main()`（#6481）。
- 分离进程时不再创建额外的日志文件（#6426）。
- 结果后端实例改为线程本地以确保线程安全（#6416）。

## 升级指南

- **升级步骤**：
1. 调整命令行调用方式。
2. 更新配置以使用新设置名称。
3. 阅读本文档中的重要说明。

## 开发者参考

- **源代码模块**：
- `celery.app.trace`：定义任务执行跟踪的方式，记录错误、应用处理程序。
- `celery.app.utils`：包含兼容设置、错误报告工具等实用函数。
- `celery.worker.consumer.consumer`：工人消费者蓝图，处理从消息代理接收和处理消息。

## 社区与贡献

- **社区指南**：
- 鼓励加入社区，如IRC或邮件列表。
- 贡献代码时请遵循编码规范，并确保补丁清晰。
- **报告问题**：
- 提供足够的信息以帮助诊断问题。

## 具体光线

- **发布日期和版本历史**：详细列出了每个版本的发布日期和作者，方便跟踪变化。
- **改进说明**：在多个版本中持续改进任务处理和消息队列的稳定性，如修复竞态条件、错误处理和日志记录。

## 结论

- **核心变动**：移除Python 2支持，优化代码以适应现代Python版本。
- **关键改进**：提升结果后端的线程安全性，修复多线程下的任务处理问题，增强错误处理机制。
- **社区支持**：通过开放的协作模式，鼓励用户积极参与代码贡献和问题报告，确保项目的持续发展。

通过这些改动，Celery 5.0.5在保持功能的同时，提升了性能和系统稳定性，更好地满足生产环境的需求。