RocketMQ入门基础-环境&整合

Dear 丶 2023-07-20 05:47 159阅读 0赞

## 概述&选型 ##

消息队列作为高并发系统的核心组件之一，能够帮助业务系统解构提升开发效率和系统稳定性。主要用于三种典型场景：**应用解耦**、**流量消峰**、**消息分发**。

目前主流的MQ主要是Rocketmq、kafka、Rabbitmq，Rocketmq相比于Rabbitmq、kafka具有主要优势特性有：

*  支持事务型消息（消息发送和DB操作保持两方的最终一致性，rabbitmq和kafka不支持）
 *  支持结合rocketmq的多个系统之间数据最终一致性（多方事务，二方事务是前提）
 *  支持18个级别的延迟消息（rabbitmq和kafka不支持）
 *  支持指定次数和时间间隔的失败消息重发（kafka不支持，rabbitmq需要手动确认）
 *  支持consumer端tag过滤，减少不必要的网络传输（rabbitmq和kafka不支持）
 *  支持重复消费（rabbitmq不支持，kafka支持）

本文主要介绍RocketMQ的单机安装、双机主从高可用安装配置、运维管理平台搭建、与SpringBoot整合几个知识点，具备相关知识技能的同学请直接拉到最后点个 “在看” 即可。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70]

**文章开始之前需要先准备好JDK1.8或以上的服务器环境以及从rocketmq官网下载好二进制安装包，下载地址http://rocketmq.apache.org/dowloading/releases/**

## 单机安装配置 ##

工欲善其事必先利其器，要想深入了解RocketMQ得先把环境安装好，咱们先开始单机版RocketMQ的安装！

*  解压安装  
    `unzip rocketmq-all-4.7.0-bin-release.zip`
 *  启动 Name Server  
    `> nohup sh bin/mqnamesrv &`
 *  查看 Name Server启动日志  
    `> tail -f ~/logs/rocketmqlogs/namesrv.log`  
    ![在这里插入图片描述][20200331162953503.png]
 *  启动 Broker Server  
    `> nohup sh bin/mqbroker -n localhost:9876 &`
 *  查看 Broker Server 启动日志  
    `> tail -f ~/logs/rocketmqlogs/broker.log`  
    ![在这里插入图片描述][20200331163000124.png]

单机情况下安装使用RocketMQ很简单，只需要分别启动NameServer和Broker Server即可！

关闭RockerMQ需要使用下面的命令：

# 先关闭Broker Server
    > sh bin/mqshutdown broker
    # 再关闭NameServer
    > sh bin/mqshutdown namesrv

## 双机主从高可用搭建 ##

为了消除单机故障，增加可靠性或增大吞吐量，可以在多台服务器上部署多个NameServer和Broker，并为每个Broker部署一个或多个Slave。本节将说明使用两台机器，搭建双主、双从、无单点故障的高可用RocketMQ集群。假设现在有两台服务器，IP地址分别为：192.168.100.43和192.168.100.44，部署架构如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70 1]

### 启动多个NameServer 和 Broker ###

首先需要在两台服务器上分别启动NameServer（nohup sh bin/mqnamesrv &），这样我们就得到了一个无单点的NameServer服务，服务地址为192.168.100.43:9876和192.168.100.44:9876。

然后在两台服务器中RocketMQ的conf目录分别建立两个文件 `broker-master.properties`，`broker-slave.properties`，下面是不同服务器的配置说明：

*  192.168.100.43 机器上的broker-master.properties文件：

namesrvAddr = 192.168.100.43:9876;192.168.100.44:9876
    brokerClusterName = DefaultCluster
    brokerName = broker-a
    brokerId = 0
    deleteWhen = 04
    fileReservedTime = 48
    brokerRole = SYNC_MASTER
    flushDiskType = ASYNC_FLUSH
    listenPort = 10911
    storePathRootDir = /app/rocketmq/store-a

*  192.168.100.43 机器上的broker-slave.properties文件：

namesrvAddr = 192.168.100.43:9876;192.168.100.44:9876
    brokerClusterName = DefaultCluster
    brokerName = broker-b
    brokerId = 1
    deleteWhen = 04
    fileReservedTime = 48
    brokerRole = SLAVE
    flushDiskType = ASYNC_FLUSH
    listenPort = 11011
    storePathRootDir = /app/rocketmq/store-b

*  192.168.100.44 机器上的broker-master.properties文件：

namesrvAddr = 192.168.100.43:9876;192.168.100.44:9876
    brokerClusterName = DefaultCluster
    brokerName = broker-b
    brokerId = 0
    deleteWhen = 04
    fileReservedTime = 48
    brokerRole = SYNC_MASTER
    flushDiskType = ASYNC_FLUSH
    listenPort = 10911
    storePathRootDir = /app/rocketmq/store-b

*  192.168.100.44 机器上的broker-slave.properties文件：

namesrvAddr = 192.168.100.43:9876;192.168.100.44:9876
    brokerClusterName = DefaultCluster
    brokerName = broker-a
    brokerId = 1
    deleteWhen = 04
    fileReservedTime = 48
    brokerRole = SLAVE
    flushDiskType = ASYNC_FLUSH
    listenPort = 11011
    storePathRootDir = /app/rocketmq/store-a

然后分别使用如下命令启动两台服务器的主节点和从节点  
`nohup sh bin/mqbroker -c conf/broker-master.properties &`  
`nohup sh bin/mqbroker -c conf/broker-slave.properties &`

这样一个高可用的RockerMQ集群就搭建好了，我们登陆可视化运维管理界面查看集群状态，集群正常启动。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70 2]

### 重要参数说明 ###

本节主要是对Broker的配置文件中用到的参数进行说明

*  `namesrvAddr = 192.168.100.43:9876;192.168.100.44:9876`  
    指定NameServer的地址，可以是多个。
 *  `brokerClusterName = DefaultCluster`  
    Cluster地址，如果集群数量比较多，可以分成多个Cluster，每个Cluster供一个业务群使用。
 *  `brokerName = broker-a`  
    Broker的名称，Master 和Slave 通过使用相同的 Broker 名称来表明相互关系，以说明某个Slave 是哪个Master 的 Slave。
 *  `brokerId = 1`  
    一个Master可以有多个Slave，0表示Master，大于0的表示不同Slave的ID。
 *  `fileReservedTime = 48`  
    在磁盘上保存消息的时长，单位是小时，自动删除超时的消息。
 *  `deleteWhen = 04`  
    与 fileReservedTime 参数对应，表明在几点做消息删除动作，默认是凌晨4点。
 *  `brokerRole = SYNC_MASTER`  
    `brokerRole`的可选参数有`SYNC_MASTER`，`ASYNC_MASTER`，`SLAVE`三种。`SYNC` 和`ASYNC` 表示`MASTER` 和`SLAVE` 之间同步消息的机制，`SYNC`的意思是当`Slave` 和 `Master` 的消息同步完成后再返回发送成功的状态。
 *  `flushDiskType = ASYNC_FLUSH`  
    `flushDiskType` 表示刷盘策略，可选值有ASYNC\_FLUSH 和 SYNC\_FLUSH两种，分别代表同步刷盘和异步刷盘。同步情况下，消息只有真正写入磁盘才返回成功状态；异步情况下，消息写入page\_cache后就返回成功状态。
 *  `listenPort = 11011`  
    Broker监听的端口，一台服务器启动多个Broker，需要设置不同的监听端口避免端口冲突。
 *  `storePathRootDir = /app/rocketmq/store-a`  
    存储消息以及配置信息的根目录。

## 可视化管理平台 ##

RocketMQ可以使用`rocketmq-externals`作为运维管理平台，Github地址https://github.com/apache/rocketmq-externals，我们需要将源码下载下来后再进行手动编译，过程如下：

*  下载  
    从github（https://github.com/apache/rocketmq-externals） 下载RocketMQ可视化管理工具 `rocketmq-externals` 的源码；
 *  打包  
    下载完成后切换进rocketmq-console目录，使用maven命令对其打包 `mvn clean package -Dmaven.test.skip=true` ，打包完成后生成可执行文件rocketmq-console-ng-1.0.1.jar
 *  运行  
    使用 `java -jar rocketmq-console-ng-1.0.1.jar --server.port=8080 --rocketmq.config.namesrvAddr=xxxx.xxx.xxx.xxx:9876` 命令启动，这里注意需要设置两个参数：  
    `--server.port` 为运行的这个web应用的端口，如果不设置的话默认为8080；  
    `--rocketmq.config.namesrvAddr` 为RocketMQ命名服务地址，若NameServer为集群则使用英文 ; 分割
 *  访问  
    浏览器访问 `xxx.xxx.xxx.xxx:8080` 进入控制台界面，效果如下  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70 3]

## SpringBoot整合RocketMQ ##

在SpringBoot中整合RocketMQ主要用到 `rocketmq-spring-boot-starter` 组件，下面是详细整合过程。

*  引入组件`rocketmq-spring-boot-starter` 依赖

<dependency>
    	<groupId>org.apache.rocketmq</groupId>
    	<artifactId>rocketmq-spring-boot-starter</artifactId>
    	<version>2.1.0</version>
    </dependency>

*  修改application.yml，添加RocketMQ相关配置

rocketmq:
      name-server: 192.168.100.43:9876;192.168.100.44:9876
      producer:
        group: test-group
        send-message-timeout: 3000

如果是集群，多个name-server使用英文 ; 分割。

*  编写消息生产者 `MessageProduce`

/** * Description: * rocketMQ消息发送方法 * @author javadaily */
    @Component
    public class MessageProduce { 
    
        @Autowired
        private RocketMQTemplate rocketMQTemplate;
    
        /** * 发送消息 * @param topic 主题 * @param message 消息体 */
        public void sendMessage(String topic,String message){ 
            this.rocketMQTemplate.convertAndSend(topic,message);
        }
    }

使用RocketMQTemplate发送消息

*  编写消息消费者 `MessageConsumer`

@Slf4j
    @Component
    @RocketMQMessageListener(
            topic = "test-topic",
            consumerGroup = "test-group",
            selectorExpression = "*"
    )
    public class MessageConsumer implements RocketMQListener<String> { 
        @Override
        public void onMessage(String message) { 
            log.info("received message is {}", message);
        }
    }

消费者只需要继承RocketMQListener类即可，主要关注实现类上的 `@RocketMQMessageListener` 注解，配置的 `topic` 和 `consumerGroup` 需要跟消息生产者的配置保持一致。

*  编写单元测试发送消息

@RunWith(SpringRunner.class)
    @SpringBootTest
    public class MessageProduceTest { 
        @Autowired
        private MessageProduce messageProduce;
    
        @Test
        public void testSendMessage() { 
            messageProduce.sendMessage("test-topic","Hello,JAVA日知录");
        }
    }

*  测试  
    先启动springboot应用，再执行测试用例。  
    ![在这里插入图片描述][20200331163054379.png]

如果这篇文章对你有用，麻烦扫描下面公众号二维码加个关注。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70 4]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70]: /images/20230528/314bad678ffe4772ae70af014b47b6cf.png
[20200331162953503.png]: /images/20230528/9c55b170c48a45d0a49e2b04b82439ea.png
[20200331163000124.png]: /images/20230528/86de10e8201d4e4882aedf9ac3d9def9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70 1]: /images/20230528/7dba452b7ea54d86981ad0a74195f512.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70 2]: /images/20230528/92bdda41a2d847c1ab36fec6e4dbb29c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70 3]: /images/20230528/d05c8a6a8f1b4d15b9ae2f8aa1e14d5f.png
[20200331163054379.png]: /images/20230528/f519444247ff4909aec4e6e84ab48914.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW56aGFuZzEx_size_16_color_FFFFFF_t_70 4]: /images/20230528/0ea0c452aa68496dad5c60deee4e816b.png