手把手教你从 0 到 1 搭建一套 RocketMQ 集群

大家好，手把手教我是搭建君哥。今天来分享怎样搭建 RocketMQ 集群。手把手教

本文搭建集群使用的搭建环境是 2 个云主机，架构如下：

在 47.xx.xx.xx 和 39.xx.xx.xx 上分别部署一个 Name Server 和 Broker 主节点，手把手教这里不搭建从节点。搭建也就是手把手教官网介绍的 2m-noslave 构建模式。

注意：官网有三种配置模式：2m-2s-sync、搭建2m-2s-async、手把手教2m-noslave。搭建这三种配置都是手把手教使用异步刷盘策略：ASYNC_FLUSH。

集群搭建成功后，搭建Broker 会向 Name Server 注册 Topic 路由信息，手把手教Producer 和 Consumer 则从 Name Server 获取路由信息，搭建然后 Producer 根据路由信息向 Broker 发送消息，手把手教Consumer 则根据路由信息从 Broker 拉取消息。

1 准备工作

要安装 RocketMQ，首先需要在云主机上安装 Java 环境，Maven 环境。这里就不做详细介绍了。

Java 和 Maven 环境安装好以后，从官网下载最新版本，服务器托管地址如下：

https://dlcdn.apache.org/rocketmq/4.9.4/rocketmq-all-4.9.4-bin-release.zip

下载完成后，进行解压和编译，执行如下命令：

> unzip rocketmq-all-4.9.4-source-release.zip

> cd rocketmq-all-4.9.4-source-release/

> mvn -Prelease-all -DskipTests clean install -U

> cd distribution/target/rocketmq-4.9.4/rocketmq-4.9.4

看到下图输出时，编译成功:

2 启动

2.1 启动 Name Server

因为我的云主机内存比较小，而 RocketMQ 默认启动 Name Server 需要的 JVM 堆内存默认是 4g，所以需要修改默认堆内存。修改文件为：

rocketmq-all-4.9.4-source-release/distribution/target/rocketmq-4.9.4/rocketmq-4.9.4/bin/runserver.sh

修改后的配置如下：

JAVA_OPT="${ JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"

修改完成后，执行下面命令：

nohup sh bin/mqnamesrv &

启动成功后，nohup.out 文件中打印如下日志：

The Name Server boot success. serializeType=JSON

搭建好一台机器后，用同样的方式搭建第二台机器。

2.2 启动 Broker

同样，RocketMQ 启动 Broker 需要的 JVM 堆内存默认是 8g，所以需要修改堆内存。修改文件为：

rocketmq-all-4.9.4-source-release/distribution/target/rocketmq-4.9.4/rocketmq-4.9.4/bin/runbroker.sh

修改后的配置如下：

JAVA_OPT="${ JAVA_OPT} -server -Xms512m -Xmx512m"

创建 conf.properties 文件，内容如下：

brokerClusterName = MyTestCluster

brokerName = broker-a

brokerId = 0

deleteWhen = 04

fileReservedTime = 48

brokerRole = ASYNC_MASTER

flushDiskType = ASYNC_FLUSH

namesrvAddr=127.0.0.1:9876;47.xx.xx.xx:9876

配置好后，启动 broker-a 节点，启动 命令如下：

nohup bash bin/mqbroker -c conf/broker.properties &

Broker 启动成功后，Name Server 的日志如下图：

用同样的网站模板方式启动 broker-b，conf.properties 文件配置如下：

#集群名称

brokerClusterName = MyTestCluster

#broker名称

brokerName = broker-b

brokerId = 0

#删除消息存储过期文件的时间为凌晨4点

deleteWhen = 04

#未发生更新的消息存储文件的保留时长为48小时，48小时后过期，将会被删除

fileReservedTime = 48

brokerRole = ASYNC_MASTER

flushDiskType = ASYNC_FLUSH

namesrvAddr=127.0.0.1:9876;xx.xx.xx.xx:9876

启动成功后，执行 mqadmin 命令查看集群信息：

[root@rocketmq-4.9.4]# ./bin/mqadmin topicList -n 127.0.0.1:9876

MyTestCluster

RMQ_SYS_TRANS_HALF_TOPIC

BenchmarkTest

OFFSET_MOVED_EVENT

iZ8vbfyc7hfzygtpgapblyZ

TBW102

SELF_TEST_TOPIC

DefaultCluster

iZ2ze4m2ri7irk6au5mbfgZ

SCHEDULE_TOPIC_XXXX

DefaultCluster_REPLY_TOPIC

broker-b

broker-a

MyTestCluster_REPLY_TOPIC

注意：执行上面命令需要修改 bin/tools.sh 中的 JVM 参数，配置如下：

JAVA_OPT="${ JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=128m"

3 dashboard

3.1 安装

安装 dashboard，需要编译源代码，源码 github 地址如下：

https://github.com/apache/rocketmq-dashboard

下载之后，修改 application.yml 参数，我这里只修改了 Name Server 地址：

rocketmq:

config:

namesrvAddrs:

- 127.0.0.1:9876

- 47.xx.xx.xx:9876

然后执行 Maven 打包命令，打出 jar 包：

mvn clean package -Dmaven.test.skip=true

打好 jar 包后上传到服务器，执行下面命令启动：

java -jar rocketmq-dashboard-1.0.1-SNAPSHOT.jar

启动成功后，输出下图的日志：

3.2 测试

浏览器输入 http://39.xx.xx.xx:8080/ 界面如下:

使用下面命令创建一个 Topic，名字叫 MyTestTopic：

sh bin/mqadmin updateTopic -n 127.0.0.1:9876\;47.92.71.246:9876 -c MyTestCluster -t MyTestTopic

这是可以在界面上看到创建的 Topic，如下图:

使用命令发送一条消息：

[root@rocketmq-4.9.4]# sh bin/mqadmin sendMessage -n 127.0.0.1:9876 -t MyTestTopic -p hello test message

#Broker Name #QID #Send Result #MsgId

broker-a 1 SEND_OK 7F000001D3C3339097527B50D1740000

在界面上查看消息，如下图：

4 总结

这篇文章主要讲述了 RocketMQ 集群的搭建，希望能对大家理解 RocketMQ 有所帮助。