docs/celery

DEPRECATED

This image is officially deprecated in favor of the standard python image, and will receive no further updates after 2017-06-01 (Jun 01, 2017). Please adjust your usage accordingly.

See the discussion in docker-library/celery#1 and docker-library/celery#12 for more details.

In most cases, using this image required re-installation of application dependencies, so for most applications it ends up being much cleaner to simply install Celery in the application container, and run it via a second command.

See the way the sentry image handles running a Celery beat and workers for a concrete example of this pattern being employed (docker run -d --name sentry-cron ... sentry run cron and docker run -d --name sentry-worker-1 ... sentry run worker).

Supported tags and respective Dockerfile links

• 4.0.2, 4.0, 4 (4.0/Dockerfile)
• 3.1.25, 3.1, 3, latest (3.1/Dockerfile)

Quick reference

• Where to get help:
  the Docker Community Forums, the Docker Community Slack, or Stack Overflow

• Where to file issues:
  https://github.com/docker-library/celery/issues

• Maintained by:
  the Docker Community

• Published image artifact details:
  repo-info repo's repos/celery/ directory (history)
  (image metadata, transfer size, etc)

• Image updates:
  official-images PRs with label library/celery
  official-images repo's library/celery file (history)

• Source of this description:
  docs repo's celery/ directory (history)

• Supported Docker versions:
  the latest release (down to 1.6 on a best-effort basis)

Celery

Celery is an open source asynchronous task queue/job queue based on distributed message passing. It is focused on real-time operation, but supports scheduling as well.

wikipedia.org/wiki/Celery_Task_Queue

How to use this image

start a celery worker (RabbitMQ Broker)

$ docker run --link some-rabbit:rabbit --name some-celery -d celery

check the status of the cluster

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

start a celery worker (Redis Broker)

$ docker run --link some-redis:redis -e CELERY_BROKER_URL=redis://redis --name some-celery -d celery

check the status of the cluster

$ docker run --link some-redis:redis -e CELERY_BROKER_URL=redis://redis --rm celery celery status