消息队列 CMQ 版 开发指南

腾讯云 “消息队列 CMQ” 产品正在下线过程中,2026 年 8 月 31 日将正式下线并停止服务。这篇主要对旧版 CMQ 迁移事项做出说明并指导客户进行自查,确认是否全部资源迁移完成。

相关产品
消息队列 CMQ 版 产品页,含版本规格、价格与购买入口。

一、旧版 CMQ 下线背景周知

自2023年起,腾讯云消息队列团队对消息队列 CMQ(以下简称旧版 CMQ)进行了大量稳定性和技术优化,同时结合消息队列产品系列 TDMQ(Tencent Distributed Message Queue) 整体品牌升级策略,使用最新的商业化产品消息队列 TDMQ CMQ 版(以下简称新版 CMQ)承接。

新版 CMQ 完全兼容旧版 CMQ 的 SDK 和功能,并按照 TDMQ CMQ 版的商业化规则进行计费,计费规则见 新版 CMQ 计费概述。腾讯云会按照服务等级协议为 TDMQ CMQ 版提供质量保障,服务等级协议见 新版 CMQ 服务等级说明。

二、旧版 CMQ 迁移说明

自2023年下半年起,消息队列团队陆续通过站内信、短信和邮箱等方式推送过 “消息队列 CMQ(旧版 CMQ)的下线通知”。为了减少产品迁移对存量客户的影响,腾讯云消息队列团队提供了无感迁移方案,理论上对客户无感,客户仅需要在迁移期间保持关注,观察监控告警即可。

迁移后,建议你将业务代码中的旧版 CMQ 的 API 请求地址(Endpoint 接入地址)修改为 TDMQ CMQ 的 API 请求地址(Endpoint 接入地址),后者的请求地址网络链路更短,请求延迟更低,详情见旧版 CMQ 接入地址切换指南。

当前,大部分活跃资源已经迁移完成,少量不活跃资源仍然在旧版 CMQ 控制台上保留。请你根据以下指引,对比旧版 CMQ 和 TDMQ CMQ 的控制台数据,确认没有遗留的资源需要迁移。

三、存量数据排查

你可以按照以下步骤来排查旧版 CMQ 资源是否迁移完成:

1. 分别登录同一地域的 TDMQ CMQ 与旧版 CMQ 控制台;

2. 对比两个控制台中队列/主题列表底部的元数据条数记录,初步核查是否存在未迁移的数据;

3. 若发现条数存在差异,使用旧版 CMQ 控制台的搜索功能,输入疑似未迁移的队列或主题名称,定位具体未迁移的资源;

4. 打开业务代码,通过搜索队列/主题名称的方式,进一步验证未迁移的资源是否仍在业务系统中被使用。

5. 如果确认某些旧版 CMQ 控制台的队列或主题需要迁移到 TDMQ CMQ,你可以通过提交工单联系腾讯云消息队列团队进行迁移。

TDMQ CMQ 控制台入口:

TDMQ CMQ(新版 CMQ)控制台队列列表:https://console.cloud.tencent.com/tdmq/cmq-queue

TDMQ CMQ(新版 CMQ)控制台主题列表:https://console.cloud.tencent.com/tdmq/cmq-topic

旧版 CMQ 控制台入口:

旧版 CMQ 控制台队列列表:https://console.cloud.tencent.com/cmq/index

旧版 CMQ 控制台主题列表:https://console.cloud.tencent.com/cmq/topic

四、修改客户端接入点

旧版 CMQ 控制台的队列或者主题迁移后,请将业务代码中的旧版 CMQ 的 API 请求地址(Endpoint 接入地址)修改为 TDMQ CMQ 的 API 请求地址(Endpoint 接入地址),详细操作见旧版 CMQ 接入地址切换指南。

赞 (0)
上一篇 4天前
下一篇 4天前