Skip to content

Commit 321a942

Browse files
Merge pull request #2379 from rabbitmq/no-ack-autodelete-shovels
Shovels: document delete-after & no-ack incompatibility
2 parents 73be282 + 961e442 commit 321a942

File tree

4 files changed

+18
-33
lines changed

4 files changed

+18
-33
lines changed

docs/shovel-dynamic.md

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -588,7 +588,8 @@ the declaration process.
588588
</div>
589589
<div>
590590
If set to an integer, then the shovel will transfer that
591-
number of messages before deleting itself.
591+
number of messages before deleting itself. This option cannot
592+
be used together with <code>ack-mode</code> set to <code>no-ack</code>.
592593
</div>
593594
</td>
594595
</tr>
@@ -838,15 +839,10 @@ counterparts.
838839
The default is <code>never</code>, meaning the
839840
shovel should never delete itself.
840841
</div>
841-
<div>
842-
If set to <code>queue-length</code> then the shovel will
843-
measure the length of the source queue when starting up,
844-
and delete itself after it has transferred that many
845-
messages.
846-
</div>
847842
<div>
848843
If set to an integer, then the shovel will transfer that
849-
number of messages before deleting itself.
844+
number of messages before deleting itself. This option cannot
845+
be used in conjunction with <code>ack-mode</code>: <code>no-ack</code>.
850846
</div>
851847
</td>
852848
</tr>
@@ -922,7 +918,8 @@ the declaration process.
922918
</div>
923919
<div>
924920
If set to an integer, then the shovel will transfer that
925-
number of messages before deleting itself.
921+
number of messages before deleting itself. This option cannot
922+
be used in conjunction with <code>ack-mode : no-ack</code>.
926923
</div>
927924
</td>
928925
</tr>

versioned_docs/version-3.13/shovel-dynamic.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -534,7 +534,8 @@ the declaration process.
534534
</div>
535535
<div>
536536
If set to an integer, then the shovel will transfer that
537-
number of messages before deleting itself.
537+
number of messages before deleting itself. This option cannot
538+
be used together with <code>ack-mode</code> set to <code>no-ack</code>.
538539
</div>
539540
</td>
540541
</tr>
@@ -792,14 +793,9 @@ counterparts.
792793
shovel should never delete itself.
793794
</div>
794795
<div>
795-
If set to <code>queue-length</code> then the shovel will
796-
measure the length of the source queue when starting up,
797-
and delete itself after it has transferred that many
798-
messages.
799-
</div>
800-
<div>
801796
If set to an integer, then the shovel will transfer that
802-
number of messages before deleting itself.
797+
number of messages before deleting itself. This option cannot
798+
be used in conjunction with <code>ack-mode</code>: <code>no-ack</code>.
803799
</div>
804800
</td>
805801
</tr>

versioned_docs/version-4.0/shovel-dynamic.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -598,7 +598,8 @@ the declaration process.
598598
</div>
599599
<div>
600600
If set to an integer, then the shovel will transfer that
601-
number of messages before deleting itself.
601+
number of messages before deleting itself. This option cannot
602+
be used together with <code>ack-mode</code> set to <code>no-ack</code>.
602603
</div>
603604
</td>
604605
</tr>
@@ -855,14 +856,9 @@ counterparts.
855856
shovel should never delete itself.
856857
</div>
857858
<div>
858-
If set to <code>queue-length</code> then the shovel will
859-
measure the length of the source queue when starting up,
860-
and delete itself after it has transferred that many
861-
messages.
862-
</div>
863-
<div>
864859
If set to an integer, then the shovel will transfer that
865-
number of messages before deleting itself.
860+
number of messages before deleting itself. This option cannot
861+
be used in conjunction with <code>ack-mode</code>: <code>no-ack</code>.
866862
</div>
867863
</td>
868864
</tr>

versioned_docs/version-4.1/shovel-dynamic.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -598,7 +598,8 @@ the declaration process.
598598
</div>
599599
<div>
600600
If set to an integer, then the shovel will transfer that
601-
number of messages before deleting itself.
601+
number of messages before deleting itself. This option cannot
602+
be used together with <code>ack-mode</code> set to <code>no-ack</code>.
602603
</div>
603604
</td>
604605
</tr>
@@ -855,14 +856,9 @@ counterparts.
855856
shovel should never delete itself.
856857
</div>
857858
<div>
858-
If set to <code>queue-length</code> then the shovel will
859-
measure the length of the source queue when starting up,
860-
and delete itself after it has transferred that many
861-
messages.
862-
</div>
863-
<div>
864859
If set to an integer, then the shovel will transfer that
865-
number of messages before deleting itself.
860+
number of messages before deleting itself. This option cannot
861+
be used in conjunction with <code>ack-mode</code>: <code>no-ack</code>.
866862
</div>
867863
</td>
868864
</tr>

0 commit comments

Comments
 (0)