Skip to content

Commit 19642b3

Browse files
Blue/Green deployment guide: mention more use cases
1 parent 07b700a commit 19642b3

File tree

3 files changed

+23
-11
lines changed

3 files changed

+23
-11
lines changed

docs/blue-green-upgrade.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,13 @@ limitations under the License.
2020

2121
Blue-green deployment is a migration technique that can also be used as an [upgrade strategy](./upgrade).
2222
The main idea is to set up a new environment (the "green" one) and switch to it
23-
when it is ready. Technically nothing is upgraded - the application just switch
23+
when it is ready. The "upgrade" is not performed "in place", the application just switch
2424
to a different environment, which might be using a different version, but can
25-
also differ in other aspects. For example, the same approach can be used
26-
to migrate to new hardware, while keeping the same version of RabbitMQ.
25+
also differ in other aspects.
26+
27+
The same approach can be used to migrate to a new operating system or new hardware, while keeping the same version of RabbitMQ,
28+
or to upgrade from a version that cannot be upgraded to the target series directly,
29+
for example, from 3.12.x to 4.0.x or from a 3.13.x cluster with Khepri enabled to 4.0.x.
2730

2831
When that migration is done, the old ("blue") cluster is decommissioned (shut down, deleted).
2932
To simplify the switch, [federated queues](./federated-queues)

versioned_docs/version-3.13/blue-green-upgrade.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,19 @@ limitations under the License.
2323

2424
## Overview {#overview}
2525

26-
Blue-green deployment is an [upgrade strategy](./upgrade) that is based on the idea of setting up
27-
a second RabbitMQ cluster (the "green" one) next to the current production
28-
cluster (the "blue" one). Applications are then switched to the "green"
29-
cluster. When that migration is done, the "blue" cluster is decommissioned (shut down).
26+
Blue-green deployment is a migration technique that can also be used as an [upgrade strategy](./upgrade).
27+
The main idea is to set up a new environment (the "green" one) and switch to it
28+
when it is ready. The "upgrade" is not performed "in place", the application just switch
29+
to a different environment, which might be using a different version, but can
30+
also differ in other aspects.
31+
32+
The same approach can be used to migrate to a new operating system or new hardware, while keeping the same version of RabbitMQ,
33+
or to upgrade from a version that cannot be upgraded to the target series directly,
34+
for example, from 3.12.x to 4.0.x or from a 3.13.x cluster with Khepri enabled to 4.0.x.
35+
36+
When that migration is done, the old ("blue") cluster is decommissioned (shut down, deleted).
3037
To simplify the switch, [federated queues](./federated-queues)
3138
can be used to transfer enqueued messages from the "blue" to the "green" cluster.
32-
3339
## Preparing the "green" Cluster {#preparation}
3440

3541
After deploying a brand new "green" cluster, there are two steps to follow:

versioned_docs/version-4.0/blue-green-upgrade.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,13 @@ limitations under the License.
2020

2121
Blue-green deployment is a migration technique that can also be used as an [upgrade strategy](./upgrade).
2222
The main idea is to set up a new environment (the "green" one) and switch to it
23-
when it is ready. Technically nothing is upgraded - the application just switch
23+
when it is ready. The "upgrade" is not performed "in place", the application just switch
2424
to a different environment, which might be using a different version, but can
25-
also differ in other aspects. For example, the same approach can be used
26-
to migrate to new hardware, while keeping the same version of RabbitMQ.
25+
also differ in other aspects.
26+
27+
The same approach can be used to migrate to a new operating system or new hardware, while keeping the same version of RabbitMQ,
28+
or to upgrade from a version that cannot be upgraded to the target series directly,
29+
for example, from 3.12.x to 4.0.x or from a 3.13.x cluster with Khepri enabled to 4.0.x.
2730

2831
When that migration is done, the old ("blue") cluster is decommissioned (shut down, deleted).
2932
To simplify the switch, [federated queues](./federated-queues)

0 commit comments

Comments
 (0)