overview.rst 1.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. .. _guide-overview:
  2. ==========
  3. Overview
  4. ==========
  5. .. contents::
  6. :local:
  7. .. _overview-figure-1:
  8. .. figure:: ../images/celery-broker-worker-nodes.jpg
  9. *Figure 1:* Worker and broker nodes.
  10. To use Celery you need at least two main components; a message broker and
  11. a worker.
  12. The message broker enables clients and workers to communicate through
  13. messaging. There are several broker implementations available, the most
  14. popular being RabbitMQ.
  15. The worker processes messages, and consists of one or more physical (or virtual)
  16. nodes.
  17. Tasks
  18. =====
  19. The action to take whenever a message of a certain type is received is called
  20. a "task".
  21. * Go to :ref:`guide-tasks`.
  22. * Go to :ref:`guide-executing`.
  23. * Go to :ref:`guide-sets`
  24. * Go to :ref:`guide-beat`.
  25. * Go to :ref:`guide-webhooks`.
  26. Workers
  27. =======
  28. Go to :ref:`guide-worker`.
  29. Monitoring
  30. ==========
  31. Go to :ref:`guide-monitoring`.
  32. Routing
  33. =======
  34. .. _overview-figure-2:
  35. .. figure:: ../images/celery-worker-bindings.jpg
  36. *Figure 2:* Worker bindings.
  37. Go to :ref:`guide-routing`.
  38. Celery takes advantage of AMQPs flexible routing model. Tasks can be routed
  39. to specific servers, or a cluster of servers by binding workers to different
  40. queues. A single worker node can be bound to one or more queues.
  41. Multiple messaging scenarios are supported: round robin, point-to-point,
  42. broadcast (one-to-many), and more.
  43. Celery aims to hide the complexity of AMQP through features like
  44. :ref:`routing-automatic`, while still preserving the ability to go
  45. low level if that should be necessary.