本文介绍如何在消息队列RocketMQ版控制台创建迁移上云任务。

背景信息

消息队列RocketMQ版提供元数据导出工具,支持将开源RocketMQ集群的元数据导出为一个JSON文件,您在创建迁移上云任务前需要按照准备工作中的操作导出开源RocketMQ的元数据文件,再将该文件上传至消息队列RocketMQ版控制台。

准备工作

使用元数据导出工具导出开源RocketMQ的元数据文件。

根据您的开源RcoketMQ服务器的网络类型,消息队列RocketMQ版提供以下两种方式导出开源RcoketMQ的元数据。
  • 导出数据方法一:下载脚本上传到RocketMQ服务器运行,运行以下命令。
    ./bin/export.sh

    操作流程:下载脚本→上传至服务器→执行./bin/export.sh

  • 导出数据方法二:如果RocketMQ服务器可访问公网,直接运行以下命令。
    /bin/bash -c "$(curl -fsSL https://ons-migration.oss-cn-hangzhou.aliyuncs.com/export.sh)"

方法一操作步骤

  1. 访问rocketmq-for-export.tar.gz地址下载元数据导出工具。
  2. 将下载好的工具上传至开源RocketMQ机器。
  3. 在工具所在目录下执行./bin/export.sh命令运行元数据导出工具。
  4. 按提示依次输入要连接的开源RocketMQ服务器地址、需要下载元数据的集群名称以及导出文件的保存路径。
    //输入开源RocketMQ的服务器地址及端口号,端口固定取值为9876。
    Enter name server address list: example.net:9876
    //输入需要导出元数据的开源RocketMQ集群名称。
    Choose a cluster to export: DefaultCluster
    //输入导出的元数据文件的存放路径,不输入则文件被存放至默认路径/tmp/rocketmq/config。 
    Enter file path to export [default /tmp/rocketmq/export]:
    返回如下内容说明导出元数据成功:
    [INFO] The RocketMQ metadata has been export to the file:/tmp/rocketmq/config/rocketmq-metadata-export.json

方法二操作步骤

  1. 在开源RocketMQ的机器上,执行以下命令一键下载并运行元数据导出工具。
    说明 命令中的https://ons-migration.oss-cn-hangzhou.aliyuncs.com为脚本的存放路径,请勿修改。
    /bin/bash -c "$(curl -fsSL https://ons-migration.oss-cn-hangzhou.aliyuncs.com/export.sh)"
  2. 按提示依次输入要连接的开源RocketMQ服务器地址、需要下载元数据的集群名称以及导出文件的保存路径。
    //输入开源RocketMQ的服务器地址及端口号,端口固定取值为9876。
    Enter name server address list: example.net:9876
    //输入需要导出元数据的开源RocketMQ集群名称。
    Choose a cluster to export: DefaultCluster
    //输入导出的元数据文件的存放路径,不输入则文件被存放至默认路径/tmp/rocketmq/config。 
    Enter file path to export [default /tmp/rocketmq/export]:
    返回如下内容说明导出元数据成功:
    [INFO] The RocketMQ metadata has been export to the file:/tmp/rocketmq/config/rocketmq-metadata-export.json

创建迁移任务

  1. 登录消息队列RocketMQ版控制台
  2. 在左侧导航栏单击迁移上云
  3. 在顶部菜单栏,选择地域,如华东1(杭州)
  4. 迁移上云页面左上角单击创建任务
  5. 创建任务配置向导页面,完成以下操作并单击下一步
    1. 任务名称文本框输入迁移上云的任务名称。
      说明 任务名称长度限制为3~64个字符,只能包含中文、英文、数字、短划线(-)和下划线(_)。
    2. 单击元数据参数右侧的点击上传元数据文件按钮,选择提前导出的JSON格式的元数据文件。元数据导出操作,请参见准备工作

后续步骤

步骤二:迁移评估