RocketMQ Docker镜像技术文档

一、镜像概述

本镜像为Apache RocketMQ的Docker化部署方案，支持x86与arm64架构，旨在简化RocketMQ消息队列的部署流程。通过预配置的环境与启动脚本，用户可快速搭建RocketMQ服务及管理控制台，适用于开发、测试及小型生产环境的消息队列需求。

二、核心功能与特性

2.1 架构支持

• 兼容x86_64与arm64架构，适配多种硬件环境。

2.2 部署简化

• 提供一键启动命令，无需手动配置RocketMQ核心组件（NameServer、Broker）。

2.3 灵活配置

• 支持自定义JVM参数（内存分配、元空间大小等）。
• 可配置时区、NameServer地址等关键参数。

2.4 数据持久化

• 通过卷挂载实现日志、存储数据及配置文件的持久化，避免容器重启数据丢失。

2.5 控制台集成

• 提供console标签镜像，支持RocketMQ管理控制台部署，可视化管理消息队列。

三、使用场景与适用范围

3.1 开发环境

• 快速搭建本地RocketMQ环境，用于消息队列功能开发与调试。

3.2 测试环境

• 部署轻量级RocketMQ集群，验证消息生产、消费、持久化等核心功能。

3.3 小型生产环境

• 适用于并发量较低、资源受限的场景，通过配置优化满足基础消息传递需求。

四、使用方法与配置说明

4.1 基础组件部署（RocketMQ服务）

4.1.1 简化启动命令（快速测试）

适用于无需持久化数据的临时环境：

bash
docker run --name rocketmq -h rocketmq -d --privileged \
  -e TZ='Asia/Shanghai' \
  -e JAVA_OPT_EXT='-Xms128m -Xmx128m -Xmn64m -XX:MetaspaceSize=32m -XX:MaxMetaspaceSize=32m' \
  -p ***:*** -p 9876:9876 \
  king019/rocketmq

4.1.2 国内加速部署（阿里云北京仓库）

通过阿里云容器仓库拉取镜像，提升国内访问速度，支持数据持久化：

bash
docker run --name rocketmq -h rocketmq -d --privileged \
  -v ~/soft/docker/data/maven/m2/repository:/root/.m2/repository \  # Maven仓库缓存（可选）
  -v ~/soft/docker/data/rocketmq/logs:/root/logs \  # 日志持久化
  -v ~/soft/docker/data/rocketmq/store:/root/store \  # 存储数据持久化
  -v ~/soft/docker/data/rocketmq:/root/soft \  # 配置文件持久化
  -e TZ='Asia/Shanghai' \
  -e JAVA_OPT_EXT='-Xms128m -Xmx128m -Xmn64m -XX:MetaspaceSize=32m -XX:MaxMetaspaceSize=32m' \
  -p ***:*** -p 9876:9876 \
  --security-opt seccomp:unconfined \  # 关闭seccomp限制，确保容器功能正常
  registry.cn-beijing.aliyuncs.com/king019/rocketmq

4.1.3 Docker Hub部署

从Docker Hub拉取镜像，适用于国际网络环境：

bash
docker run --name rocketmq -h rocketmq -d --privileged \
  -v ~/soft/docker/data/maven/m2/repository:/root/.m2/repository \
  -v ~/soft/docker/data/rocketmq/logs:/root/logs \
  -v ~/soft/docker/data/rocketmq/store:/root/store \
  -v ~/soft/docker/data/rocketmq:/root/soft \
  -e TZ='Asia/Shanghai' \
  -e JAVA_OPT_EXT='-Xms128m -Xmx128m -Xmn64m -XX:MetaspaceSize=32m -XX:MaxMetaspaceSize=32m' \
  -p ***:*** -p 9876:9876 \
  --security-opt seccomp:unconfined \
  king019/rocketmq

4.2 管理控制台部署

RocketMQ控制台（rocketmq-console）提供Web界面，支持消息查询、集群监控等功能，需与RocketMQ服务联动部署。

4.2.1 国内加速（阿里云北京仓库）

bash
docker run --name rocketmqng -h rocketmqng -d --privileged \
  -v ~/soft/docker/data/maven/m2/repository:/root/.m2/repository \
  -v ~/soft/docker/data/rocketmqng:/root/soft \
  --link rocketmq:rocketmq \  # 关联RocketMQ服务容器，实现网络互通
  -e TZ='Asia/Shanghai' \
  -e JAVA_OPTS='-Xms32m -Xmx32m -Xmn16m -Drocketmq.namesrv.addr=rocketmq:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false' \
  -p 9996:8080 \  # 控制台Web端口映射（宿主机9996 -> 容器8080）
  --security-opt seccomp:unconfined \
  registry.cn-beijing.aliyuncs.com/king019/rocketmq:console

4.2.2 Docker Hub部署

bash
docker run --name rocketmqng -h rocketmqng -d --privileged \
  -v ~/soft/docker/data/maven/m2/repository:/root/.m2/repository \
  -v ~/soft/docker/data/rocketmqng:/root/soft \
  --link rocketmq:rocketmq \
  -e TZ='Asia/Shanghai' \
  -e JAVA_OPTS='-Xms32m -Xmx32m -Xmn16m -Drocketmq.namesrv.addr=rocketmq:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false' \
  -p 9996:8080 \
  --security-opt seccomp:unconfined \
  king019/rocketmq:console

4.3 关键配置说明

4.3.1 环境变量

4.3.2 端口映射

4.3.3 卷挂载

4.4 Docker Compose部署示例

为简化服务与控制台的联动部署，可使用docker-compose.yml配置：

yaml
version: '3'
services:
  rocketmq:
    image: registry.cn-beijing.aliyuncs.com/king019/rocketmq  # 或 king019/rocketmq
    container_name: rocketmq
    hostname: rocketmq
    privileged: true
    security_opt:
      - seccomp:unconfined
    environment:
      - TZ=Asia/Shanghai
      - JAVA_OPT_EXT=-Xms128m -Xmx128m -Xmn64m -XX:MetaspaceSize=32m -XX:MaxMetaspaceSize=32m
    ports:
      - "9876:9876"
      - "***:***"
    volumes:
      - ~/soft/docker/data/rocketmq/logs:/root/logs
      - ~/soft/docker/data/rocketmq/store:/root/store
      - ~/soft/docker/data/rocketmq:/root/soft
      - ~/soft/docker/data/maven/m2/repository:/root/.m2/repository

  rocketmq-console:
    image: registry.cn-beijing.aliyuncs.com/king019/rocketmq:console  # 或 king019/rocketmq:console
    container_name: rocketmqng
    hostname: rocketmqng
    privileged: true
    security_opt:
      - seccomp:unconfined
    environment:
      - TZ=Asia/Shanghai
      - JAVA_OPTS=-Xms32m -Xmx32m -Xmn16m -Drocketmq.namesrv.addr=rocketmq:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false
    ports:
      - "9996:8080"
    volumes:
      - ~/soft/docker/data/rocketmqng:/root/soft
      - ~/soft/docker/data/maven/m2/repository:/root/.m2/repository
    depends_on:
      - rocketmq  # 确保RocketMQ服务先启动

启动命令：docker-compose up -d

五、注意事项

1. 权限配置：镜像使用--privileged和--security-opt seccomp:unconfined提升容器权限，确保底层资源访问（如文件系统、进程管理）正常，生产环境需评估安全风险。
2. 资源调整：JVM参数（JAVA_OPT_EXT、JAVA_OPTS）需根据宿主机资源调整，避免内存溢出或资源浪费。
3. 网络隔离：--link仅适用于单机部署，跨主机部署时需通过DNS或IP直接指定rocketmq.namesrv.addr。
4. 数据备份：持久化卷需定期备份，防止数据丢失。