573419235/rocketmq

docker-rocketmq 镜像文档

镜像概述

基于Apache RocketMQ的Docker镜像，提供便捷的RocketMQ消息队列服务部署方案，包含namesvr（名称服务器）和broker（消息代理）核心组件，支持自定义配置与数据持久化，简化分布式消息系统的搭建流程。

核心功能与特性

• 集成RocketMQ核心服务：支持独立运行namesvr和broker组件
• 标准化文件路径：预设日志、数据存储和配置文件目录，便于管理
• 可配置JVM参数：通过环境变量自定义堆内存大小等JVM参数
• 轻量级部署：无需手动安装RocketMQ，直接通过Docker命令启动服务

使用场景

适用于需要消息队列支持的分布式系统、微服务架构、异步通信场景，如订单处理、日志收集、系统解耦、流量削峰等业务场景。

使用方法

运行namesvr（名称服务器）

执行以下命令启动RocketMQ名称服务器：

shell
docker run -d docker.xuanyuan.run/573419235/rocketmq sh mqnamesvr

运行broker（消息代理）

执行以下命令启动RocketMQ消息代理：

shell
docker run -d docker.xuanyuan.run/573419235/rocketmq sh mqbroker

文件路径说明

容器内关键文件路径如下：

• 日志文件：/root/logs - 存储RocketMQ运行日志
• 数据存储：/root/store - 存储消息数据及索引
• 配置文件：/opt/rocketmq/conf - 包含RocketMQ核心配置文件

环境变量配置

可通过环境变量自定义JVM参数，常用配置项：

• JAVA_OPT_Xms=4g：初始堆内存大小（默认4g）
• JAVA_OPT_Xmx=4g：最大堆内存大小（默认4g）
• JAVA_OPT_Xmn=2g：新生代堆内存大小（默认2g）

示例：自定义JVM参数启动broker

shell
docker run -d -e JAVA_OPT_Xms=2g -e JAVA_OPT_Xmx=2g -e JAVA_OPT_Xmn=1g docker.xuanyuan.run/573419235/rocketmq sh mqbroker

数据持久化配置

为避免容器重启导致数据丢失，建议将日志和存储目录挂载到宿主机：

shell
# 挂载日志目录运行namesvr
docker run -d -v /宿主机路径/logs:/root/logs docker.xuanyuan.run/573419235/rocketmq sh mqnamesvr

# 挂载日志和存储目录运行broker
docker run -d -v /宿主机路径/logs:/root/logs -v /宿主机路径/store:/root/store docker.xuanyuan.run/573419235/rocketmq sh mqbroker

Docker Compose部署示例

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  namesrv:
    image: docker.xuanyuan.run/573419235/rocketmq
    command: sh mqnamesvr
    volumes:
      - ./rocketmq/logs:/root/logs
    ports:
      - "9876:9876"  # namesvr默认端口

  broker:
    image: docker.xuanyuan.run/573419235/rocketmq
    command: sh mqbroker
    volumes:
      - ./rocketmq/logs:/root/logs
      - ./rocketmq/store:/root/store
    environment:
      - JAVA_OPT_Xms=2g
      - JAVA_OPT_Xmx=2g
      - JAVA_OPT_Xmn=1g
    depends_on:
      - namesrv
    ports:
      - "10911:10911"  # broker默认端口

启动服务：docker-compose up -d