Skip to content

Tweak some wording in delay transfer documentation #8165

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bording merged 1 commit into from
Apr 9, 2026
+10 −3
Merged

Tweak some wording in delay transfer documentation #8165

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion transports/rabbitmq/delayed-delivery.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -185,4 +185,4 @@ partial: disabledelayeddelivery

When upgrading the RabbitMQ cluster, it is recommended to use the [rolling (in-place)](https://www.rabbitmq.com/docs/upgrade#rolling-upgrade) method.

Due to the way the native delayed delivery infrastructure is implemented, upgrading RabbitMQ by using [blue-green deployments](https://www.rabbitmq.com/docs/upgrade#blue-green-deployment) is more complicated and requires the specialized shovelling of delayed messages in order to avoid message loss. You can use one of the supported cli tools like [`delays transfer`](operations-scripting.md#delays-transfer) to aid with the shoveling.
Upgrading RabbitMQ by using [blue-green deployments](https://www.rabbitmq.com/docs/upgrade#blue-green-deployment) is more complicated because delayed messages cannot be moved with standard tools like the [shovel](https://www.rabbitmq.com/docs/shovel) which are not aware of the how the delay infrastructure is implemented. The [`delays transfer`](operations-scripting.md#delays-transfer) command should be used to move delayed messages from one broker to another.
11 changes: 9 additions & 2 deletions transports/rabbitmq/operations-scripting_content_rabbit_[11,).partial.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,13 @@ rabbitmq-transport delays migrate [options]
`--disableCertValidation`: Disable remote certificate validation when connecting to the broker<br />
`--routingTopology` | `-r` : The routing topology to use<br />

> [!NOTE]
> Before running this command, the destination broker must have the v2 delay infrastructure in place. Use the [`delays create`](#delays-create) command to set it up:
>
> ```
> rabbitmq-transport delays create --connectionString "amqp://user:pass@destination-host"
> ```

### `delays transfer`

Use this command to transfer delayed messages from one broker to another:
Expand Down Expand Up @@ -93,7 +100,7 @@ rabbitmq-transport delays transfer [options]
> Before running this command, the destination broker must have the v2 delay infrastructure in place. Use the [`delays create`](#delays-create) command to set it up:
>
> ```
> rabbitmq-transport delays create --connectionString "amqp://user:pass@destination-host" --managementApiUrl "http://destination-host:15672"
> rabbitmq-transport delays create --connectionString "amqp://user:pass@destination-host"
> ```

> [!NOTE]
Expand All @@ -106,7 +113,7 @@ rabbitmq-transport delays transfer [options]
#### Usage example

```
rabbitmq-transport delays transfer --sourceConnectionString "amqp://user:pass@source-host" --destinationConnectionString "amqp://user:pass@destination-host"
rabbitmq-transport delays transfer --sourceConnectionString "amqp://user:pass@source-host" --destinationConnectionString "amqp://user:pass@destination-host"
```

### `delays verify`
Expand Down