版本管理

使用限制

仅铂金版实例支持版本管理功能，标准版实例和专业版实例暂不支持。

升级影响

• 升级过程一般不超过30分钟，如遇到升级时间超过30分钟，您可以提交工单或铂金版专家支持钉群及时反馈。升级期间会分批重启服务端机器，可能会导致客户端连接闪断，但消息收发功能不受影响。

• 消息可能会有重复消费的情况，应用应该按最佳实践，做好消息的幂等，详情请参见消息幂等。

• 版本升级过程中不支持实例退订、实例释放、实例升降配及其他升级操作，实例续费可正常执行，如需在控制台进行管理操作（例如创建、删除Topic），请避开升级期间。

• 版本升级后不支持回退到历史版本。

版本升级范围

实例的完整版本号：x.y-rmq-yyyymmdd。具体规范如下：

• x.y：对应开源版本号x.y.z，其中z为开源最新版本。例如5.1对应开源最新版本5.1.z。

• yyyymmdd：对应商业版版本号，例如20230329。商业版本包含商业版的功能特性、特性增强和Bugfix内容。

具体各版本升级的内容，请参见5.x系列版本发布日志。

版本升级规则

升级方式

自动升级：云消息队列 RocketMQ 版系统默认自动升级实例版本。云消息队列 RocketMQ 版服务端版本迭代发布后，系统会自动创建待升级任务，并在后台自动完成升级操作。

待升级任务说明

待升级任务由云消息队列 RocketMQ 版自动创建，您可以在控制台查看任务状态和执行时间等详细信息，或修改待升级任务的计划执行时间。具体操作，请参见修改任务可执行时间。

可运维时间段

• 自动升级操作会在系统默认的可维护时间段内执行，默认时间为：02:00~06:00。

• 您可以自定义修改可维护时间段。具体操作，请参见修改可维护时间段。

• 修改可维护时间段仅对之后生成的待升级任务生效，当前已生成的待升级任务不受影响。

• 若设置的可维护时间段的起始时间等于结束时间，表示全天都处于可升级的时间段。

• 若设置的可维护时间段的结束时间小于起始时间，表示结束时间为第二天。例如11:00~02:00，表示前一天晚上11点到第二天凌晨2点。

版本有效期

云消息队列 RocketMQ 版的版本有效期为6个月。

升级目标版本

不管中间是否有多个版本，默认直接将实例升级到当前发布的最新版本。

修改任务可执行时间

1. 登录云消息队列 RocketMQ 版控制台，在左侧导航栏单击实例列表。

2. 在顶部菜单栏选择地域，如华东1（杭州），然后在实例列表中，单击目标实例名称。

3. 在实例详情页面单击版本管理页签。

4. 在版本管理页面中单击待升级任务页签。

5. 在待升级任务列表找到需要修改的任务，在其操作列单击修改时间。

6. 在修改待升级任务时间面板中，设置新计划执行时间，然后单击确定。

修改可维护时间段

1. 登录云消息队列 RocketMQ 版控制台，在左侧导航栏单击实例列表。

2. 在顶部菜单栏选择地域，如华东1（杭州），然后在实例列表中，单击目标实例名称。

3. 在实例详情页面单击版本管理页签，然后在页面右上角单击更新配置。

4. 在弹出的修改版本升级配置面板中修改可维护的时间段，然后单击确定。

相关文档

云消息队列 RocketMQ 版服务端各版本的升级内容，请参见5.x系列版本发布日志。