OSCHINA-MIRROR/saisimon-AGTMS

Автоматическое создание системы управления шаблонами

d8888 .d8888b. 88888888888 888b d888 .d8888b.
d88888 d88P Y88b 888 8888b d8888 d88P Y88b d88P888 888 888 888 88888b.d88888 Y88b.
d88P 888 888 888 888Y88888P888 "Y888b.
d88P 888 888 88888 888 888 Y888P 888 "Y88b. d88P 888 888 888 888 888 Y8P 888 "888 d8888888888 Y88b d88P 888 888 " 888 Y88b d88P d88P 888 "Y8888P88 888 888 888 "Y8888P"

GitHub

AGTMS — это система управления объектами конфигурации, основанная на Spring Cloud и Vue.js. Она поддерживает Oracle, MySQL, MariaDB, SQL Server, PostgreSQL, MongoDB и RESTful способы получения данных.

Ветви:

dev (https://github.com/Saisimon/AGTMS) — ветка разработки;
master (https://github.com/Saisimon/AGTMS/tree/master) — распределённая среда;
standalone (https://github.com/Saisimon/AGTMS/tree/standalone) — одиночная машина.

Структура проекта:

.
├── agtms-admin         Spring Boot Admin сервис (опционально)(порт по умолчанию: 7890, пользователь по умолчанию: agtms, пароль: agtms7890)
├── agtms-autoconfigure  библиотека поддержки автоматической конфигурации
├── agtms-autotest        автоматизированный тестовый модуль
├── agtms-example         сервис удалённого вызова (порт по умолчанию: 7899)
├── agtms-parent 
│   ├── agtms-api          внутренний интерфейс библиотеки
│   ├── agtms-config        библиотека конфигурации
│   ├── agtms-core          основная библиотека
│   ├── agtms-jpa           JPA реализация поддержки библиотеки (H2 по умолчанию, поддержка Oracle, MySQL, MariaDB, SQL Server, PostgreSQL базы данных)
│   ├── agtms-mongodb       MongoDB реализация поддержки библиотеки (опционально)
│   ├── agtms-redis         Redis поддержка библиотеки (опционально)
│   ├── agtms-remote        поддержка библиотеки удалённого вызова (опционально)
│   └── agtms-web           веб-сервис (порт по умолчанию: 7892, пользователь по умолчанию: admin, пароль: 123456)
├── agtms-record          модуль агрегации отчётов тестирования
├── agtms-vue              веб-страница (порт по умолчанию: 8080)
├── agtms-zuul             шлюз Zuul (порт по умолчанию: 7891)
├── data                  Docker Compose данные
│   └── web
|       ├── config          дополнительная конфигурация веб-сервиса
|       ├── files            путь к файлам веб-сервисов (изображения, импорт, экспорт)
|       └── libs             путь к дополнительным jar-библиотекам веб-сервиса
├── .env                   конфигурация переменных среды Docker Compose
├── docker-compose.yml      конфигурация Docker Compose
├── README.md               файл README
├── start.cmd               стартовый скрипт (Windows)
├── stop.cmd                останавливающий скрипт (Windows)
├── start                  стартовый скрипт (Unix)
└── stop                    останавливающий скрипт (Unix)

Предварительные условия:

JRE(JDK) 8+ (https://www.java.com);
Node.js (https://nodejs.org/);
Apache ZooKeeper (http://zookeeper.apache.org/);
RAM 4G+.

Или:

Docker (https://www.docker.com/).

Установка и запуск:

Однокнопочный запуск

По умолчанию используется H2 база данных в памяти, данные будут сброшены при каждом перезапуске. Для сохранения данных настройте соединение с базой данных самостоятельно.

Подготовьте Zookeeper и настройте хосты

/etc/hosts (Unix);
c:\windows\system32\drivers\etc\hosts (Windows).

<ZooKeeper IP>   zookeeperserver

Выполните стартовый скрипт

start.cmd по умолчанию завершит процессы, использующие порты 7890, 7891, 7892. Пожалуйста, убедитесь, что вы хотите продолжить, прежде чем выполнять операцию

# Unix
./start

# Windows
start.cmd

Доступ

http://localhost:8080

Журналы

data
├── admin 
|   └── agtms-admin.log   Spring Boot Admin журнал сервиса
├── web 
|   └── agtms-web.log     журнал веб-сервиса
└── zuul
    └── agtms-zuul.log    журнал шлюза

Поэтапный запуск

Подготовьте Zookeeper и настройте хосты

/etc/hosts (Unix);
c:\windows\system32\drivers\etc\hosts (Windows).

<ZooKeeper IP>   zookeeperserver

Соберите проект

# Unix
./mvnw clean package -Ddockerfile.skip=true

# Windows
mvnw.cmd clean package -Ddockerfile.skip=true

Запустите веб-службу (agtms-web)

java -jar agtms-parent/agtms-web/target/agtms-web.jar

Запустите шлюз (agtms-zuul)

java -jar agtms-zuul/target/agtms-zuul.jar

Запустите страницу (agtms-vue)

cd agtms-vue
npm install
npm run serve
``` **Доступ**

```html
http://localhost:8080

Запуск Spring Boot Admin сервиса (agtms-admin)

java -jar agtms-admin/target/agtms-admin.jar

Логи

data
admin
web
zuul

Запуск Docker-контейнера

Установите Docker CE или Docker EE, следуя официальной документации.
Установите Docker Compose, следуя официальной документации.
Скомпилируйте Java-проект и создайте образ Docker.

# Unix
./mvnw clean package

# Windows
mvnw.cmd clean package

Добавьте в папку data/web/libs соответствующий драйвер базы данных jar-пакет.

По умолчанию используется MySQL 5.7.

# mysql-connector-java-8.0.16.jar
wget -P data/web/libs http://central.maven.org/maven2/mysql/mysql-connector-java/8.0.16/mysql-connector-java-8.0.16.jar

Запустите контейнер.

WEB_CONFIG_HOME — дополнительная конфигурация для веб-службы, по умолчанию ./data/web/config.
WEB_LIBS_HOME — дополнительный путь к jar-библиотекам для веб-службы, по умолчанию ./data/web/libs.
REVISION — версия, по умолчанию последняя версия.

# Docker Compose
docker-compose up -d

# Docker Swarm
docker stack deploy -c docker-compose.yml agtms

Доступ

http://localhost:8080

Пример удалённого вызова

Подготовьте Zookeeper и настройте хосты.

/etc/hosts (Unix).
c:\windows\system32\drivers\etc\hosts (Windows).

<IP-адрес ZooKeeper>   zookeeperserver

Запустите сервис agtms.

# Unix
./start

# Windows
start.cmd

Запустите пример сервиса agtms-example.

java -jar agtms-example/target/agtms-example.jar

Доступ

http://localhost:8080

Автоматизированное тестирование

Chrome

Скачайте соответствующую версию Chrome Driver и распакуйте её.
Настройте путь к Chrome Driver.

agtms-autotest/src/main/resources/autotest.properties.

auto.test.chrome.driver=/Users/saisimon/Downloads/chromedriver

Выполните тестовые сценарии.

agtms-autotest/src/test/java/net/saisimon/agtms/autotest/ChromeTest.

Firefox

Загрузите последнюю версию Gecko Driver и распакуйте его.
Настройте путь к Gecko Driver.

agtms-autotest/src/main/resources/autotest.properties.

auto.test.firefox.driver=/Users/saisimon/Downloads/geckodriver

Выполните тестовые сценарии.

agtms-autotest/src/test/java/net/saisimon/agtms/autotest/FirefoxTest.