Alibaba Cloud Message Queue for RabbitMQ automatically upgrades server-side versions in the background. You can adjust the upgrade execution time and maintenance window to align with your off-peak hours.
Limitations
The version management feature is available only for Serverless dedicated instances.
Upgrade impact
-
Clients may disconnect during an upgrade. We recommend that you configure your client to automatically reconnect.
-
Messages may be consumed more than once. To handle this, design your application for message idempotence.
-
During a version upgrade, you cannot unsubscribe from, release, scale, or perform other upgrade-related operations on the instance. Avoid console management operations such as creating or deleting topics during an upgrade.
-
You cannot roll back an instance to a previous version after an upgrade.
Version format
The full version number of an instance follows the format rabbitmq-yyyyMMdd[-suffix]. Each commercial version includes new features, enhancements, and bug fixes.
-
The release version number is rabbitmq-yyyyMMdd.
-
yyyyMMdd: The commercial version number, indicating the release date. For example, rabbitmq-20250619 means the instance runs commercial version 20250619.
-
-suffix: A suffix indicating a minor update or bug fix for the current release. For example, if a bug in rabbitmq-20250619 is fixed, the version number becomes rabbitmq-20250619-update1.
Upgrade examples:
-
Upgrade from rabbitmq-20250619 to rabbitmq-20250629
-
Upgrade from rabbitmq-20250619 to rabbitmq-20250619-update1
Upgrade rules
Upgrade methods
-
Automatic upgrades
Instances with automatic upgrades enabled are upgraded to the latest compatible version during the maintenance window.
-
Manual upgrades
-
Automatic upgrades are disabled by default. You can enable this feature manually. For more information, see Modify configuration.
-
Without automatic upgrades, you may miss the latest features and bug fixes. We recommend enabling automatic upgrades.
-
Each version has a 12-month validity period. If you do not upgrade your instance during this time, a mandatory and non-cancelable upgrade will be initiated in the 12th month.
-
Within the validity period, you can manually upgrade to the latest compatible version at any time.
-
Maintenance window
-
A maintenance window is defined by a start time and an end time, specified on the hour (for example, 00:00, 01:00, ..., 23:00).
-
The default maintenance window is from 22:00 to 00:00 (China Standard Time).
-
If the start time and end time are the same, the maintenance window is active all day. If the end time is earlier than the start time, the window extends into the next day.
-
You can change the maintenance window.
-
Changing the maintenance window cancels any pending upgrade task and creates a new one.
-
Tasks that are already in progress are not affected by changes to the maintenance window.
-
Version validity
A version of Alibaba Cloud Message Queue for RabbitMQ is valid for 12 months. One month before a version expires, a non-cancelable upgrade task is automatically created. You can choose when to perform the upgrade within this window.
Target upgrade version
By default, the instance is upgraded directly to the latest compatible stable version, skipping any intermediate versions.
Modify configuration
Log on to the ApsaraMQ for RabbitMQ console. In the left-side navigation pane, click Instances.
In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.
-
On the Instance Details page, click the Version Management tab, and then click Modify Configuration in the upper-right corner.
-
In the Modify Configuration panel, configure the following parameters and click OK.
-
Time Zone: Select a time zone.
-
Maintenance Window: Select a maintenance window.
-
Automatic Upgrade: Select whether to enable automatic upgrades.
-
Modify task schedule
Log on to the ApsaraMQ for RabbitMQ console. In the left-side navigation pane, click Instances.
In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.
-
On the Instance Details page, click the Version Management tab.
-
On the Version Management page, click the Pending Upgrade Tasks tab.
-
In the list of pending upgrade tasks, find the desired task and click Modify Time in the Actions column.
-
In the Modify Pending Upgrade Task Time panel, set the New Scheduled Running Time, and then click OK.