1. 产品背景
腾讯云消息队列旧版 CMQ 已完成全面升级，旧版 CMQ 服务流量已全部迁移至 TDMQ-CMQ。TDMQ-CMQ 是腾讯云基于 RocketMQ 架构打造的新一代分布式消息队列服务，在兼容旧版 CMQ 功能的同时，提供了更强大的消息处理能力和更稳定的服务保障。
为了进一步给您提供稳定的服务和SLA保障，请您将旧版 CMQ 的接入地址切换为新版 TDMQ-CMQ 的接入地址。
2. 接入点切换背景
服务终止：旧版 CMQ 服务已全面停止运营，所有流量已切换至 TDMQ-CMQ，旧版 CMQ 机器需全部回收处理。
兼容性保障：TDMQ-CMQ 完全兼容原有 CMQ SDK 接口，业务逻辑代码无需修改，只需要修改接入点配置。
性能提升：接入点替换后，可以提供更低的服务请求耗时和更好的服务 SLA 保障。
3. 接入点切换优势
如上图所示，旧版 CMQ 服务流量通过无感升级的方式已迁移到了 TDMQ-CMQ，仍然使用旧版 CMQ 接入点进行生产消费，请求都会由旧版 CMQ 网关层转发到 TDMQ-CMQ，如果直接使用 TDMQ-CMQ 接入点，请求则会直接路由到 TDMQ-CMQ。
使用 TDMQ-CMQ 接入点，少一层网关转发，网络链路更短，请求延迟更低。同时服务链路不受旧版 CMQ 网关影响，稳定性更高，服务可用性更高。
4. 切换步骤
4.1 获取新接入点
接入点切换对应列表：
地域 | 旧版 CMQ 接入点 | TDMQ-CMQ 接入点 |
广州 | 公网地址： https://cmq-queue-gz.api.qcloud.comhttps://cmq-topic-gz.api.qcloud.com内网地址： http://cmq-queue-gz.api.tencentyun.comhttp://cmq-topic-gz.api.tencentyun.com | 公网地址： https://cmq-gz.public.tencenttdmq.com内网地址： http://gz.mqadapter.cmq.tencentyun.com |
上海 | 公网地址： https://cmq-queue-sh.api.qcloud.comhttps://cmq-topic-sh.api.qcloud.com内网地址： http://cmq-queue-sh.api.tencentyun.comhttp://cmq-topic-sh.api.tencentyun.com | 公网地址： https://cmq-sh.public.tencenttdmq.com内网地址： http://sh.mqadapter.cmq.tencentyun.com |
北京 | 公网地址： https://cmq-queue-bj.api.qcloud.comhttps://cmq-topic-bj.api.qcloud.com内网地址： http://cmq-queue-bj.api.tencentyun.comhttp://cmq-topic-bj.api.tencentyun.com | 公网地址： https://cmq-bj.public.tencenttdmq.com内网地址： http://bj.mqadapter.cmq.tencentyun.com |
成都 | 公网地址： https://cmq-queue-cd.api.qcloud.comhttps://cmq-topic-cd.api.qcloud.com内网地址： http://cmq-queue-cd.api.tencentyun.comhttp://cmq-topic-cd.api.tencentyun.com | 公网地址： https://cmq-cd.public.tencenttdmq.com内网地址： http://cd.mqadapter.cmq.tencentyun.com |
上海金融 | 公网地址： https://cmq-queue-shjr.api.qcloud.comhttps://cmq-topic-shjr.api.qcloud.com内网地址： http://cmq-queue-shjr.api.tencentyun.comhttp://cmq-topic-shjrapi.tencentyun.com | 公网地址： https://cmq-shjr.public.tencenttdmq.com内网地址： http://shjr.mqadapter.cmq.tencentyun.com |
深圳金融 | 公网地址： https://cmq-queue-szjr.api.qcloud.comhttps://cmq-topic-szjr.api.qcloud.com内网地址： http://cmq-queue-szjr.api.tencentyun.comhttp://cmq-topic-szjrapi.tencentyun.com | 公网地址： https://cmq-szjr.public.tencenttdmq.com内网地址： http://szjr.mqadapter.cmq.tencentyun.com |
4.2 配置变更
修改应用程序配置文件中 endpoint 地址。
Account account = new Account(SERVER_ENDPOINT, SECRET_ID, SECRET_KEY);# 旧配置示例# 新配置示例
4.3 验证测试
4.3.1 发送测试消息；
4.3.2 消费测试消息，并删除消息；
4.3.3 验证消息是否生产消费删除成功。
4.4 正式切换
可采用灰度发布策略，先切换部分资源接入点观察业务指标，灰度验证通过后全量切换。
5. 常见问题
Q1: 切换过程中原有消息是否会丢失？
A: 不会丢失。用户切换接入点不影响消息的生产消费，且新接入点完全兼容旧版 CMQ 协议接口。
Q2: 新接入点的鉴权方式是否有变化？
A: 鉴权机制保持不变，继续使用 SecretId 和 SecretKey 进行鉴权。
