DataEase源码部署到本地

DataEase本地部署源码（工具IDEA）

Joseph991006

5815人浏览 · 2022-08-01 11:55:48

Joseph991006 · 2022-08-01 11:55:48 发布

DataEase本地源码部署

1 项目结构
2 配置开发环境
3 代码运行

1 项目结构

DataEase版本：v1.12
在这里插入图片描述

2 配置开发环境

2.1. 环境准备

后端：JDK 1.8 、maven
前端：node.js 、Vue.js插件
安装 npm

2.2. 初始化配置
（1）数据库初始化：
数据库官方推荐使用MySQL5.7，同时 DataEase 对数据库部分配置项有要求，请参考附的数据库配置：
在这里插入图片描述

[mysqld]
datadir=/var/lib/mysql
default-storage-engine=INNODB
character_set_server=utf8
lower_case_table_names=1
table_open_cache=128
max_connections=2000
max_connect_errors=6000
innodb_file_per_table=1
innodb_buffer_pool_size=1G
max_allowed_packet=64M
transaction_isolation=READ-COMMITTED
innodb_flush_method=O_DIRECT
innodb_lock_wait_timeout=1800
innodb_flush_log_at_trx_commit=0
sync_binlog=0
group_concat_max_len=1024000
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
skip-name-resolve

注：修改完my.ini文件以后，重新启动mysql服务

（2）创建DataEase数据库，DataEase 后端服务启动时会自动在配置的库中创建所需的表结构及初始化数据：

CREATE DATABASE `dataease` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

注：mysql5.7以下，将 utf8mb4改为 utf8

（3）创建dataease.properties配置文件在工程源码的所在盘的根路径按照此路径创建 properties配置文件/opt/dataease/conf/dataease.properties . 如工程源码在D盘，则配置文件的的存放路径为D:\opt\dataease\conf\dataease.properties。请参考下面配置创建对应目录及配置文件。
提示：将 MYSQL_HOST 配置为自己的 MySQL 地址，并修改 username、password。

# 数据库配置
spring.datasource.url=jdbc:mysql://MYSQL_HOST:3306/dataease?autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false
spring.datasource.username=root
spring.datasource.password=Password123@mysql

carte.host=kettle
carte.port=18080
carte.user=cluster
carte.passwd=cluster

doris.db=dataease
doris.user=root
doris.password=Password123@doris
doris.host=doris-fe
doris.port=9030
doris.httpPort=8030

#新建用户初始密码
dataease.init_password=DataEase123456
#登录超时时间单位min  如果不设置 默认8小时也就是480
dataease.login_timeout=480

logger.level=INFO

#DE运行模式，可选值有 local、simple、cluster，分别对应本地模式、精简模式、集群模式
engine_mode=simple

3 代码运行

1. 从git上拉取项目，并下载依赖，若为MySQL5.7则无需修改任何源码，否者则应在pom文件中修改对应的数据库依赖。
源码地址：https://github.com/dataease/dataease/tree/v1.12

注：若下载依赖时报如下图的错误，则是由于dataease 1.13.0版本的相关依赖并未上传到maven库,因此拉取时会报错。（不过现在官方已经将v1.12版本的io.dataease依赖改为1.12.0版本，如果pom文件中的io.dataease依赖为1.12.0版本，请自行忽略解决方法）解决方法如下：
在这里插入图片描述

解决方法：
（1）去github拉取 dataease-extension-sdk 代码，切换到与 dataease 相同分支（比如 dataease 用的 v1.12 分支，那么 dataease-extension-sdk 也要使用 v1.12分支，确保分支一致），执行 mvn clean 、install 将依赖安装到本地。
dataease-extension-sdk 源码地址：
https://github.com/dataease/dataease-extension-sdk/tree/v1.12
（2）接着 mvn -> reload project
在这里插入图片描述
（3）再次编译dataease，编译成功

2. 对前端模块frontend执行install操作(本地打包一下)
3. 启动后端，服务完全启动后，可以在本地浏览器访问 http://localhost:8081
来访问DataEase服务，然后登录。（如果这里更改了后端的端口号，请将前端部署的端口号也同样修改一下）
默认登录用户名：admin 密码：dataease

注：服务启动时控制台报错，且查看数据库中表结构已生成，日志中提示该异常，这是正常的。此时如果前面操作没有问题的话，访问http://localhost:8081是可以正常登录dataease的。出现此问题的原因是dataease默认连接的demo 数据源配置信息不正确导致的，解决办法如下：
在这里插入图片描述
解决方法：
浏览器登录 dataease，修改数据源 - demo 数据源的配置，将ip地址、数用户名、密码改为本地MySQL的配置，然后校验通过后保存即可，如下图所示。再次启动项目，报错消失。

提示：如需了解更多，请参考官方文档
官方文档：https://dataease.io/docs/dev_manual/dev_manual/
官方知识库：https://kb.fit2cloud.com/categories/dataease
注：若再次运行项目，访问http://localhost:8081后出现空白页，请清除浏览器数据后再试。