ApsaraMQ for RabbitMQ provides a fully managed version management service. After a new server-side version is released, the system automatically performs a background upgrade. You can change the maintenance window and the running time for the upgrade task to align with your off-peak business hours.
Limits
The version management feature is supported only on Serverless dedicated instances.
Upgrade impact
Clients may disconnect during an upgrade. Configure your clients to automatically reconnect.
Messages may be consumed more than once. To ensure data consistency, design your application to be idempotent. For more information, see Message idempotence.
During a version upgrade, you cannot unsubscribe from, release, upgrade, or downgrade an instance. Other management operations are also not supported. Avoid performing operations in the console during an upgrade, such as creating or deleting topics.
You cannot roll back to a previous version after an upgrade.
Version format
The version number for an instance uses the format `rabbitmq-yyyyMMdd-x`. This version includes commercial features, feature enhancements, and bug fixes. The format is composed of the following parts:
`rabbitmq-yyyyMMdd`: The release version.
`yyyyMMdd`: The release date of the commercial version in the YYYYMMDD format. For example, `rabbitmq-20250619` indicates that the commercial version was released on June 19, 2025.
`x`: 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`.
Examples of upgrades:
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 must enable this feature manually. For more information, see Modify configuration information.
We recommend that you enable automatic upgrades to promptly receive the latest features and bug fixes.
Each version is valid for 12 months. If you do not upgrade within this period, a mandatory upgrade is initiated in the 12th month. This operation cannot be canceled.
You can manually upgrade to the latest compatible version at any time before the current version expires.
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 (UTC+8).
If the start and end times are the same, the window is active all day. If the end time is earlier than the start time, the window extends to the next day.
You can change the maintenance window.
If you change the maintenance window, any pending upgrade task is canceled and a new one is created.
Tasks in progress are not affected by changes to the maintenance window.
Version validity
A version of ApsaraMQ for RabbitMQ is valid for 12 months. One month before a version expires, the system creates a mandatory upgrade task. You can choose when to perform the upgrade based on your business needs.
Target upgrade version
The instance is always upgraded to the latest stable version that is compatible with your current version, skipping any intermediate versions.
Modify configuration information
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. In the upper-right corner of the page, click Modify Configuration.
In the Modify Configuration panel, modify 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 the running time of a task
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 task that you want to modify 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.