在调用SDK收发消息前,您需要提前创建消息队列RocketMQ版的相关资源,包括创建消息队列RocketMQ版实例、获取实例的接入点、创建Topic、创建ConsumerGroup。调用SDK时,需要将这些资源信息填写到SDK代码中。

前提条件

创建专有网络和交换机

背景信息

消息队列RocketMQ版支持通过控制台和OpenAPI创建资源,本文以控制台操作为例,介绍如何在消息队列RocketMQ版控制台创建资源。

使用OpenAPI创建资源,请参见API概览

使用限制

  • 地域限制

    请确保您创建的消息队列RocketMQ版实例的所属地域和前提条件中创建的专有网络以及交换机的所属地域一致。

  • 命名规范

    消息队列RocketMQ版实例、Topic和ConsumerGroup的命名规范,请参见使用限制

  • Topic类型限制

    Topic的消息类型需要和实际发送的消息类型保持一致,例如,您创建了一个普通消息类型的Topic,则该Topic只能用于收发普通消息,不能用于收发顺序消息。更多信息,请参见Topic使用建议

创建实例

  1. 登录控制台,在左侧导航栏单击实例列表
  2. 在顶部菜单栏选择地域,如华东1(杭州)
  3. 实例列表页面单击创建实例,在弹出的创建 RocketMQ 实例面板中,实例版本选择为5.0系列付费方式选择为包年包月,然后单击确定
  4. 在产品售卖页选择实例规格,然后单击立即购买,并按照提示完成支付。
    您可以参考如下示例值完成创建。具体规格含义和取值,请参见产品选型
    参数取值示例
    主系列类型标准版
    子系列类型集群高可用版本(生产环境推荐)
    消息收发计算规格rmq.s2.2xlarge
    VPC IDvpc-bp1cg09dua6sgh0******

    该参数为您在前提条件中创建的专有网络的ID。

    重要 消息队列RocketMQ版实例创建后,选择的VPC不支持变更。若要修改关联的VPC,您需要先释放已购买的消息队列RocketMQ版实例,再重新购买。
    VSwitch IDvsw-bp1vqb0p9nz3irz******

    该参数为您在前提条件中创建的交换机的ID。

    重要 消息队列RocketMQ版实例创建后,选择的交换机不支持变更。若要修改关联的交换机,您需要先释放已购买的消息队列RocketMQ版实例,再重新购买。
    公网访问类型关闭
    说明 本文以使用VPC接入消息队列RocketMQ版服务端场景为例,公网访问默认关闭;若您需要通过公网接入消息队列RocketMQ版,您需要将公网访问类型设置为开启。
    回到消息队列RocketMQ版控制台,刷新实例列表页面,即可在实例列表中看到已创建好的实例。

获取实例接入点

  1. 登录消息队列RocketMQ版控制台,在左侧导航栏单击实例列表
  2. 在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。
  3. 实例详情页面,单击接入点页签,即可查看实例的接入点信息。
    • VPC专有网络接入点:使用VPC专有网络访问消息队列RocketMQ版时使用。消息队列RocketMQ版默认提供的接入点。
    • 公网接入点:使用公网访问消息队列RocketMQ版时使用该接入点。仅当开启公网访问时显示。

创建Topic

  1. 登录消息队列RocketMQ版控制台,在左侧导航栏单击实例列表
  2. 在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。
  3. 在左侧导航栏单击Topic 管理,然后在Topic 管理页面单击创建 Topic
  4. 创建 Topic面板中填写Topic名称和描述,选择消息类型普通消息,然后单击确定

创建ConsumerGroup

  1. 登录消息队列RocketMQ版控制台,在左侧导航栏单击实例列表
  2. 在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。
  3. 在左侧导航栏单击Group 管理,然后在Group 管理页面单击创建 Group
  4. 创建 Group面板填写Group ID,然后单击确定

后续步骤

步骤三:调用SDK收发消息