coder4/rocketmq

RocketMQ Docker镜像文档

镜像概述

本镜像基于RocketMQ 4.5.2版本构建，提供了快速部署RocketMQ消息队列系统的能力。支持NameServer服务及Broker节点的多种部署模式，适用于开发测试与生产环境，可通过环境变量和挂载卷灵活配置系统参数与数据存储。

核心功能与特性

• 多组件支持：包含NameServer和Broker核心组件，满足消息队列基础架构需求
• 灵活部署模式：支持单节点Broker、多主模式（无从节点）等部署架构
• 资源配置：可通过环境变量设置JVM最大堆大小，优化性能
• 数据持久化：支持日志和数据目录挂载，确保数据持久化与可管理性
• 端口映射：预设必要端口映射，满足服务通信需求

使用场景

• 开发测试环境：快速搭建单节点RocketMQ集群，验证消息队列功能
• 生产环境：部署多主模式Broker，构建高可用、高吞吐量的消息系统
• 分布式系统集成：作为异步通信、系统解耦、流量削峰的核心组件

使用方法

1. 运行NameServer

NameServer是RocketMQ的路由注册中心，负责 Broker 节点的注册与路由信息管理。

bash
# 设置JVM最大堆内存为8GB（8589934592字节）
docker run \
    --env MAX_POSSIBLE_HEAP=8589934592 \
    --volume "your_path_log":/root/logs \  # 挂载日志目录（替换your_path_log为实际路径）
    --volume "your_path_store":/root/store \  # 挂载数据存储目录（替换your_path_store为实际路径）
    -p 9876:9876 \  # 暴露NameServer默认端口
    coder4/rocketmq:4.5.2 sh mqnamesrv 

环境变量说明：

• MAX_POSSIBLE_HEAP：JVM最大堆内存大小（字节），示例中为8GB

2. 运行单节点模式Broker

适用于开发测试场景，部署单个Broker节点。

bash
# 设置JVM最大堆内存为8GB
docker run \
    --env MAX_POSSIBLE_HEAP=8589934592 \
    --volume "your_path_log":/root/logs \  # 挂载日志目录
    --volume "your_path_store":/root/store \  # 挂载数据存储目录
    -p 10911:10911 \  # Broker对外服务端口
    -p 10909:10909 \  # Broker内部通信端口
    coder4/rocketmq:4.5.2 sh mqbroker

3. 运行多主模式Broker（无从节点）

适用于生产环境，部署多个Master节点实现高可用。需确保各Broker节点可相互通信，并注册到同一NameServer。

Broker1部署

bash
docker run \
    --env MM_BROKER_ID=broker1 \  # Broker唯一标识
    --env MM_BROKER_IP=192.168.0.1 \  # Broker节点IP（需替换为实际IP）
    --env NAMESRV_ADDR="x.x.x.x:9876" \  # NameServer地址（替换x.x.x.x为实际地址）
    --volume "your_path_log":/root/logs \
    --volume "your_path_store":/root/store \
    -p 10911:10911 \
    -p 10909:10909 \
    coder4/rocketmq:4.5.2 sh mqbroker -c ../conf/broker.conf

Broker2部署

bash
docker run \
    --env MM_BROKER_ID=broker2 \  # 与其他Broker保持唯一
    --env MM_BROKER_IP=192.168.0.2 \  # 替换为实际IP
    --env NAMESRV_ADDR="x.x.x.x:9876" \  # 与Broker1使用同一NameServer
    --volume "your_path_log":/root/logs \
    --volume "your_path_store":/root/store \
    -p 10911:10911 \
    -p 10909:10909 \
    coder4/rocketmq:4.5.2 sh mqbroker -c ../conf/broker.conf

环境变量说明：

• MM_BROKER_ID：多主模式下Broker的唯一ID，需确保集群内唯一
• MM_BROKER_IP：Broker节点的IP地址，用于集群内通信
• NAMESRV_ADDR：NameServer服务地址，格式为IP:端口