Celery 4.0 Documentation

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

摘要

Celery 4.0文档介绍了Celery 4.0的新功能和变更，包括对Python 2.7、3.4和3.5的支持，弃用Python 2.6，以及新的配置设置。文档详细说明了升级步骤、重要注意事项，如默认配置的安全性问题，并介绍了新的设置名称和依赖项更新。Celery 4.0引入了新的任务协议和小写设置名称，同时修复了多项任务和工单相关的问题。

AI总结

### Celery 4.0 文档总结

#### 1. **版本概述**
- **Celery 4.0** 是一个分布式任务队列系统，支持实时处理和任务调度，适用于大规模消息处理。
- **兼容性**：支持 CPython 2.7、3.4、3.5 和 PyPy，是最后一个支持 Python 2.7 的版本。
- **主要变化**：
- **弃用 Python 2.6 支持**。
- **移除 Django 支持**。
- **新特性**：引入了新的任务消息协议和更小写设置名称。

#### 2. **重要更新**
- **设置名称更改**：将旧的 `CELERY_` 前缀改为 `task_` 或其他更简洁的命名（如 `accept_content`、`enable_utc` 等）。
- **新功能**：
- **新方法**：`Task.subtask_from_request` 可以通过当前请求生成子任务。
- **新设置**：`CELERY_QUEUE_HA_POLICY` 用于设置 RabbitMQ 队列的默认高可用性策略。
- **安全性**：
- **默认配置修复**：Celery 4.0.1 修复了默认配置中的不安全设置，建议用户将 `accept_content` 显式设置为 `['json']`。

#### 3. **发行历史**
- **4.0.2 版本**（2017-09-26）：
- 修复了多个任务序列化问题。
- 修复了信号处理中的 `saferef` 错误。
- 更新了依赖项，如 Kombu 4.0.2。
- **4.0.1 版本**（2016-12-15）：
- 修复了默认配置的安全问题。
- 新增了 `app.register_task` 方法。
- 支持新的 `CELERY_CREATE_DIRS` 设置以确保日志和 PID 目录自动创建。

#### 4. **依赖与兼容性**
- **依赖更新**：
- 现在依赖于 `billiard 2.7.3.18`。
- **语言与平台**：
- 支持 Python 3.5 及以上版本（从 Celery 5.0 开始）。
- 不支持 Microsoft Windows。

#### 5. **其他改进**
- **性能优化**：
- ETA 调度器精度提升至毫秒级。
- 修复了某些情况下日志消息未输出的问题。
- **功能增强**：
- 支持更灵活的任务分批处理。
- 改善了对 Cassandra 和 MongoDB 后端的文档。

#### 6. **资源与支持**
- **获取帮助**：
- 邮件列表：`celery-users`。
- IRC 频道：`#celery`（Freenode 网络）。
- 问题追踪：[GitHub 仓库](https://github.com/celery/celery/issues/)。
- **文档**：
- 官方文档：[http://docs.celeryproject.org](http://docs.celeryproject.org)。
- 开发文档：已迁移至 [Read The Docs](http://docs.celeryproject.org/en/master)。

#### 7. **许可证**
- 软件遵循 New BSD License。

### 总结
Celery 4.0 是一个功能强大且灵活的分布式任务队列系统，支持多种消息队列协议和后端存储。其主要更新包括设置名称的简化、新功能的引入以及安全性改进。用户在升级时需要注意配置文件的调整，并确保使用支持的 Python 版本。