Celery v5.0.1 Documentation

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

摘要

文档描述了Celery任务队列框架的5.0.1版本，支持在CPython 3.6、3.7、3.8和PyPy3上运行。该版本主要更新包括修复日志编码、自定义标题传播、数据库结果后端的重试创建、修复Redis结果后端的挂起问题、自定义错误消息、日志级别的大小写支持、广播消息恢复等。文档还强调了从4.x版本升级的重要性，并指出在升级时必须注意的重要信息。

AI总结

以下是对《Celery v5.0.1 Documentation》文档内容的中文总结，旨在简明扼要地抓住核心观点和关键信息：

---

### Celery 5.0 文档总结

#### 1. **版本概述**
- **文档概述**: 本文档描述了 Celery 的当前稳定版本（5.0版），主要涵盖新功能、改进和升级指南。
- **兼容性**:
- Celery 5.0 是一个主要版本，虽然大部分功能与前版本向后兼容，但升级前需仔细阅读重要说明。
- **支持的 Python 版本**: 官方支持 CPython 3.6、3.7 和 3.8，以及 PyPy3。
- **不支持**: Windows 平台不再支持（因资源不足），但可能仍然可用，欢迎提交补丁。

#### 2. **主要新功能与改进**
- **核心功能**: Celery 是一个简单、灵活且可靠的分布式编程框架，专注于实时处理大量消息，同时支持任务调度。
- **重要变更**:
- 删除了对 Python 2 的兼容性代码，仅支持 Python 3.6 及以上。
- 更新了代码以适应现代化的 Python 3 环境。
- 添加了对 Python 3.6 和 PyPy 5.8.0 的支持。
- 修复了任务链返回结果的问题。
- 优化了任务调度和结果后端（如 Redis 和数据库结果后端）。

#### 3. **升级指南**
- **注意事项**:
- 升级前务必阅读重要说明。
- `chain()` 可能返回组（group）或其他类型，而非仅仅链，需注意。
- 部分旧命令已被移除或弃用，需更新配置。

#### 4. **5.0.1 版本更新内容**
- **发布时间**: 2020-10-18
- **主要修复**:
- 指定日志文件的编码为 UTF-8。
- 自定义头部在处理混合消息时的传播问题。
- 修复 Redis 结果后端因`result_expires`设置为 0 导致的停滞问题。
- 修复任务分组的计数错误。
- 恢复从`celery control`广播消息的功能。
- 提供更清晰的错误提示。

#### 5. **其他版本变更**
- **Celery 4.x 版本**: 支持 CPython 2.7、3.4、3.5、3.6 和 3.7，以及 PyPy。
- **Celery 3.1 版本**: Support for CPython 2.6、2.7 和 3.3。

#### 6. **文档与社区**
- **文档结构**: 包括版本变更记录（What’s new）、错误修复记录（Change history）和旧版本存档（History）。
- **社区贡献**: Celery 拥有庞大且多样化的用户和贡献者社区，欢迎通过 IRC 或邮件列表加入。

---

以上是 Celery 5.0 文档的核心内容总结，突出了新功能、兼容性变更、升级指南及重要修复内容。