前言

由于个人学习测试需要，想要在debian11环境下，使用podman搭建一个简单的单节点rocketmq，搭建过程比较繁琐，所以记录下来留作后续参考。

由于对rocketmq镜像不熟悉，有些配置可能存在错误，会在后续有能力优化时继续更新此文档。

后续可能会补充podman-compose实现方式，目前是shell脚本启动。

正文

1. 准备镜像

<code># 2024-07-08 latest 版本 5.2.0, rocketmq 主程序，用它启动namesrv 和 broker

podman pull docker.io/apache/rocketmq

# 2024-07-08 latest，这是一个rocketmq的监控面板，可以通过浏览器页面监控rocketmq内容

podman pull docker.io/styletang/rocketmq-console-ng

2. 目录分配

.

├── broker

│ ├── conf -- 目录

│ │ └── broker.conf

│ ├── logs -- 目录

│ ├── run_broker.sh -- 启动脚本

│ └── store

├── console

│ └── run_console.sh -- 启动脚本

├── create_network.sh

├── python -- 测试目录

│ ├── client.py

│ └── rocketmq-client-cpp-2.0.0.amd64.deb

└── rocketmq

├── logs -- 目录

├── run_mq.sh -- 启动脚本

└── store -- 目录

1. 配置网络

最好给rocketmq创建一个单独的podman网络

create_network.sh

chmod +x create_network.sh && ./create_network.sh

#!/bin/bash

podman network create rocketmq

podman network ls

# NAME VERSION PLUGINS

# podman 0.4.0 ptp,portmap,firewall

# rocketmq 0.4.0 bridge,portmap,firewall,tuning

2. rocketmq (namesrv)

新建logs和store目录

run_mq.sh

chmod +x run_mq.sh && ./run_mq.sh

<code>#!/bin/bash

podman run -itd -p 0.0.0.0:9876:9876 --network rocketmq --name rmqnamesrv \

-v /root/rocketMq/rocketmq/logs:/root/logs \

-v /root/rocketMq/rocketmq/store:/root/store \

docker.io/apache/rocketmq:latest \

sh mqnamesrv

脚本中的/root/rocketMq/rocketmq/logs:/root/logs和/root/rocketMq/rocketmq/store:/root/store的配置有点问题，实际上，镜像中的日志和存储目录都在/home/rocketmq 目录下，具体优化还需要再研究下。

调试时，可以将上述命令中的 -itd 改为 -it, 这样就可以不在后台运行容器，直接将容器中的日志打印到终端。

查看后台日志的话：

# 查看全部日志

podman logs -f -t rmqnamesrv

# 跟踪查看，从最后一条开始跟踪

# podman logs -f -t --tail 1 rmqnamesrv

# 2024-07-08T13:44:14.963934731+08:00 OpenJDK 64-Bit Server VM warning: Using the DefNew young collector with the CMS collector is deprecated and will likely be removed in a future release

# 2024-07-08T13:44:14.963934731+08:00 OpenJDK 64-Bit Server VM warning: UseCMSCompactAtFullCollection is deprecated and will likely be removed in a future release.

# 2024-07-08T13:44:16.419453208+08:00 The Name Server boot success. serializeType=JSON, address 0.0.0.0:9876

端口号

netstat -ant|grep 9876

# tcp 0 0 0.0.0.0:9876 0.0.0.0:* LISTEN

3. broker

新建目录 conf、logs、store

在conf目录下，新建broker.conf，内容如下

<code># 所属集群名称，如果节点较多可以配置多个

brokerClusterName = DefaultCluster

#broker名称，master和slave使用相同的名称，表明他们的主从关系

brokerName = broker-a

#0表示Master，大于0表示不同的

slave brokerId = 0

#表示几点做消息删除动作，默认是凌晨4点

deleteWhen = 04

#在磁盘上保留消息的时长，单位是小时

fileReservedTime = 48

#有三个值：SYNC_MASTER，ASYNC_MASTER，SLAVE；同步和异步表示Master和Slave之间同步数据的机 制；

brokerRole = ASYNC_MASTER

#刷盘策略，取值为：ASYNC_FLUSH，SYNC_FLUSH表示同步刷盘和异步刷盘；SYNC_FLUSH消息写入磁盘后 才返回成功状态，ASYNC_FLUSH不需要；

flushDiskType = ASYNC_FLUSH

# !!! 这里要改成你的服务器的ip和实际的namesrv端口号

namesrvAddr = 192.168.11.126:9876

# 设置broker节点所在服务器的ip地址

# !!! 这里要改成你的服务器的ip

brokerIP1 = 192.168.11.126

#剩余磁盘比例

diskMaxUsedSpaceRatio=99

run_broker.sh

chmod +x run_broker.sh && ./run_broker.sh

#!/bin/bash

podman run -itd --name rmqbroker \

--network rocketmq \

-p 8080:8080 -p 8081:8081 \

-p 10911:10911 -p 10912:10912 -p 10909:10909 --privileged=true \

-v /root/rocketMq/broker/logs:/root/logs \

-v /root/rocketMq/broker/store:/root/store \

-v /root/rocketMq/broker/conf/broker.conf:/home/rocketmq/rocketmq-5.2.0/conf/broker.conf \

-e "NAMESRV_ADDR=192.168.11.126:9876" \

-e "MAX_POSSIBLE_HEAP=200000000" \

apache/rocketmq sh mqbroker --enable-proxy -c /home/rocketmq/rocketmq-5.2.0/conf/broker.conf

注意，-e "NAMESRV_ADDR=192.168.11.126:9876" \ 这个地方原来是 -e "NAMESRV_ADDR=rmqnamesrv:9876" \ 后来我发现在我搭建的环境中不太好用，改成了自己的server ip 后，莫名奇妙好用了 qwq

podman logs -f -t --tail 10 rmqbroker

# 2024-07-08T14:26:23.082541138+08:00 Mon Jul 08 06:26:23 UTC 2024 rocketmq-proxy startup successfully

4. console

run_console.sh

chmod +x run_console.sh && ./run_console.sh

<code>#!/bin/bash

podman run -itd -p 10100:8080 --name rmqconsole \

--network rocketmq \

-e "JAVA_OPTS=-Drocketmq.namesrv.addr=192.168.11.126:9876 \

-Dcom.rocketmq.sendMessageWithVIPChannel=false" \

styletang/rocketmq-console-ng

因为8080端口已经被broker占用了，所以直接按照参考中的Docker安装RocketMq，用10100端口 映射容器中的 8080

浏览器打开 http://192.168.11.126:10100/ (你服务器的ip:你配置的端口号)

5. 简单测试

这里，我用python简单测试了一下

首先，需要安装一个python3的库，安装之前需要先准备下前置环境

<code>wget https://github.com/apache/rocketmq-client-cpp/releases/download/2.0.0/rocketmq-client-cpp-2.0.0.amd64.deb

sudo dpkg -i rocketmq-client-cpp-2.0.0.amd64.deb

这个文件我打成了zip包，可以从这里下载:https://files.cnblogs.com/files/brian-sun/rocketmq-client-cpp-2.0.0.amd64.zip?t=1720423076&download=true, 下载到服务器后，用unzip解压，然后 dpkg -i 安装即可

然后安装pip包

pip install rocketmq-client-python

python3 示例

client.py

# -*- coding:utf-8 -*-

from rocketmq.client import Producer, Message, PushConsumer, ConsumeStatus

import time

def product_topic():

# 创建生产者

producer = Producer('PID_TEST')

producer.set_name_server_address('0.0.0.0:9876')

producer.start()

# 创建消息

msg = Message('YOUR_TOPIC')

msg.set_keys('YOUR_KEY')

msg.set_tags('YOUR_TAG')

msg.set_body('Hello, RocketMQ!')

# 发送消息

result = producer.send_sync(msg)

print('Send Result: ', result.status, result.msg_id)

# 停止生产者

producer.shutdown()

need_stop=0

# 消费回调函数

def callback(msg):

print('Received message: ', msg.body)

global need_stop

need_stop = 1

return ConsumeStatus.CONSUME_SUCCESS

def consume_topic():

# 创建消费者

consumer = PushConsumer('CID_TEST')

consumer.set_name_server_address('0.0.0.0:9876')

consumer.subscribe('YOUR_TOPIC', callback)

consumer.start()

# 保持消费者运行

global need_stop

while True:

time.sleep(60) # 保持消费者运行

if need_stop == 1:

break

# 停止消费者

consumer.shutdown()

if __name__ == "__main__":

product_topic()

consume_topic()

python3 client.py

# Send Result: SendStatus.OK 7F000101EDB61E27498727597E960000

# Received message: b'Hello, RocketMQ!'

参考

[1]. Apache RocketMQ

[2]. Docker安装RocketMq

[3]. https://gitee.com/AI-Mart/rocketmq-client-python

[4]. docker 上部署RocketMQ

[5]. RocketMQ_详细配置与使用详解

附录

chatgpt 介绍rocketmq

Apache RocketMQ 是一个分布式消息中间件，其核心组件包括 NameServer、Broker 和 Proxy。了解这些组件的功能和配置有助于更好地使用 RocketMQ。

NameServer

NameServer 是 RocketMQ 的目录服务，主要负责以下功能：

1. 管理Topic路由信息：NameServer 存储 Topic 到 Broker 的映射信息。
2. 心跳检测：Broker 定期向 NameServer 发送心跳包，以维持连接和更新路由信息。
3. 服务发现：生产者和消费者通过 NameServer 发现 Broker 位置和路由信息。

启动 NameServer

在启动 NameServer 时，可以使用如下命令：

nohup sh mqnamesrv &

Broker

Broker 是 RocketMQ 的消息存储和传输核心，负责以下功能：

1. 消息存储：将生产者发送的消息持久化存储。
2. 消息传输：将存储的消息传递给消费者。
3. 负载均衡：支持消息的分片存储和消费。

Broker 分为两种角色：

• Master：主 Broker，负责消息存储和提供读/写服务。
• Slave：从 Broker，通过同步 Master 的消息存储来提供高可用性，但通常只提供读服务。

配置和启动 Broker

首先，创建 Broker 配置文件 broker.conf：

# broker.conf 示例

brokerClusterName=DefaultCluster

brokerName=broker-a

brokerId=0 # 0 表示 Master，>0 表示 Slave

namesrvAddr=127.0.0.1:9876

defaultTopicQueueNums=4

autoCreateTopicEnable=true

然后，使用以下命令启动 Broker：

nohup sh mqbroker -c path/to/broker.conf &

Proxy

Proxy（代理）通常用于将 RocketMQ 与其他协议或应用集成。通过 Proxy，可以在不修改客户端代码的情况下将 RocketMQ 集成到现有系统中。

RocketMQ 提供了多种 Proxy 解决方案，例如：

• HTTP Proxy：支持通过 HTTP 协议与 RocketMQ 进行通信。
• MQTT Proxy：支持通过 MQTT 协议与 RocketMQ 进行通信。

启动 HTTP Proxy

以下是一个启动 HTTP Proxy 的示例：

1. 首先，下载并解压 RocketMQ 的 HTTP Proxy 包。
2. 配置 proxy.conf 文件，内容如下：

# proxy.conf 示例

namesrvAddr=127.0.0.1:9876

listenPort=8080

3. 启动 HTTP Proxy：

<code>nohup java -jar rocketmq-proxy-http.jar -c path/to/proxy.conf &

总结

以下是 RocketMQ 各组件启动的简要步骤：

1. 启动 NameServer：

   nohup sh mqnamesrv &

2. 启动 Broker（创建 broker.conf 并启动）：

   nohup sh mqbroker -c path/to/broker.conf &

3. 启动 Proxy（以 HTTP Proxy 为例，创建 proxy.conf 并启动）：

   nohup java -jar rocketmq-proxy-http.jar -c path/to/proxy.conf &

通过这些步骤，您可以搭建一个完整的 RocketMQ 服务来支持消息的发布和订阅。根据您的应用需求，您还可以进行更多的配置和优化。