fork/django-q2
1
0
Fork 0
mirror of https://github.com/django-q2/django-q2.git synced 2026-10-06 23:38:11 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: minor changes

Browse Source
This commit is contained in:
Ilan Steemers
2015-09-06 16:22:06 +02:00
parent 815cbeede9
commit 87c3b7c9ce
1 changed files with 4 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/brokers.rst
+4 -13
View File
@@ -3,7 +3,7 @@ Brokers
The broker sits between your Django instances and your Django Q cluster instances, accepting and delivering task packages. The broker sits between your Django instances and your Django Q cluster instances, accepting and delivering task packages.
Currently we only support Redis and Disque, but support for other brokers is being worked on. Currently we only support Redis and Disque, but support for other brokers is being worked on.
Even though `Disque <https://github.com/antirez/disque>`__ is still considered Alpha software, it's been gathering a lot of support and test results are positive. Even though `Disque <https://github.com/antirez/disque>`__ is still considered to be in alpha, it's been gathering a lot of support and test results are positive.
Clients for `Amazon SQS <https://aws.amazon.com/sqs/>`__ and `IronMQ <http://www.iron.io/mq/>`__ are being tested. Clients for `Amazon SQS <https://aws.amazon.com/sqs/>`__ and `IronMQ <http://www.iron.io/mq/>`__ are being tested.
@@ -15,7 +15,7 @@ The default broker for Django Q clusters is `Redis <http://redis.io/>`__.
* Atomic * Atomic
* Does not need separate cache framework for monitoring * Does not need separate cache framework for monitoring
* Can use existing `Django-Redis <https://github.com/niwinz/django-redis>`__ connections through the :ref:`django_redis` setting * Can use existing `Django-Redis <https://github.com/niwinz/django-redis>`__ connections through the :ref:`django_redis` setting
* Requires `Redis-py <https://github.com/andymccurdy/redis-py>`__ as a client * Requires `Redis-py <https://github.com/andymccurdy/redis-py>`__
* Does not support receipts * Does not support receipts
Can be configured with :ref:`redis_configuration` configuration settings or :ref:`django_redis`. Can be configured with :ref:`redis_configuration` configuration settings or :ref:`django_redis`.
@@ -26,24 +26,15 @@ Disque
Unlike Redis, Disque supports message receipts which make delivery to the cluster workers guaranteed. If a task never produces a failed or successful result, it will automatically be sent to the cluster again for a retry. Unlike Redis, Disque supports message receipts which make delivery to the cluster workers guaranteed. If a task never produces a failed or successful result, it will automatically be sent to the cluster again for a retry.
You can control the amount of time Disque should wait for completion of a task by configuring the :ref:`retry` setting. You can control the amount of time Disque should wait for completion of a task by configuring the :ref:`retry` setting.
* Supports receipts * Delivery receipts
* Atomic * Atomic
* Needs Django's `Cache framework <https://docs.djangoproject.com/en/1.8/topics/cache/#setting-up-the-cache>`__ configured for monitoring * Needs Django's `Cache framework <https://docs.djangoproject.com/en/1.8/topics/cache/#setting-up-the-cache>`__ configured for monitoring
* Compatible with `Tynd <https://disque.tynd.co/>`__ Disque addon on `Heroku <https://heroku.com>`__ * Compatible with `Tynd <https://disque.tynd.co/>`__ Disque addon on `Heroku <https://heroku.com>`__
* Still considered Alpha software * Still considered Alpha software
* Requires `Redis-py <https://github.com/andymccurdy/redis-py>`__ as a client * Requires `Redis-py <https://github.com/andymccurdy/redis-py>`__
See the :ref:`disque_configuration` configuration section for more info. See the :ref:`disque_configuration` configuration section for more info.
Amazon SQS
----------
*TBA*
Iron MQ
-------
*TBA*
Reference Reference
--------- ---------
The :class:`Broker` class is used internally to communicate with the different types of brokers. The :class:`Broker` class is used internally to communicate with the different types of brokers.