beanstalk.rst 1.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. .. _broker-beanstalk:
  2. =================
  3. Using Beanstalk
  4. =================
  5. .. _broker-beanstalk-installation:
  6. .. admonition:: Out of order
  7. The Beanstalk transport is currently not working well.
  8. We are interested in contributions and donations that can go towards
  9. improving this situation.
  10. Installation
  11. ============
  12. For the Beanstalk support you have to install additional dependencies.
  13. You can install both Celery and these dependencies in one go using
  14. the ``celery[beanstalk]`` :ref:`bundle <bundles>`:
  15. .. code-block:: bash
  16. $ pip install -U celery[beanstalk]
  17. .. _broker-beanstalk-configuration:
  18. Configuration
  19. =============
  20. Configuration is easy, set the transport, and configure the location of
  21. your Beanstalk database::
  22. BROKER_URL = 'beanstalk://localhost:11300'
  23. Where the URL is in the format of::
  24. beanstalk://hostname:port
  25. The host name will default to ``localhost`` and the port to 11300,
  26. and so they are optional.
  27. .. _beanstalk-results-configuration:
  28. Results
  29. -------
  30. Using Beanstalk to store task state and results is currently **not supported**.
  31. .. _broker-beanstalk-limitations:
  32. Limitations
  33. ===========
  34. The Beanstalk message transport does not currently support:
  35. * Remote control commands (:program:`celery control`,
  36. :program:`celery inspect`, broadcast)
  37. * Authentication