Files
kenaito-lab/deploy/rocketmq-5.5.0-cluster-1m2s/README.md
T

112 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)