feat: 新增 rocketmq 5.5.0 三种部署形态(standalone/1m2s/2m)

This commit is contained in:
2026-10-24 21:09:58 +08:00
parent d44587ff43
commit 8c3b8eafd9
21 changed files with 756 additions and 0 deletions
@@ -0,0 +1,111 @@
# RocketMQ 主从版
https://rocketmq.apache.org/zh/docs/5.x/02quickstart/01quickstart
### 部署方式
```shell
sh startup.sh
```
- 使用 `registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0` 镜像,1 个 NameServer + 3 个 Broker(`rmqbroker1` ASYNC_MASTER、`rmqbroker2` SLAVE id=1、`rmqbroker3` SLAVE id=2)+ Dashboard 2.1.0
- 只编排 namesrv、broker、dashboard,不含 5.x 的 proxy 组件;如需 gRPC 协议接入,可在 `docker-compose.yml` 中按 5.x 官方示例自行补 `sh mqproxy`
- 端口与 `deploy/rocketmq-4.9.7-cluster-1m2s` 完全相同、compose 项目名同为 `rocketmq`,同一台机器上只能启动其中一个
- 容器内目录按 `apache/rocketmq:5.5.0` 惯例假定为 `/home/rocketmq/rocketmq-5.5.0`;如实际不符(`docker run --rm --entrypoint ls <镜像> /home/rocketmq` 可查看),需同步修改 `docker-compose.yml` 的挂载路径与 `broker.conf` 的 `storePath*`
### Maven依赖
```xml
<dependency>
<groupId>org.apache.rocketmq</groupId>
<artifactId>rocketmq-client</artifactId>
<version>5.5.0</version>
</dependency>
```
### 生产者 官方示例
```java
import org.apache.rocketmq.client.producer.DefaultMQProducer;
import org.apache.rocketmq.client.producer.SendResult;
import org.apache.rocketmq.common.message.Message;
public class ProducerExample {
public static void main(String[] args) throws Exception {
// 创建生产者实例,并设置生产者组名
DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
// 设置 Name Server 地址,此处为示例,实际使用时请替换为真实的 Name Server 地址
producer.setNamesrvAddr("localhost:9876");
producer.start();
try {
// 创建消息实例,指定 topic、Tag和消息体
Message msg = new Message("TestTopic", "TagA", ("Hello RocketMQ").getBytes());
// 发送消息并获取发送结果
SendResult sendResult = producer.send(msg);
System.out.println("Message sent: " + new String(msg.getBody()));
System.out.println("Send result: " + sendResult);
} catch (Exception e) {
e.printStackTrace();
System.out.println("Message sending failed.");
} finally {
// 关闭生产者
producer.shutdown();
}
}
}
```
### 消费者 官方示例
```java
import org.apache.rocketmq.client.consumer.DefaultMQPushConsumer;
import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyContext;
import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyStatus;
import org.apache.rocketmq.client.consumer.listener.MessageListenerConcurrently;
import org.apache.rocketmq.common.message.MessageExt;
import java.util.List;
public class ConsumerExample {
public static void main(String[] args) throws Exception {
// 创建消费者实例,并设置消费者组名
DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name");
// 设置 Name Server 地址,此处为示例,实际使用时请替换为真实的 Name Server 地址
consumer.setNamesrvAddr("localhost:9876");
// 订阅指定的主题和标签(* 表示所有标签)
consumer.subscribe("TestTopic", "*");
// 注册消息监听器
consumer.registerMessageListener(new MessageListenerConcurrently() {
@Override
public ConsumeConcurrentlyStatus consumeMessage(List<MessageExt> msgs, ConsumeConcurrentlyContext context) {
for (MessageExt msg : msgs) {
System.out.println("Received message: " + new String(msg.getBody()));
}
return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
}
});
// 启动消费者
consumer.start();
System.out.println("Consumer started.");
}
}
```
### 访问地址
访问地址:http://127.0.0.1:8080(Dashboard 2.1.0)
### 验证
```shell
docker logs -f rmq5broker1 # broker 启动日志
docker exec rmq5namesrv sh mqadmin clusterList -n rmqnamesrv:9876 # 查看集群节点(应有 rmqbroker1/2/3)
```
### 示例
![demo](demo.png)
@@ -0,0 +1,26 @@
namesrvAddr=rmqnamesrv:9876
brokerIP1=172.21.0.81
brokerName=rmqbroker1
brokerClusterName=rmqbroker
brokerId=0
autoCreateTopicEnable=false
autoCreateSubscriptionGroup=true
rejectTransactionMessage=false
fetchNamesrvAddrByAddressServer=false
storePathRootDir=/home/rocketmq/rocketmq-5.5.0/store
storePathCommitLog=/home/rocketmq/rocketmq-5.5.0/store/commitlog
flushIntervalCommitLog=1000
flushCommitLogTimed=false
deleteWhen=04
fileReservedTime=72
maxTransferBytesOnMessageInMemory=262144
maxTransferCountOnMessageInMemory=32
maxTransferBytesOnMessageInDisk=65536
maxTransferCountOnMessageInDisk=8
accessMessageInMemoryMaxRatio=40
messageIndexEnable=true
storePathMessageIndex=/home/rocketmq/rocketmq-5.5.0/store/index
haMasterAddress=
brokerRole=ASYNC_MASTER
flushDiskType=ASYNC_FLUSH
cleanFileForciblyEnable=true
@@ -0,0 +1,26 @@
namesrvAddr=rmqnamesrv:9876
brokerIP1=172.21.0.82
brokerName=rmqbroker2
brokerClusterName=rmqbroker
brokerId=1
autoCreateTopicEnable=false
autoCreateSubscriptionGroup=true
rejectTransactionMessage=false
fetchNamesrvAddrByAddressServer=false
storePathRootDir=/home/rocketmq/rocketmq-5.5.0/store
storePathCommitLog=/home/rocketmq/rocketmq-5.5.0/store/commitlog
flushIntervalCommitLog=1000
flushCommitLogTimed=false
deleteWhen=04
fileReservedTime=72
maxTransferBytesOnMessageInMemory=262144
maxTransferCountOnMessageInMemory=32
maxTransferBytesOnMessageInDisk=65536
maxTransferCountOnMessageInDisk=8
accessMessageInMemoryMaxRatio=40
messageIndexEnable=true
storePathMessageIndex=/home/rocketmq/rocketmq-5.5.0/store/index
haMasterAddress=
brokerRole=SLAVE
flushDiskType=ASYNC_FLUSH
cleanFileForciblyEnable=true
@@ -0,0 +1,26 @@
namesrvAddr=rmqnamesrv:9876
brokerIP1=172.21.0.83
brokerName=rmqbroker3
brokerClusterName=rmqbroker
brokerId=2
autoCreateTopicEnable=false
autoCreateSubscriptionGroup=true
rejectTransactionMessage=false
fetchNamesrvAddrByAddressServer=false
storePathRootDir=/home/rocketmq/rocketmq-5.5.0/store
storePathCommitLog=/home/rocketmq/rocketmq-5.5.0/store/commitlog
flushIntervalCommitLog=1000
flushCommitLogTimed=false
deleteWhen=04
fileReservedTime=72
maxTransferBytesOnMessageInMemory=262144
maxTransferCountOnMessageInMemory=32
maxTransferBytesOnMessageInDisk=65536
maxTransferCountOnMessageInDisk=8
accessMessageInMemoryMaxRatio=40
messageIndexEnable=true
storePathMessageIndex=/home/rocketmq/rocketmq-5.5.0/store/index
haMasterAddress=
brokerRole=SLAVE
flushDiskType=ASYNC_FLUSH
cleanFileForciblyEnable=true
Binary file not shown.

After

Width:  |  Height:  |  Size: 128 KiB

@@ -0,0 +1,97 @@
version: '3.8'
# 网桥 -> 方便相互通讯(172.21 段,避免与 rocketmq-4.9.7 的 172.20 冲突)
networks:
rocketmq:
ipam:
driver: default
config:
- subnet: "172.21.0.0/24"
services:
namesrv:
image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
container_name: rmq5namesrv
restart: unless-stopped
ports:
- "9876:9876"
environment:
- JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
networks:
rocketmq:
ipv4_address: 172.21.0.80
command: sh mqnamesrv
broker1:
image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
container_name: rmq5broker1
restart: unless-stopped
ports:
- "10909:10909"
- "10911:10911"
- "10912:10912"
environment:
- NAMESRV_ADDR=rmqnamesrv:9876
- ROCKETMQ_HOME=/home/rocketmq/rocketmq-5.5.0
- JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
volumes:
- ./broker-master/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
- ./broker-master/store:/home/rocketmq/rocketmq-5.5.0/store
depends_on:
- namesrv
networks:
rocketmq:
ipv4_address: 172.21.0.81
command: sh mqbroker -c /home/rocketmq/rocketmq-5.5.0/conf/broker.conf
broker2:
image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
container_name: rmq5broker2
restart: unless-stopped
ports:
- "10809:10909"
- "10811:10911"
- "10812:10912"
environment:
- NAMESRV_ADDR=rmqnamesrv:9876
- JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
volumes:
- ./broker-slave1/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
- ./broker-slave1/store:/home/rocketmq/rocketmq-5.5.0/store
depends_on:
- namesrv
networks:
rocketmq:
ipv4_address: 172.21.0.82
command: sh mqbroker -c /home/rocketmq/rocketmq-5.5.0/conf/broker.conf
broker3:
image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
container_name: rmq5broker3
restart: unless-stopped
ports:
- "10709:10909"
- "10711:10911"
- "10712:10912"
environment:
- NAMESRV_ADDR=rmqnamesrv:9876
- JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
volumes:
- ./broker-slave2/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
- ./broker-slave2/store:/home/rocketmq/rocketmq-5.5.0/store
depends_on:
- namesrv
networks:
rocketmq:
ipv4_address: 172.21.0.83
command: sh mqbroker -c /home/rocketmq/rocketmq-5.5.0/conf/broker.conf
rmqdashboard:
image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apacherocketmq-rocketmq-dashboard-2.1.0
container_name: rmq5dashboard
ports:
- "8080:8082"
restart: always
depends_on:
- namesrv
networks:
rocketmq:
ipv4_address: 172.21.0.84
environment:
- JAVA_OPTS= -Xms256M -Xmx512M -Xmn128M -Drocketmq.namesrv.addr=rmqnamesrv:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false
+5
View File
@@ -0,0 +1,5 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
docker-compose -f docker-compose.yml -p rocketmq down
+7
View File
@@ -0,0 +1,7 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
# 首次启动时 broker 以 root 运行,提前建好各 broker 的数据目录避免挂载后权限问题
mkdir -p ./broker-master/store ./broker-slave1/store ./broker-slave2/store
docker-compose -f docker-compose.yml -p rocketmq up -d