gitsang/rocketmq

RocketMQ Docker镜像文档

镜像概述

本镜像基于OpenJDK 8u292构建，集成了RocketMQ分布式消息队列系统，提供便捷的部署与运行环境。支持多种部署模式，适用于分布式系统中的消息传递、服务解耦及异步通信场景。

核心功能与特性

• 多部署模式支持：提供单节点、DLedger模式（基于Raft协议的高可用模式）和集群部署方案
• 环境配置优化：内置环境变量配置，包括RocketMQ安装路径、执行路径等
• 基础环境集成：基于OpenJDK 8u292，确保Java运行环境兼容性
• 便捷脚本支持：包含部署脚本，简化启动与配置流程

使用场景

• 分布式系统中的异步通信
• 微服务架构下的服务解耦
• 高并发场景下的流量削峰
• 日志收集与数据同步
• 业务流程中的事件驱动架构

使用方法

部署模式说明

单节点部署

参考项目中的单节点部署脚本：
https://github.com/gitsang/script/blob/master/deploy/operation/rocketmq/docker/single/deploy.sh

DLedger模式部署

参考DLedger部署脚本（基于Raft协议的高可用模式）：
https://github.com/gitsang/script/blob/master/deploy/operation/rocketmq/docker/1m-2s-dledger/dledger.sh

集群部署

参考集群部署脚本（3主3从异步复制模式）：
https://github.com/gitsang/script/blob/master/deploy/operation/rocketmq/docker/3m-3s-async/cluster.sh

Dockerfile解析

基础信息

dockerfile
FROM openjdk:8u292

ARG ROCKETMQ_VERSION
ENV ROCKETMQ_PKG pkg/rocketmq-all-${ROCKETMQ_VERSION}-bin-release
ENV ROCKETMQ_HOME /usr/local/rocketmq/rocketmq-${ROCKETMQ_VERSION}
ENV PATH ${PATH}:${ROCKETMQ_HOME}/bin

WORKDIR ${ROCKETMQ_HOME}
COPY ${ROCKETMQ_PKG} ${ROCKETMQ_HOME}
COPY scripts ${ROCKETMQ_HOME}/bin

RUN echo '. ~/.bash_aliases' >> /root/.bashrc
COPY .bash_aliases /root/
COPY .virc /root/

WORKDIR ${ROCKETMQ_HOME}/bin

关键参数说明

• 构建参数：ROCKETMQ_VERSION - 指定RocketMQ版本
• 环境变量：
  • ROCKETMQ_PKG - RocketMQ安装包路径
  • ROCKETMQ_HOME - RocketMQ主目录
  • PATH - 添加RocketMQ可执行文件路径到系统环境变量
• 工作目录：默认工作目录为${ROCKETMQ_HOME}/bin，便于直接执行RocketMQ命令

构建与运行提示

1. 构建镜像（需指定RocketMQ版本）：

   bash
   "ROCKETMQ_VERSION=4.9.4" docker build -t rocketmq:4.9.4 .
   

2. 运行容器：具体运行命令需结合部署脚本中的配置，通常需映射必要端口（如9876、***等）并挂载配置文件目录。