CeleryEstimated reading time: 3 minutes
Celery is an open source asynchronous task queue/job queue based on distributed message passing.
GitHub repo: https://github.com/docker-library/celery
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.
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
For detailed information about the published artifacts of each of the above supported tags (image metadata, transfer size, etc), please see the
repos/celery directory in the
docker-library/repo-info GitHub repo.
For more information about this image and its history, please see the relevant manifest file (
library/celery). This image is updated via pull requests to the
docker-library/official-images GitHub repo.
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.
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
Supported Docker versions
This image is officially supported on Docker version 17.04.0-ce.
Support for older versions (down to 1.6) is provided on a best-effort basis.
Please see the Docker installation documentation for details on how to upgrade your Docker daemon.
If you have any problems with or questions about this image, please contact us through a GitHub issue. If the issue is related to a CVE, please check for a
cve-tracker issue on the
official-images repository first.
You can also reach many of the official image maintainers via the
#docker-library IRC channel on Freenode.
You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.
Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.
Documentation for this image is stored in the
celery/ directory of the
docker-library/docs GitHub repo. Be sure to familiarize yourself with the repository’s
README.md file before attempting a pull request.