WSO2 Micro Integrator 7.1 自建源码包如何启动Dashboard
源码构建WSO2 Micro Integrator 7.1 启动Micro Dashboard的完整操作
核心原因
自行构建的zip包找不到Dashboard启动脚本,根源是源码默认打包流程和官方二进制包的构建逻辑不一致:
- micro-integrator-dashboard是Micro Integrator的独立子模块,执行根目录的常规全量构建命令时,默认不会把Dashboard的启动脚本、前端资源、后端依赖集成到最终的运行时zip包内
- 官方发布的预置Dashboard的二进制包,是在构建流程中额外激活了专属集成profile生成的,和普通源码构建的产物不通用
正确的构建与启动步骤
- 修正源码构建命令
拉取7.1最新Release tag的代码后,在源码根目录执行构建时,需要追加激活Dashboard集成的专属参数,不要仅执行跳过测试的常规构建命令:
这个参数会触发三个核心流程:mvn clean install -Dmaven.test.skip=true -P product,dashboard- 编译打包
micro-integrator-dashboard子模块的全部代码 - 将Dashboard启动脚本拷贝到最终发行包的
bin目录 - 将Dashboard运行依赖的jar包拷贝到MI运行时的类路径下
- 编译打包
- 构建完成后校验包完整性
待构建流程走完,到micro-integrator/distribution/target/路径下找到生成的zip发行包,解压后做两项校验:- 检查
<MI_HOME>/bin目录下是否存在Linux/macOS环境的micro-integrator-dashboard.sh、Windows环境的micro-integrator-dashboard.bat启动脚本 - 检查
<MI_HOME>/lib目录下是否存在文件名以org.wso2.micro.integrator.dashboard开头的依赖jar
- 检查
- 启动Dashboard
- 首先通过原有启动脚本正常启动MI核心运行时进程
- 新开终端窗口,切换到
<MI_HOME>/bin路径,执行对应系统的Dashboard启动命令:- Linux/macOS:
./micro-integrator-dashboard.sh - Windows:
micro-integrator-dashboard.bat
- Linux/macOS:
- 服务启动完成后,通过默认端口
9743访问Dashboard控制台即可
常见问题排查
- 如果追加profile参数构建后依然找不到Dashboard脚本,检查maven执行日志是否存在Dashboard模块的构建跳过记录,可删除本地Maven仓库中
org/wso2/micro-integrator路径下的缓存,重新执行构建命令 - 不建议直接从官方二进制包中拷贝Dashboard相关文件到自研构建包中,版本不匹配会导致前后端接口报错、控制台渲染异常等问题
内容的提问来源于stack exchange,提问作者vipin
相关产品推荐
相关产品推荐

