Versions
Alibaba Cloud Message Queue for RabbitMQ provides a fully managed version management service. When a new version is released, the system automatically performs a background upgrade. You can change the upgrade execution time and the maintenance window to align with your off-peak business 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. As a best practice, your application should be designed to handle message idempotence.
-
During a version upgrade, you cannot unsubscribe from, release, scale, or perform other upgrade-related operations on the instance. Avoid performing management operations in the console during an upgrade, such as creating or deleting a topic.
-
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]. The commercial version includes new features, enhancements, and bug fixes. The format is composed of the following parts:
-
The release version number is rabbitmq-yyyyMMdd.
-
yyyyMMdd: The commercial version number, which indicates the release date. For example, rabbitmq-20250619 indicates that the commercial version of the instance is 20250619.
-
-suffix: A suffix that indicates 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.
-
If you do not enable automatic upgrades, you might not promptly receive the latest features and bug fixes. We recommend that you enable 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 based on your business needs.
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, change the following parameters, and then 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.