Celery Docker 镜像文档

镜像概述和主要用途

本镜像为 Celery 的官方 Docker 镜像，已被正式弃用。官方推荐使用 标准 python 镜像 替代，且自 2017 年 6 月 1 日起不再提供任何更新。请用户据此调整使用方式。

有关弃用原因的详细讨论，参见 docker-library/celery#1 和 docker-library/celery#12。

核心功能和特性

Celery 是一个基于分布式消息传递的开源异步任务队列/作业队列，专注于实时操作，同时支持任务调度。本镜像曾用于快速部署 Celery 环境，但由于以下原因已不再维护：

• 多数场景下使用本镜像需重新安装应用依赖，增加复杂性
• 官方推荐在应用容器中直接集成 Celery，简化部署流程

使用场景和适用范围

原适用场景

• 快速启动 Celery Worker 节点
• 连接 RabbitMQ/Redis 等消息代理实现分布式任务处理

当前推荐方案

由于本镜像已弃用，推荐在应用容器中直接安装并运行 Celery。例如，通过 python 镜像构建应用镜像时，使用 pip install celery 集成 Celery，再通过命令行启动 Worker/Beat 等组件。

详细的使用方法和配置说明

过时用法（不推荐）

以下为镜像弃用前的典型使用方式，仅供参考：

1. 连接 RabbitMQ 启动 Worker

# 假设已启动 RabbitMQ 容器（名称：some-rabbit）
docker run --link some-rabbit:rabbit --name some-celery -d celery

2. 检查集群状态

docker run --link some-rabbit:rabbit --rm celery celery status

3. 连接 Redis 启动 Worker

# 假设已启动 Redis 容器（名称：some-redis）
docker run --link some-redis:redis -e CELERY_BROKER_URL=redis://redis --name some-celery -d celery

当前推荐用法

大多数应用应在自身容器中集成 Celery，通过命令行启动相关组件。以 Sentry 为例（参考 Sentry 镜像文档）：

1. 启动 Celery Beat（定时任务）

docker run -d --name sentry-cron ... sentry run cron

2. 启动 Celery Worker

docker run -d --name sentry-worker-1 ... sentry run worker

支持的标签及对应 Dockerfile 链接

• 4.0.2, 4.0, 4（4.0/Dockerfile）
• 3.1.25, 3.1, 3, latest（3.1/Dockerfile）

快速参考

帮助与支持

• 获取帮助：Docker 社区论坛、Docker 社区 Slack、Stack Overflow

问题反馈

• 提交 issue：[***]

维护与更新

• 维护者：Docker 社区
• 镜像 artifact 详情：repo-info 仓库的 repos/celery/ 目录（历史记录）
• 镜像更新记录：官方镜像 PR（标签 library/celery）
• 文档来源：docs 仓库的 celery/ 目录（历史记录）

环境要求

• 支持的 Docker 版本：最新稳定版（最低支持 1.6，尽力兼容）