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
+111
View File
@@ -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` 镜像,单 NameServer + 单 Broker(ASYNC_MASTER)+ Dashboard 2.1.0
- 只编排 namesrv、broker、dashboard,不含 5.x 的 proxy 组件;如需 gRPC 协议接入,可在 `docker-compose.yml` 中按 5.x 官方示例自行补 `sh mqproxy`
- 端口与 `deploy/rocketmq-4.9.7-standalone` 完全相同、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 rmq5broker # broker 启动日志
docker exec rmq5namesrv sh mqadmin clusterList -n rmqnamesrv:9876 # 查看集群节点
```
### 示例
![demo](demo.png)
Binary file not shown.

After

Width:  |  Height:  |  Size: 128 KiB

@@ -0,0 +1,57 @@
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
broker:
image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
container_name: rmq5broker
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:
- ./master/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
- ./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
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.82
environment:
- JAVA_OPTS= -Xms256M -Xmx512M -Xmn128M -Drocketmq.namesrv.addr=rmqnamesrv:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false
@@ -0,0 +1,26 @@
namesrvAddr=rmqnamesrv:9876
brokerIP1=172.21.0.81
brokerName=rmqbroker
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
+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 运行,提前建好数据目录避免挂载后权限问题
mkdir -p ./master/store
docker-compose -f docker-compose.yml -p rocketmq up -d