Развертка

0. Онлайн-демо

• http://datart-demo.retech.cc
• Логин: demo
• Пароль: 123456

1. Развертка с помощью Docker

docker run -p 8080:8080 datart/datart 

После запуска доступен по адресу http://ip_docker_хоста:8080 По умолчанию логин: demo, пароль: 123456

1.1. Конфигурация внешней базы данных

Без конфигурации внешней базы данных Datart использует H2 в качестве базы данных приложения. Рекомендуется использовать свою MySQL базу данных в качестве базы данных приложения.

Создайте пустой файл datart.conf, а затем скопируйте следующий текст внутрь файла:

# Настройки соединения с базой данных
datasource.ip=   
datasource.port=
datasource.database=
datasource.username=
datasource.password=

# Сервер
server.port=8080
server.address=0.0.0.0

# Конфигурация Datart
datart.address=http://127.0.0.1
datart.send-mail=false
datart.webdriver-path=http://127.0.0.1:4444/wd/hub

Запустите команду 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

Дополнительные настройки доступны по адресу http://running-elephant.gitee.io/datart-docs/docs/index.html# 2. Локальная развертка

2.1. Подготовка окружения

• JDK 1.8+
• MySQL 5.7+
• Установочный пакет Datart (datart-server-1.0.0-beta.x-install.zip)
• Сервер электронной почты (необязательно)
• ChromeWebDriver (необязательно)
• Redis (необязательно)

Метод 1: Распакуйте установочный пакет (официальный пакет)

unzip datart-server-1.0.0-beta.x-install.zip

Метод 2: Самостоятельная сборка

git clone https://github.com/running-elephant/datart.git

cd datart

mvn clean package -Dmaven.test.skip=true

cp ./datart-server-1.0.0-beta.x-install.zip ${deployment_basedir}

cd ${deployment_basedir}

unzip datart-server-1.0.0-beta.x-install.zip 

2.2. Запуск в режиме standalone

После распаковки установочного пакета запустите ./bin/datart-server.sh start для старта Datart. По умолчанию доступен по адресу http://127.0.0.1:8080, логин: demo/123456. Использование встроенной базы данных в режиме standalone не гарантирует безопасности данных и возможности миграции данных, поэтому рекомендуется использовать внешнюю базу данных как основную базу данных приложения.

2.3. Настройка внешней базы данных, требуется версия MySQL 5.7 или выше.

• Создайте базу данных, указав кодировку базы данных как utf8

CREATE DATABASE `datart` CHARACTER SET 'utf8' COLLATE 'utf8_general_ci';

Обратите внимание: до версии 1.0.0-beta.2 требовалось выполнение скрипта bin/datart.sql для инициализации базы данных вручную. В этой и более поздних версиях достаточно создать базу данных, и она будет автоматически инициализирована при первом соединении.При первом подключении к базе данных (или после обновления версии), рекомендуется использовать учетную запись с высокими привилегиями (например, root). Это связано с тем, что первый запрос к базе данных выполняет скрипт инициализации базы данных, и если используется учетная запись с низкими привилегиями, это может привести к ошибкам инициализации

• Основные настройки: конфигурационный файл находится в config/datart.conf

# Обязательные настройки базы данных:
1. datasource.ip (IP адрес базы данных)
2. datasource.port (порт базы данных)
3. datasource.database (название базы данных)
4. datasource.username (имя пользователя)
5. datasource.password (пароль)

# Дополнительные настройки (необязательные):
1. server.port (порт приложения, по умолчанию 8080)
2. server.address (IP адрес приложения, по умолчанию 0.0.0.0)
3. datart.address (внешний доступ к datart, по умолчанию http://127.0.0.1)
4. datart.send_mail (использование активации через электронную почту при регистрации пользователя, по умолчанию false)
5. datart.webdriver_path (путь к драйверу для создания скриншотов)

2.4. Расширенные настройки (необязательные): конфигурационный файл находится в config/profiles/application-config.yml

Формат файла расширенной конфигурации — yml. Неправильная конфигурация может помешать запуску программы. При настройке следует строго следовать формату yml

application-config.yml обрабатывается Spring Boot, все параметры OAuth2, Redis, Mail полностью соответствуют конфигурации Spring Boot Auto Configure### 2.4.1 Информация о конфигурационном файле

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    type: com.alibaba.druid.pool.DruidDataSource
    url: jdbc:mysql://localhost:3306/datart?&allowMultiQueries=true
    username: datart
    password: datart123

  # Настройка почты является примером использования почтового сервиса Aliyun
  mail:
    host: smtp.mxhichina.com
    port: 465
    username: aliyun.djkjfhdjfhjd@aliyun.cn
    fromAddress: aliyun.djkjfhdjfhjd@aliyun.cn
    password: hdjksadsdjskdjsnd
    senderName: aliyun

свойства: smtp: starttls: включено: true требуется: true аутентификация: true почта: smtp: ssl: включено: true доверие: smtp.mxhichina.com

Конфигурация Redis Если требуется включить кэширование, необходимо выполнить следующую конфигурацию

redis:

порт: 6379

хост: {ХОСТ}

Конфигурация сервера Веб-сервис привязывается к IP-адресу и порту используя локальный IP-адрес и указанный порт

сервер: порт: your_port адрес: your_ip

сжатие: включен: true mime_типы: application/javascript,application/json,application/xml,text/html,text/xml,text/plain,text/css,image/*

Конфигурация адреса доступа к серверу, используется при создании разделов, активации/приглашении пользователей. При наличии домена его можно использовать вместо IP-адреса

datart: сервер: адрес: http://your_ip:your_port

пользователь: активация: отправка_почты: true # Требуется ли электронная почта для активации при регистрации пользователя? Если нет электронной почты, здесь следует установить значение false безопасность: токен: секрет: "d@a$t%a^r&a*t" # ключ шифрования время_ожидания_минут: 30 # Длительность сессии входа в систему, минуты.

окружение: путь_к_файлу: ${user.dir}/files # папка для хранения файлов сервера

Опциональная конфигурация. Если требуется конфигурирование, обратитесь к [3.2 Конфигурация скриншотов [ChromeWebDriver]-опциональная]

скриншот: время_ожидания_секунд: 60 тип_веб_драйвера: CHROME путь_веб_драйвера: "http://your_ip:4444/wd/hub"

### 2.4.2 Конфигурация скриншотов [ChromeWebDriver]-опциональная

```bash

docker pull selenium/standalone-chrome  # Получаем Docker образ

docker run -p 4444:4444 -d --name selenium-chrome --shm-size="2g" selenium/standalone-chrome  # Запуск

2.5 Запуск сервиса

Обратите внимание: скрипт запуска был обновлен до start|stop|status|restart

${DATART_HOME}/bin/datart-server.sh (start|stop|status|restart)

2.5 Доступ к сервису

Обратите внимание: По умолчанию нет учетных записей пользователей. После регистрации вы можете сразу войти.

http://your_ip:your_port/login