快速入门一篇搞定RocketMq-实现微服务实战落地

1、RocketMq介绍

RocketMQ起源于阿里巴巴,最初是为了解决邮件系统的高可靠性和高性能而设计的。在2016年开源分布式消息中间件,并逐渐成为Apache顶级项目。现在是Apache的一个顶级项目,在阿里内部使用非常广泛,已经经过了"双11"这种万亿级的消息流转,性能稳定、高效。

官网地址:https://rocketmq.apache.org

快速开始文档:https://rocketmq.apache.org/docs/

Github地址:https://github.com/apache/rocketmq

2、RocketMq架构说明

RocketMQ的架构主要由Producer(消息生产者)、Consumer(消息消费者)、Broker(消息中转角色)和Name Server(网络路由角色)四个核心组件组成。Name Server负责维护Broker集群和Topic信息的路由中心,而Broker负责存储和传输消息。RocketMQ采用类似于Kafka的发布订阅模型,支持消息的顺序传输和事务性传输,同时可以配置不同的消息过滤规则和重试策略。

3、下载

查看微服务对应版本信息,下载相关版本。查看连接:https://github.com/alibaba/spring-cloud-alibaba/wiki/版本说明#2021x-分支

根据自己使用的Spring Cloud Alibaba Version选择对应的版本进行下载即可。这里下载4.4.0版本,下载地址:https://rocketmq.apache.org/download 下载成功后,为一个压缩包文件。把文件上传linux

使用命令解压zip文件并重命名文件夹命令:

sh 复制代码
unzip rocketmq-all-4.4.0-bin-release.zip -d rocketmq-4.4.0

解压成功后,如图:

4、启动

进入rocketmq-4.4.0目录,查看目录结构。

  • benchmark:性能测试相关的资源,如果想要了解RocketMQ的基准测试,可以考虑使用该压测工具。这个工具可以模拟生产者和消费者来测试RocketMQ集群的性能。
  • bin:里面是一些可执行文件,管理rocketmq服务
  • conf:里面就是一些配置文件,包括broker配置文件和logback配置文件
  • lib:所依赖的第三方jar包
4.1、启动Name Server命令
sh 复制代码
nohup sh bin/mqnamesrv -n 192.168.42.130:9876 > /dev/null 2>&1 &   # -n 后面IP为公网IP 必须指定其公网IP,不然会连接失败

启动成功后,默认启动日志在root目录下。可以查看启动日志信息:

sh 复制代码
tail -f ~/logs/rocketmqlogs/namesrv.log

输出下面信息启动成功:

也可以通过端口9876查看是否启动成功

sh 复制代码
ps -ef|grep 9876
4.2 启动Broker命令
sh 复制代码
nohup sh bin/mqbroker -n 192.168.42.130:9876 -c conf/broker.conf autoCreateTopicEnable=true >/dev/null 2>&1 & # -n 后面IP为公网IP 必须指定其公网IP,不然会连接失败

启动日志和启动Name Server日志在一个文件夹里面。查看启动日志信息:

sh 复制代码
tail -n 50 ~/logs/rocketmqlogs/broker.log

可以通过jps 查看启动信息如果能看到 NamesrvStartup 和 BrokerStartup 的话就表明单机版的 RocketMQ 启动成功了

4.3 Rocketmq服务关闭

关闭 MQ使用 bin 目录下的mqshutdown关闭服务

sh 复制代码
sh bin/mqshutdown namesrv #关闭namesrv服务

sh bin/mqshutdown broker #关闭broker服务 
4.4 启动脚本命令参数修改

在启动的过程中,如果服务器内存不足或者满足不了启动脚本里面的默认内存配置,启动的时候会启动报错。这是因为 apache-rocketmq/bin 目录下启动 nameserv 与 broker 的 runbroker.shrunserver.sh 文件中默认分配的内存太大,而系统实际内存却太小导致启动失败。解决办法就是修改runbroker.sh 和 runserver.sh里的内存配置,调小一些即可。

首先先备份一份runbroker.sh 和 runserver.sh文件,以防万一改错了。

sh 复制代码
cp runserver.sh runserver.sh.init

cp runbroker.sh runbroker.sh.init

修改:runserver.sh脚本文件,找到配置JVM参数的内容,把JVM配置参数调小:

sh 复制代码
JAVA_OPT="${JAVA_OPT} -server -Xms128m -Xmx128m -Xmn64m -XX:MetaspaceSize=64m -XX:MaxMetaspaceSize=160m"

修改:runbroker.sh脚本文件

sh 复制代码
JAVA_OPT="${JAVA_OPT} -server -Xms128m -Xmx128m -Xmn64m"

5、测试消息

通过上面的步骤,RocketMQ就启动成功了。接下来我们可以在服务器上面通过提供的测试脚本进行消息测试,验证RocketMq是否可以正常使用。

生产者发送消息:

sh 复制代码
export NAMESRV_ADDR=127.0.0.1:9876

sh bin/tools.sh org.apache.rocketmq.example.quickstart.Producer

通过输出内容,我们可以查看到消息发送成功了。下面运行监听脚本。测试消费者接受消息:

sh 复制代码
sh bin/tools.sh org.apache.rocketmq.example.quickstart.Consumer

成功拿到消息,可以说明RocketMq服务启动成功了。

6、监控程序rocketmq-console

6.1、配置rocketmq-console

rocketmq-externals是RocketMq的扩展插件项目。GitHub地址: https://github.com/apache/rocketmq-externals 之前rocketmq-console也在rocketmq-externals项目中。如今在GitHub apache/rocketmq-externals 项目下已经找不到 rocketmq-console模块了,官方已经从 apache/rocketmq-externals 独立出来并更名为 rocketmq-dashboard。 我们可以查看RocketMq官网配置仪表板说明 :RocketMQ 仪表板 |MQ (apache.org)

http 复制代码
https://rocketmq.apache.org/docs/deploymentOperations/04Dashboard/

根据提示可以下载到源码内容

Github下载地址:https://github.com/apache/rocketmq-dashboard

如果是 5.0 版本的直接拉取最新的代码

sh 复制代码
 git clone https://github.com/apache/rocketmq-dashboard.git  

releases标签中的rocketmq-dashboard-1.0.0版本试用于5.0版本以下的。

sh 复制代码
https://github.com/apache/rocketmq-dashboard/releases/tag/rocketmq-dashboard-1.0.0

下载成功后,使用IDEA打开修改配置,改一下namesrvAddr配置项即可,如果没有指定默认就是localhost:9876,如果namesrvAddr是集群环境,每个节点使用;隔开。本地测试运行,运行成功后打包发布的linux系统。

sh 复制代码
mvn clean package -Dmaven.test.skip=true #跳过测试
6.2 启动rocketmq-console

指定NameServer的地址和启动端口(8830)以及输出日志。由于内部不够,设置JVM参数启动,如果使用的linux系统内存足够可以忽略jvm参数。启动命令如下:

sh 复制代码
nohup java -jar -Xmx256M -Xms256M -XX:MaxMetaspaceSize=128M -XX:MetaspaceSize=128M rocketmq-dashboard-1.0.0.jar --server.port=8830 --rocketmq.config.namesrvAddr=127.0.0.1:9876 > /dev/null 2>&1 &

不指定JVM参数:

sh 复制代码
nohup java -jar  rocketmq-dashboard-1.0.0.jar --server.port=8830 --rocketmq.config.namesrvAddr=127.0.0.1:9876 > /dev/null 2>&1 &

执行成功后,查看启动日志:

sh 复制代码
 tail -f ~/logs/consolelogs/rocketmq-console.log 

启动成功。开放8830端口进行公网访问。

监控成功。可以在集群导航中查看当前节点部署节点。

也可以看到上面测试的数据输出:

7、微服务连接RockerMq

安全组需要开放10909、10911端口和9876端口,其中10909是VIP通道,10911是非VIP通道,9876是对外连接提供端口。不然连接发送会报错发送超时 sendDefaultImpl call timeout; nested exception is org.apache.rocketmq.remoting.exception.RemotingTooMuchRequestException: sendDefaultImpl call timeout

maven引入依赖

xml 复制代码
        <!--RocketMQ-->
        <dependency>
            <groupId>org.apache.rocketmq</groupId>
            <artifactId>rocketmq-spring-boot-starter</artifactId>
            <version>2.2.1</version>
        </dependency>

配置中心加入RocketMq配置

yaml 复制代码
rocketmq: # rocketMQ配置
  # name server地址
  name-server: 192.168.42.130:9876
  consumer:
    pull-batch-size: 10
    group: blog_message
  producer:
    group: blog_message
    # 发送消息超时时间,默认3000
    sendMessageTimeout: 10000
    # 发送消息失败重试次数,默认2
    retryTimesWhenSendFailed: 2
    # 异步消息重试此处,默认2
    retryTimesWhenSendAsyncFailed: 2
    # 消息最大长度,默认1024 * 1024 * 4(默认4M)
    maxMessageSize: 4096
    # 压缩消息阈值,默认4k(1024 * 4)
    compressMessageBodyThreshold: 4096
    # 是否在内部发送失败时重试另一个broker,默认false
    retryNextServer: false

编写RocketEnhanceConfig文件,解决不支持Java时间类型配置

java 复制代码
@Configuration
public class RocketEnhanceConfig {

    /**
     * 解决RocketMQ Jackson不支持Java时间类型配置
     * 源码参考:{@link org.apache.rocketmq.spring.autoconfigure}
     */
    @Bean
    @Primary
    public RocketMQMessageConverter enhanceRocketMQMessageConverter(){
        RocketMQMessageConverter converter = new RocketMQMessageConverter();
        CompositeMessageConverter compositeMessageConverter = (CompositeMessageConverter) converter.getMessageConverter();
        List<MessageConverter> messageConverterList = compositeMessageConverter.getConverters();
        for (MessageConverter messageConverter : messageConverterList) {
            if(messageConverter instanceof MappingJackson2MessageConverter){
                MappingJackson2MessageConverter jackson2MessageConverter = (MappingJackson2MessageConverter) messageConverter;
                ObjectMapper objectMapper = jackson2MessageConverter.getObjectMapper();
                objectMapper.registerModules(new JavaTimeModule());
            }
        }
        return converter;
    }
}
7.1 编写消息生产者:
java 复制代码
@Slf4j
@Service
public class RocketStorage implements IDataStorage {
  
		@Autowired(required = true)
    private RocketMQTemplate rocketMQTemplate;

		@Value("${rocketMq.topic:blog_notify_sow}")  
    private String topic;

    @Override
    public void store(String value, Integer type, Long timestamp) {
        String message = String.format("%s,%s,%s",value,type,timestamp);
        rocketMQTemplate.convertAndSend(topic,message); //发送数据
        log.info("RocketMQ|data sent,value: {}, type:{}, timestamp: {}", value, type, timestamp);
    }

    @Override
    public String getType() {
        return "RocketMQ";
    }
}

编写接口:IDataStorage

java 复制代码
/**
 * 数据发送到Mq里...
 */
public interface IDataStorage {

    /**
     * persistence data
     *
     * @param value 接收内容
     * @param type  数据类型
     * @param timestamp 当前时间(时间戳)
     */
    void store(String value,Integer type,Long timestamp);

    String getType();

}

在Controller中调用接口发送数据。

java 复制代码
@RestController
@RequestMapping("/dataStorage")
public class DataStorageController {

    @Autowired
    private IDataStorage dataStorage;

    @GetMapping
    public Response sendDataStorage(String value){
        dataStorage.store(value,type,System.currentTimeMillis());
        return Response.success();
    }

}
7.2 编写消息消费者

编写一个RocketMq消息监听类实现消息监听 RocketDataConsumer :

java 复制代码
@Service
@Slf4j
@RocketMQMessageListener(consumerGroup = "blog_message",topic = "blog_notify_sow")
public class RocketDataConsumer implements RocketMQListener {

    @PostConstruct
    public void post() {
        log.warn("***** RocketMq Data Consumer Activated");
    }

    @Autowired
    @Qualifier("dataPersist")
    private IDataPersist dataPersist;


    @Override
    public void onMessage(Object o) {
        log.info("RocketMq 接收到的信息 . . . . . .:{}",o);
        dataPersist.put(o.toString(),1,System.currentTimeMillis());
    }
}
7.3 测试消息发送和接收

启动项目,通过postman调用接口:

调用接口后,发现接口调用成功了。下面我们查看控制台消息消费者是否接收到消息。

通过上面输出的消息可以看到消息接收成功了。