lsszzqy/rocketmq

RocketMQ 自定义JVM参数镜像文档

镜像概述

本镜像基于官方 apacherocketmq/rocketmq:4.5.0 构建，主要修改了 runbroker.sh 和 runserver.sh 脚本中的默认JVM参数配置。原脚本中固定设置的 -Xms512m -Xmx512m -Xmn512m 参数已被注释，需用户在部署时通过环境变量手动指定JVM参数，以适应不同的资源需求场景。

核心功能与特性

• 基于官方稳定版本：保留 RocketMQ 4.5.0 的核心功能与稳定性
• JVM参数自定义：移除默认固定JVM内存配置，支持通过环境变量灵活设置 -Xms、-Xmx、-Xmn 等参数
• 兼容标准部署：支持通过 docker run 命令或 docker-compose 编排工具部署，保持与官方镜像一致的使用体验

使用场景与适用范围

适用于需要根据实际服务器资源调整 RocketMQ 内存配置的场景，例如：

• 生产环境中需要根据服务器内存大小优化JVM参数
• 开发/测试环境中需要灵活调整资源占用
• 对 RocketMQ 性能有特定优化需求的场景

使用方法与配置说明

环境变量说明

Docker Compose 部署示例

以下是包含 NameServer 和 Broker 服务的完整 docker-compose.yml 配置示例：

yaml
version: "3.5"
services:
  rocketmqsrv:
    image: lsszzqy/rocketmq:4.5.0-zdy
    container_name: rocketmqsrv
    hostname: rocketmqsrv
    privileged: true
    user: root
    ports:
      - 9876:9876  # NameServer默认端口
    volumes:
      - /etc/localtime:/etc/localtime:ro  # 同步主机时间
      - /etc/timezone:/etc/timezone:ro
      - ./data:/root  # 数据持久化目录
      - ./conf/namesrv.properties:/home/rocketmq/rocketmq-4.5.0/namesrv.properties  # 挂载NameServer配置文件
    environment:
        JAVA_OPT_EXT: "-server -Xms1024m -Xmx1024m -Xmn1024m"  # NameServer JVM参数
    command: sh mqnamesrv -c /home/rocketmq/rocketmq-4.5.0/namesrv.properties
    restart: always
    tty: true

  rocketmqbroker:
    image: lsszzqy/rocketmq:4.5.0-zdy
    container_name: rocketmqbroker
    hostname: rocketmqbroker
    privileged: true
    user: root
    ports:
      - 10909:10909  # Broker内部通信端口
      - 10911:10911  # 客户端通信端口
      - 10912:10912  # 高可用端口
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
      - ./conf/broker.conf:/home/rocketmq/rocketmq-4.5.0/conf/broker.conf  # 挂载Broker配置文件
      - ./data:/root
    environment:
        JAVA_OPT_EXT: "-server -Xms2048m -Xmx2048m -Xmn1024m"  # Broker JVM参数
    command: sh mqbroker -n rocketmqsrv:9876 -c /home/rocketmq/rocketmq-4.5.0/conf/broker.conf autoCreateTopicEnable=true
    depends_on:
      - rocketmqsrv  # 依赖NameServer服务
    restart: always
    tty: true

其他版本说明

对于 rocketmq:server-4.3.1-0.75 和 rocketmq:broker-4.3.1-0.75 版本，启动后内存会自动使用容器分配内存的3/4容量，无需手动指定JVM参数。