浏览代码

Clarify the prefetch multiplier

For years, I thought CELERYD_PREFETCH_MULTIPLIER turned off prefetching, and I had a lot of weird problems.  Today I finally figured out 1 means disabled, 0 means PREFETCH ALL THE THINGS.  This fixes the documentation bug.
Kevin McCarthy 11 年之前
父节点
当前提交
3f0ce3004d
共有 1 个文件被更改,包括 6 次插入0 次删除
  1. 6 0
      docs/configuration.rst

+ 6 - 0
docs/configuration.rst

@@ -164,6 +164,12 @@ workers, note that the first worker to start will receive four times the
 number of messages initially.  Thus the tasks may not be fairly distributed
 number of messages initially.  Thus the tasks may not be fairly distributed
 to the workers.
 to the workers.
 
 
+To disable prefetching, set CELERYD_PREFETCH_MULTIPLIER to 1.  Setting 
+CELERYD_PREFETCH_MULTIPLIER to 0 will allow the worker to keep consuming
+as many messages as it wants.
+
+For more on prefetching, read :ref:`optimizing-prefetch-limit`
+
 .. note::
 .. note::
 
 
     Tasks with ETA/countdown are not affected by prefetch limits.
     Tasks with ETA/countdown are not affected by prefetch limits.