【RocketMQ集群实战】Dashboard自动化部署与运维脚本全解析

最新推荐文章于 2026-07-21 14:01:43 发布

原创

最新推荐文章于 2026-07-21 14:01:43 发布 · 660 阅读

1. 为什么需要自动化部署脚本？

在真实的线上环境里，尤其是集群部署的场景下，手动去部署和运维 RocketMQ Dashboard 是一件非常“酸爽”的事情。我踩过的坑太多了：每次重启服务都要手动查进程、杀进程、改配置、启动，一不小心端口就被占用了，或者因为 JDK 版本不对启动失败，查看日志还得切到另一个终端。这些重复、琐碎的操作不仅效率低下，还容易出错。

想象一下，你的 RocketMQ 集群有多个 NameServer 和 Broker，分布在不同的机器上。Dashboard 作为监控和管理入口，如果部署和维护过程不能自动化，一旦需要重启或迁移，运维同学就得像救火队员一样，手动登录服务器，执行一系列命令。这显然不是一种优雅的方式。

所以，我决定用 Shell 脚本把整个部署和运维流程固化下来。脚本化的好处是显而易见的：一键执行、过程可重复、结果可预期。无论是初始化部署，还是日常的启动、停止、重启，都能通过脚本快速完成，大大降低了运维复杂度和人为失误的风险。接下来，我就把自己在实战中打磨出来的这套脚本和思路分享给你，你可以直接拿去用，也可以根据自己集群的实际情况进行调整。

2. 环境准备与项目配置

在写脚本之前，我们需要先把基础环境搭建好。这里假设你已经按照我上一篇文章《RocketMQ集群搭建（Docker版-2主2从）》部署好了 RocketMQ 集群。Dashboard 需要连接到这个集群的 NameServer 才能正常工作。

首先，我们需要获取 RocketMQ Dashboard 的项目。访问其 GitHub 仓库的 Release 页面，选择与你的 RocketMQ 版本对应的 Dashboard 版本。如果你用的是 RocketMQ 4.x，就选择 1.x 版本的 Dashboard；如果是 5.x，则需要选择 2.x 版本。这里我以 4.x 集群配套的 1.0.0 版本为例。

下载源码后，用 IDEA 或你喜欢的编辑器打开，找到 src/main/resources/application.properties 配置文件。这里有几个关键配置项必须修改：

# Dashboard 服务绑定的地址，0.0.0.0表示监听所有网卡
server.address=0.0.0.0
# Dashboard 服务端口，根据实际情况调整，避免冲突
server.port=8888

# 你的 RocketMQ 集群 NameServer 地址列表，多个用分号隔开
rocketmq.config.namesrvAddr=192.168.1.101:9876;192.168.1.102:9876

# Dashboard 存储本地数据（如用户配置）的路径，确保有写入权限
rocketmq.config.dataPath=/data/rocketmq-dashboard/data

# 是否开启登录认证，生产环境建议设为 true
rocketmq.config.loginRequired=false

配置完成后，在项目根目录下执行 Maven 打包命令，生成可执行的 JAR 文件：

mvn clean package -Dmaven.test.skip=true

打包成功后，你会得到一个类似 rocketmq-dashboard-1.0.0.jar 的文件。将这个 JAR 文件上传到你的目标服务器上，我习惯放在一个统一的目录下，例如 /usr/local/rocketmq/dashboard。同时，别忘了根据配置文件中 dataPath 的设定，提前创建好目录并赋予权限：

mkdir -p /data/rocketmq-dashboard/data
chmod -R 755 /data/rocketmq-dashboard/data

这一步是很多新手容易忽略的，如果目录不存在或权限不足，Dashboard 启动时就会报错，无法写入本地数据。

3. 核心启动脚本详解

好了，基础工作准备完毕，现在进入重头戏——编写自动化脚本。我们先从最核心的启动脚本 start-dashboard.sh 开始。这个脚本的目标是：智能、安全地启动 Dashboard 服务。它需要处理可能存在的端口冲突、残留进程，并记录进程 ID 以便后续管理。

3.1 脚本变量定义与初始化

一个好的脚本应该将可变的参数集中在开头定义为变量，这样后续维护和修改会非常方便。我们来定义脚本所需的所有变量：

#!/bin/bash

# ================= RocketMQ Dashboard 启动脚本 =================
# 作者：你的名字
# 描述：用于自动化启动 RocketMQ Dashboard，处理端口占用和旧进程

# Dashboard 部署的根目录
DASHBOARD_HOME="/usr/local/rocketmq/dashboard"
# 指定使用的 JDK 路径（RocketMQ 4.x 的 Dashboard 需要 JDK 8）
JAVA_HOME="/usr/local/java/jdk1.8.0_371"
# Dashboard 的 JAR 包名称
JAR_NAME="rocketmq-dashboard-1.0.0.jar"
# 用于记录进程 PID 的文件
PID_FILE="$DASHBOARD_HOME/dashboard.pid"
# 日志输出文件
LOG_FILE="$DASHBOARD_HOME/dashboard.log"
# Dashboard 服务端口
PORT=8888

# 切换到工作目录，确保相对路径生效
cd $DASHBOARD_HOME || { echo "无法进入目录 $DASHBOARD_HOME"; exit 1; }

这里有几个关键点：