From 4b20352c08b1b8604e79c13cdabd2694a8885933 Mon Sep 17 00:00:00 2001 From: Matt Crees Date: Wed, 16 Apr 2025 09:37:57 +0100 Subject: Drop RabbitMQ SLURP docs We don't need to handle extra version upgrades from Caracal -> Epoxy, so these docs can be dropped. Signed-off-by: Bartosz Bezak Change-Id: I122821b6aaf11cbf3d8695340d23c168b3373b58 --- doc/source/reference/message-queues/rabbitmq.rst | 52 ------------------------ 1 file changed, 52 deletions(-) (limited to 'doc') diff --git a/doc/source/reference/message-queues/rabbitmq.rst b/doc/source/reference/message-queues/rabbitmq.rst index 78983633e..14068fc07 100644 --- a/doc/source/reference/message-queues/rabbitmq.rst +++ b/doc/source/reference/message-queues/rabbitmq.rst @@ -159,55 +159,3 @@ different type, the follow procedure will be needed. .. code-block:: console kolla-ansible deploy --tags - -SLURP -~~~~~ - -.. note:: - - The version of RabbitMQ did not increase in Dalmatian, so this will not be - needed for a skip-level upgrade to Epoxy. - -RabbitMQ has two major version releases per year but does not support jumping -two versions in one upgrade. So if you want to perform a skip-level upgrade, -you must first upgrade RabbitMQ to an intermediary version. To do this, Kolla -provides multiple RabbitMQ versions in the odd OpenStack releases. To use the -upgrade from Antelope to Caracal as an example, we start on RabbitMQ version -3.11. In Antelope, you should upgrade to RabbitMQ version 3.12 with the command -below. You can then proceed with the usual SLURP upgrade to Caracal (and -therefore RabbitMQ version 3.13). - -.. warning:: - - This command should be run from the Antelope release. - - Note that this command is NOT idempotent. See "RabbitMQ versions" below for - an alternative approach. - -.. code-block:: console - - kolla-ansible rabbitmq-upgrade 3.12 - -RabbitMQ versions -~~~~~~~~~~~~~~~~~ - -Alternatively, you can set ``rabbitmq_image`` in your configuration -``globals.yml`` for idempotence in deployments. As an example, Kolla ships -versions 3.11, 3.12 and 3.13 of RabbitMQ in Antelope. By default, Antelope -Kolla-Ansible will deploy version 3.11. If you wish to deploy a later version, -you must override the image. if you want to use version 3.12 change -``rabbitmq_image`` in ``globals.yml`` as follows: - -.. code-block:: yaml - - rabbitmq_image: "{{ docker_registry ~ '/' if docker_registry else '' }}{{ docker_namespace }}/rabbitmq-3-12" - -You can then upgrade RabbitMQ with the usual command: - -.. code-block:: console - - kolla-ansible upgrade --tags rabbitmq - -Note again that RabbitMQ does not support upgrades between more than one major -version, so if you wish to upgrade to version 3.13 you must first upgrade to -3.12. -- cgit v1.2.3