一、容器化部署基础环境准备

1.1 Docker引擎安装与验证

容器化部署的核心依赖是Docker运行时环境，推荐使用Linux系统（Ubuntu/CentOS）进行部署。通过包管理器安装最新稳定版Docker：

# Ubuntu系统安装示例
curl -fsSL https://get.docker.com | sh
sudo systemctl enable --now docker
# CentOS系统安装示例
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io

安装完成后执行docker version验证输出信息，需确认Client和Server版本号一致且不低于20.10版本。对于生产环境，建议配置镜像加速服务（如使用行业认可的镜像仓库）提升拉取速度。

1.2 容器网络规划

RocketMQ集群需要稳定的网络环境，推荐使用Docker内置的bridge网络模式。创建专用网络：

docker network create --subnet=172.18.0.0/16 rocketmq-net

该网络将用于Broker和NameServer容器的通信，确保消息传输的稳定性。生产环境建议配置MTU值为1400以适应复杂网络环境。

二、核心组件镜像获取与验证

2.1 官方镜像获取策略

推荐从托管仓库获取经过认证的RocketMQ镜像，使用以下命令拉取最新稳定版本：

docker pull apache/rocketmq:5.1.3

对于国内开发者，可配置镜像加速器（需替换为行业通用的镜像服务地址）：

{
  "registry-mirrors": ["https://<mirror-domain>/"]
} | sudo tee /etc/docker/daemon.json
sudo systemctl restart docker

验证镜像完整性：

docker images | grep rocketmq
# 应显示类似输出：apache/rocketmq  5.1.3   abc123456789   2 weeks ago   850MB

2.2 镜像版本选择原则

开发测试环境：使用latest标签获取最新特性
生产环境：固定版本号（如5.1.3）确保行为可预测
特殊需求：可选择alpine版本（约300MB）减少资源占用

三、服务组件容器化部署

3.1 NameServer部署方案

NameServer作为路由注册中心，建议部署双节点实现高可用：

# 节点1启动
docker run -d --name rmq-namesrv1 \
  --network rocketmq-net --ip 172.18.0.2 \
  -p 9876:9876 \
  -v /data/rmq/namesrv1/logs:/home/rocketmq/logs \
  -v /data/rmq/namesrv1/store:/home/rocketmq/store \
  apache/rocketmq:5.1.3 \
  sh mqnamesrv
# 节点2启动（需修改IP和存储路径）
docker run -d --name rmq-namesrv2 \
  --network rocketmq-net --ip 172.18.0.3 \
  ...（其他参数同上）

关键参数说明：

-v：持久化存储配置，防止容器重启数据丢失
--ip：固定容器IP确保服务发现稳定性
-p：暴露管理端口（默认9876）

3.2 Broker集群配置

采用主从架构部署Broker节点，配置文件示例（broker.conf）：

brokerClusterName = DefaultCluster
brokerName = broker-a
brokerId = 0
deleteWhen = 04
fileReservedTime = 48
brokerRole = ASYNC_MASTER
flushDiskType = ASYNC_FLUSH
namesrvAddr=172.18.0.2:9876;172.18.0.3:9876

启动命令：

docker run -d --name rmq-broker1 \
  --network rocketmq-net --ip 172.18.0.4 \
  -p 10911:10911 -p 10909:10909 \
  -v /data/rmq/broker1/conf:/home/rocketmq/conf \
  -v /data/rmq/broker1/logs:/home/rocketmq/logs \
  -v /data/rmq/broker1/store:/home/rocketmq/store \
  apache/rocketmq:5.1.3 \
  sh mqbroker -c /home/rocketmq/conf/broker.conf

从节点配置需修改brokerId=1和brokerRole=SLAVE。

3.3 控制台部署（可选）

部署可视化监控平台：

docker run -d --name rmq-console \
  -p 8080:8080 \
  -e "JAVA_OPTS=-Drocketmq.namesrv.addr=172.18.0.2:9876;172.18.0.3:9876" \
  styletang/rocketmq-console-ng

访问http://localhost:8080即可查看集群状态。

四、生产环境优化建议

4.1 资源限制配置

通过--memory和--cpus参数限制容器资源使用：

docker run -d --memory="4g" --cpus="2" ...

建议配置：

NameServer：2核4G
Broker主节点：4核8G+
Broker从节点：2核4G

4.2 存储优化方案

使用SSD存储消息数据
配置RAID阵列提升I/O性能
定期清理过期消息（通过fileReservedTime参数控制）

4.3 监控告警体系

集成主流监控工具：

# Prometheus配置示例
scrape_configs:
  - job_name: 'rocketmq'
    static_configs:
      - targets: ['172.18.0.4:10911']

关键监控指标：

消息堆积量
发送/接收TPS
磁盘使用率
网络延迟

五、常见问题排查

5.1 网络连通性问题

使用docker exec进入容器测试网络：

docker exec -it rmq-broker1 ping 172.18.0.2

5.2 存储权限问题

确保宿主机目录有正确权限：

chown -R 1000:1000 /data/rmq/

5.3 版本兼容性问题

检查客户端与服务端版本匹配性，建议保持主版本号一致。

六、升级与维护流程

6.1 滚动升级策略

新建Broker节点加入集群
迁移消费者组到新节点
逐步下线旧节点

6.2 备份恢复方案

定期备份store目录，恢复时需保持brokerId一致。

通过以上标准化部署流程，开发者可在30分钟内完成RocketMQ集群的容器化部署。实际生产环境中，建议结合Kubernetes进行更高级的编排管理，实现自动扩缩容和故障自愈能力。对于超大规模集群，可考虑采用分片架构进一步分散存储压力。

Apache RocketMQ容器化部署全流程解析与实践指南