本教程将引导你通过本地源码部署的方式启动 DataEase,同时我还录制了相应的视频教程,你可以跟随视频进行操作:
DataEase 本地源码启动_哔哩哔哩_bilibili
1、下载并安装IDEA开发工具
2、下载安装Mysql 5.7 以及 JDK 1.8
如果你使用的是windows系统,可以参考我录制的视频——“windows系统下的jar包运行”进行学习
DataEase 本地运行之 Windows 系统下的本地 jar 包启动_哔哩哔哩_bilibili
如果你使用的是mac系统,可以参考我录制的视频——“mac系统下的jar包运行”进行学习
DataEase 本地运行之 Mac 系统下的本地 jar 包启动_哔哩哔哩_bilibili
3、下载安装 maven
官网下载地址: http://maven.apache.org
(1)选择一个目录,将下载的Maven压缩包进行解压
(2)添加maven的环境变量配置
# 编辑配置文件
vim ~/.bash_profile
# 添加以下配置(此处配置的路径是我们本地 maven 所在目录下的 bin 文件路径)
export PATH=$PATH:/Users/zhaoqian/maven/apache-maven-3.6.3/bin
# 重新加载使最新的配置生效
source ~/.bash_profile
(3)配置Maven仓库
<!-- 打开maven目录下的 conf/settings.xml 文件,将以下内容复制进去-->
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<!-- localRepository-->
<localRepository>/Users/zhaoqian/maven/repository</localRepository>
<pluginGroups>
</pluginGroups>
<proxies>
</proxies>
<servers>
</servers>
<!-- mirrors -->
<mirrors>
<!-- 阿里云仓库 -->
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirrors>
<profiles>
<!-- 阿里云配置: 提高国内的jar包下载速度 -->
<profile>
<id>ali</id>
<repositories>
<repository>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
</pluginRepository>
</pluginRepositories>
</profile>
<!-- 指定Maven的jdk版本 -->
<profile>
<id>JDK-1.8</id>
<activation>
<activeByDefault>true</activeByDefault>
<jdk>1.8</jdk>
</activation>
<properties>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
</properties>
</profile>
</profiles>
</settings>
4、下载安装 node(安装v16.17.0版本)
官网下载地址:Download | Node.js
下载完成后双击安装即可,安装完成后可使用下面的命令查看 npm和 node的版本
# 查看node版本
node -v
# 查看npm版本
npm -v
5、创建并修改dataease项目所使用的本地配置文件
DataEase 会默认加载该路径下的配置文件 /opt/dataease/conf/dataease.properties,请参考下面配置创建对应目录及配置文件。
mkdir -p /opt/dataease/conf
vim dataease.properties
将下面的配置信息复制到配置文件dataease.properties中,提示: 请自行将 MYSQL_HOST 配置为自己的 MySQL 地址。
# 数据库配置
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
6、下载依赖项目 dataease-plugins 工程源码,在本地编译一下
git clone git@github.com:dataease/dataease-extension-sdk.git
# 切换到最新分支(当前最新分支为v1.16)
git fetch
git checkout v1.16
# 使用IDEA打开项目并配置maven仓库
# 逐个构建此项目下的各个子模块,以dataease-plugin-common为例
cd dataease-extension-sdk/dataease-plugin-common
mvn clean install
7、本地下载DataEase项目源码到本地
git clone https://github.com/dataease/dataease.git
# 切换到最新分支(当前最新分支为v1.16)
git fetch
git checkout v1.16
# 使用IDEA打开项目并配置maven仓库
# 注释掉backend目录下的pom.xml文件中关于打包前端的配置(见下方截图)
# 构建并启动后端
mvn clean package
# 启动前端
cd frontend
npm install
npm run serve
8、地图库准备
DataEase 从 1.2 版本开始支持地图组件。在 DataEase 源码工程的目录下有一个地图文件目录 mapFiles/full,需要将该目录下的文件放置到 /opt/dataease/data/feature/full 目录下:
mkdir -p /opt/dataease/data/feature
cd dataease
cp -r mapFiles/full /opt/dataease/data/feature/full