1. Docker 部署

datart 在 dockerhub 中的公共镜像地址为 datart/datart。如果你本地已经安装了 docker,执行以下命令可以一键安装:

docker run -p 8080:8080 datart/datart

镜像启动成功后,在浏览器中访问 http://docker_ip:8080 进入登录页。镜像中提供初始账户,用户名 demo 密码 123456

1.1 配置应用数据库

在默认情况下,Datart 使用内置的 H2 作为应用程序数据库。 如果将 datart 用于生产环境,建议使用 MySQL 作为应用程序数据库。配置步骤如下:

  1. 新建一个名为 datart.conf 的空文件,将以下内容填写完整,然后粘贴到到文件中
# 应用数据库配置
datasource.ip=localhost       # 数据库IP或域名
datasource.port=3306          # 数据库端口
datasource.database=datart    # 数据库名称
datasource.username=root      # 用户名
datasource.password=root      # 密码

# 应用服务器配置
server.port=8080              # 服务器端口
server.address=0.0.0.0        # 服务器地址(内网地址)

# datart 全局配置
datart.address=http://127.0.0.1:8080                # 应用主页地址(公网地址)
datart.send-mail=false                              # 注册账户时是否需要邮件激活
datart.webdriver-path=http://127.0.0.1:4444/wd/hub  # ChromeDriver 地址(用于截图)
  1. 运行以下命令,使用新建的 datart.conf 配置启动镜像
docker run -d --name datart -v your_path/datart.conf:/datart/config/datart.conf -p 8080:8080 datart/datart

1.2 文件挂载

在默认情况下,用户在应用中生成文件(头像、文件数据源等)保存在 files 路径下。为保证在应用升级时这些文件得以保留,可以将这个路径挂载到容器外部;在启动命令中增加参数 -v your_path/files:/datart/files 即可。以下是完整命令:

docker run -d --name datart -v your_path/datart.conf:/datart/config/datart.conf -v your_path/files:/datart/files -p 8080:8080 datart/datart

2. 本地部署

2.1 环境准备

  • JDK 1.8+
  • MySql5.7+
  • datart 安装包(datart-server-*-install.zip)
  • Chrome 和 WebDriver (可选)
  • Redis (可选)

2.2 文件结构

首先解压安装包

unzip datart-server-*-install.zip

解压之后的文件结构如下

├── bin               # 执行脚本目录
├── config            # 配置文件目录
├── (files)           # 应用生成文件目录;应用运行后生成
├── lib               # 项目依赖目录
├── (logs)            # 日志目录;应用运行后生成
├── static            # 静态资源目录
├── nohup.out         # 缺省日志输出文件
├── Deployment.md     # 部署说明
├── Dockerfile
└── LICENSE

2.3 启动应用

运行 bin 目录下的脚本来启动应用,Linux 用户使用 bin/datart-server.sh,Windows 用户使用 bin/datart-server.cmd。以 Linux 系统举例,命令列表如下:

${DATART_HOME}/bin/datart-server.sh start       # 启动
${DATART_HOME}/bin/datart-server.sh stop        # 停止
${DATART_HOME}/bin/datart-server.sh status      # 查看状态
${DATART_HOME}/bin/datart-server.sh restart     # 重启

2.3.1 直接运行

安装包解压后,即可直接运行脚本启动应用。需要注意的是,直接启动时使用的是内置的 H2 数据库作为应用数据库,升级应用时无法迁移数据,不建议在生产环境使用

启动之后通过 http://127.0.0.1:8080 地址访问应用主页,内置初始账户,用户名 demo 密码 123456

2.3.2 配置应用数据库

datart 目前支持配置 MySQL 作为应用数据库;需要 MySQL 5.7 及以上版本。配置步骤如下:

  1. 创建数据库,指定数据库编码为 utf8
mysql> CREATE DATABASE `datart` CHARACTER SET 'utf8' COLLATE 'utf8_general_ci';

注意:1.0.0-beta.2 版本以前,需要手动执行bin/datart.sql来初始化数据库。此版本及以上版本,创建好数据库即可,在初次连接时会自动初始化数据库

首次连接数据库(或者版本升级)时,建议使用一个权限较高的数据库账号登录(建议 root 账号)。因为首次连接会执行数据库初始化脚本,如果使用的数据库账号权限太低,会导致数据库初始化失败

  1. 编辑 config/datart.conf 文件完成配置
datasource.ip=localhost           # 数据库IP或域名
datasource.port=3306              # 数据库端口
datasource.database=datart        # 数据库名称
datasource.username=root          # 用户名
datasource.password=root          # 密码

Datart可视化的安装步骤_数据库