Alldata项目完整部署与运行指南

项目概述

Alldata是一个功能全面的数据中台解决方案，采用微服务架构设计，包含数据集成、元数据管理、数据标准、数据质量、数据资产等核心模块。本文将详细介绍如何从零开始部署和运行Alldata项目。

环境准备

在开始部署前，请确保以下环境已准备就绪：

基础环境要求

• JDK：1.8或更高版本
• 数据库：MySQL 5.7.0或更高版本（推荐5.7+）
• 缓存：Redis 3.0或更高版本
• 构建工具：Maven 3.0或更高版本
• 前端环境：Node.js 10.15.3或更高版本
• 消息队列：RabbitMQ 3.0.x或更高版本

特别提示：使用MySQL 8的用户需注意数据导入时的编码格式问题

项目结构解析

后端项目结构

后端采用微服务架构，主要分为以下几个部分：

moat/
├── config/          # 配置中心（必须启动）
├── eureka/         # 注册中心（必须启动）
├── gateway/        # API网关（必须启动）
├── install/        # 数据库脚本目录
│   ├── 16gdata/
│   ├── 16gmaster/
│   │   ├──studio/
│   │   │   ├──alldata-0.x.x.sql
│   ├── 16gsla/ 
├── studio/         # 业务模块目录
│   ├── codegen-service-parent/      # 代码生成（可选）
│   ├── data-market-service-parent/  # 数据服务（可选）
│   ├── data-masterdata-service-parent/ # 数据模型（可选）
│   ├── data-metadata-service-parent/   # 元数据管理（可选）
│   ├── data-quality-service-parent/    # 数据质量（可选）
│   ├── data-standard-service-parent/   # 数据标准（可选）
│   ├── data-system-service-parent/     # 基础服务（必须）
│   ├── data-visual-service-parent/     # 数据可视化（可选）
│   ├── email-service-parent/           # 邮件服务（可选）
│   ├── file-service-parent/            # 文件服务（可选）
│   ├── quartz-service-parent/          # 定时任务（可选）
│   ├── service-data-dts-parent/        # 数据集成（可选）
│   ├── system-service-parent/          # 系统管理（必须）

前端项目结构

前端采用Vue.js框架，标准项目结构：

moat_ui/
├── public/        # 静态资源
├── src/           # 源代码目录
├── babel.config.js # Babel配置
├── package.json   # 项目依赖
├── vue.config.js  # Vue项目配置

本地开发环境部署

后端服务启动

1. 获取项目代码：将项目代码导入到IDEA等开发工具中

2. 数据库初始化：

   • 创建名为studio的数据库
   • 执行install/sql目录下的SQL脚本：
     • alldata.sql（基础表结构）
     • alldata-v0.x.x.sql（版本更新脚本）
     • BI相关SQL（参考BI快速入门文档）

3. 配置修改： 修改moat/config/src/main/resources/config/application-common-dev.yml文件中的配置项：

   • RabbitMQ连接信息
   • MySQL连接信息
   • Redis连接信息

4. 核心服务启动顺序：

   • DataxEurekaApplication（注册中心）
   • DataxConfigApplication（配置中心）
   • DataxGatewayApplication（API网关）
   • SystemServiceApplication（系统服务）

5. 可选服务：根据需求启动其他业务模块

前端服务启动

1. 进入前端项目目录
2. 执行npm install安装依赖
3. 执行npm run dev启动开发服务器

生产环境部署

数据库初始化

1. 执行基础SQL脚本：

   source install/sql/alldata.sql
   source install/sql/alldata-v0.x.x.sql
   

2. 导入BI相关SQL（参考BI快速入门文档）

服务部署方案

单节点部署（All in One）

1. 启动注册中心（eureka）
2. 启动配置中心（config）
3. 启动API网关（gateway）
4. 按需启动其他服务

三节点集群部署

节点	服务	端口
16gmaster	系统服务、数据市场、元数据等	8000+
16gslave	注册中心、元数据控制台等	8610+
16gdata	数据标准、可视化、文件服务等	8811+

部署步骤：

1. 在16gslave节点启动eureka
2. 在16gmaster节点启动config
3. 在16gdata节点启动gateway
4. 分别在各节点执行对应的启动脚本

特殊组件处理

对于项目中使用的aspose-words组件，需要手动安装到本地Maven仓库：

cd moat/common
mvn install:install-file -Dfile=aspose-words-20.3.jar \
     -DgroupId=com.aspose \
     -DartifactId=aspose-words \
     -Dversion=20.3 \
     -Dpackaging=jar

常见问题解决

数据集成菜单缺失

如果发现"数据集成"菜单不可见，请按照以下步骤配置：

1. 进入系统管理 > 菜单管理
2. 新增"数据集成"目录
3. 配置目录下的各项菜单
4. 在角色管理中为admin账号分配数据集成相关权限
5. 刷新页面或重新登录

其他模块缺失

类似地，如果发现其他功能模块缺失，可以通过菜单管理进行配置，确保相关服务已启动并正确配置权限。

最佳实践建议

1. 开发环境：建议使用Docker容器化依赖服务（MySQL、Redis、RabbitMQ）
2. 生产环境：
   • 建议使用Nginx作为前端静态资源服务器
   • 配置服务监控和日志收集
   • 根据业务需求合理分配服务到不同节点
3. 性能优化：
   • 根据服务器配置调整JVM参数
   • 合理配置Redis缓存策略
   • 对高频访问接口添加缓存

通过以上步骤，您可以顺利完成Alldata项目的部署和运行。根据实际业务需求，可以灵活选择需要启动的模块，构建符合自身需求的数据中台解决方案。