Skip to content
master
Switch branches/tags
Code
This branch is up to date with master.
Contribute

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
mm
 
 
 
 
 
 
 
 
 
 
 
 

lsfusion-samples

logo

Примеры для демонстрации возможностей платформы lsFusion. Описание здесь.

Проект lsfusion-samples должен упростить жизнь тем, кто только начал знакомиться с lsFusion:

  • для Windows разработан специальный установщик, который установит все необходимое.
  • в Linux можно разверуть и запустить необходимые сервисы одной командой docker-compose up -d.

Проект устроен так, что вам не нужно изучать и использовать maven-команды, достаточно запустить нужную вам конфигурацию в IntelliJ IDEA и ввести localhost:8080 в браузере. Для простоты, все конфигруации отображаются на один и тот же адрес, поэтому остановите работающую конфигурацию в IDEA перед тем, как запустить другую.

Оглавление:

Windows

В Windows используйте специальный установщик, который автоматически установит все необходимое для работы с демонстрационными примерами и создаст иконки для запуска.

Скачайте и распакуйте ZIP-архив проекта lsfusion-samples в каталог на своем компьютере, откройте этот каталог в IntelliJ IDEA, выберите интерсную вам конфигурацию и запустите ее в IntelliJ IDEA.

Щелкните мышкой на иконку desktop-клиента или откройте в браузере страницу по адресу localhost:8080.

Linux

Данный проект предназначен для тех, кто начинает изучать lsfusion. Поэтому проект содержит docker-compose.yml, который значительно упрощает установку lsFusion на Linux.

Примечание 1: Чтобы установить lsFusion для промышленной эксплуатации, нужно выполнить несколько шагов.

Примечание 2: Данный проект тестировался на Ubuntu 16.04, 18.04, 19.04, 19.10 и на Debian 10.1.

Необходимо установить

Прежде всего, вам нужно установить базовые вещи:

  • docker и docker-compose

    Как установить:

    В Ubuntu можно установить командами:

    # docker
    
    sudo apt-get update
    
    sudo apt-get install \
        apt-transport-https \
        ca-certificates \
        curl \
        gnupg-agent \
        software-properties-common
    
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
    
    sudo add-apt-repository \
       "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
       $(lsb_release -cs) \
       stable"
    
    sudo apt-get update && sudo apt-get install docker-ce docker-ce-cli containerd.io
    
    sudo usermod -aG docker $USER
    
    # docker-compose 1.25.3
    
    sudo curl -L "https://github.com/docker/compose/releases/download/1.25.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
    
    sudo chmod +x /usr/local/bin/docker-compose
    

    Разработчики docker вежливо сообщают, что не рекомендуют использовать старые версии докера, и начинают инструкцию с команд деинсталляции старых версий. На момент создания этого README, команда sudo apt install docker docker-compose устанавливает именно старые версии докера. Установите так, как написано по ссылке https://docs.docker.com/install.

    Причечание: на момент создания этого README, по ссылке docker-compose приведены команды для установки docker-compose версии 1.25.3. Обязательно посмотрите на процедуру правильной установки по ссылке https://docs.docker.com/compose/install/.

  • IntelliJ IDEA

    Как установить:

    Для работы с демонстрационными примерами достаточно установить Community Edition. В Ubuntu IDEA Community Edition можно найти в штатной утилите Ubuntu software или установить безо всяких заморочек через snap:

    sudo snap install intellij-idea-community --classic 
    
  • lsFusion plugin для IntelliJ IDEA

    Как установить:
    • откройте File \ Settings \ Plugins в IDEA
    • найдите плагин lsFusion и нажмите Install

Как запустить lsFusion в браузере

  1. скачайте и распакуйте ZIP-архив проекта lsfusion-samples или склонируйте проект на свой компьютер:

    $ git clone https://github.com/mazzy-ax/lsfusion-samples.git
    
  2. войдите в каталог проекта

    $ cd lsfusion-samples
    
  3. выполните команду docker-compose up -d, чтобы запустить сервер базы данных и lsFusion-client

    $ docker-compose up -d
    
  4. откройте каталог проекта в IntelliJ IDEA

    • разрешите maven'у открыть pom.xml и синхронизировать зависимости
    • обязательно дождитесь пока maven загрузит все зависимости
    • иногда приходится делать повторную команду на синхрониацию зависимостей - нажмите Reimport All Maven Projects в окне Maven
    • перед первым билдом укажите Project SDK, который предпочитаете (File \ Project Structure \ Project Settings \ Project \ Project SDK)
  5. выберите конфигурацию с примером. Например, lsFusion server: hockeystats (Run \ Edit configurations...)

  6. запустите эту конфигурацию (Run \ Run 'lsFusion server: hockeystats')

  7. откройте в браузере страницу по адресу localhost:8080

Необходимо установить для desktop-клиента lsFusion

  • установите ПО из раздела Необходимо установить

  • java 8+

    Примечание:

    В Ubuntu достаточно выполнить команду:

    sudo apt install default-jdk
    
  • (опционально) IcedTea Web Control для запуска desktop-клиента lsFusion по jnlp-ссылке

    Как установить:

    IcedTea Web Control — это проект, который позволяет запускать java-апплеты при помощи jnlp-ссылок.

    Инструкции по установке можно найти на сайте проекта IcedTea Web Control. В Ubuntu можно найти и установить в штатной утилите Ubuntu software или командой:

    sudo apt update
    sudo apt install icedtea-netx
    

    Примечание 1: В IntelliJ IDEA выберите интересную вам конфигурацию и запустите Build. IntelliJ IDEA начнет компиляцию и build модуля lsFusion. Когда билд модуля подходит к концу, в log пишется jnlp-ссылка на desktop-клиента. Если нажать на нее, то IceTea Web Control автоматически запустит desktop-клиент.

    Если не установить IcedTea Web Control, то desktop-клиент придется запускать вручную.

    Примечание 2: Вы можете убрать назойливый splash, установив переменные окружения:

    ICEDTEA_WEB_PLUGIN_SPLASH=none
    ICEDTEA_WEB_SPLASH=none
    
  • (опционально) jar-файл с desktop-клиентом lsFusion

    Как использовать:
    • Скачайте desktop-клиент lsFusion версии 3.0 по ссылке: https://download.lsfusion.org/java/lsfusion-client-3.0.jar

    • Войдите в каталог, куда скачали файл, и выполните команду java -jar lsfusion-client-3.0.jar

    • Чтобы скачанный файл можно было запускать щелчком мышки, сделайте скачанный файл исполняемым (executable) командой:

      `chmod +x lsfusion-client-3.0.jar`
      

Как запустить desktop-клиент

  1. скачайте и распакуйте ZIP-архив проекта lsfusion-samples или склонируйте проект на свой компьютер:

    $ git clone https://github.com/mazzy-ax/lsfusion-samples.git
    
  2. войдите в каталог проекта lsfusion-samples

    $ cd lsfusion-samples
    
  3. выполните команду docker-compose up -d, чтобы запустить сервер базы данных и lsFusion-client

    $ docker-compose up -d
    
  4. откройте каталог проекта в IntelliJ IDEA

    • разрешите maven'у открыть pom.xml и синхронизировать зависимости
    • обязательно дождитесь пока maven загрузит все зависимости
    • иногда приходится делать повторную команду на синхрониацию зависимостей - нажмите Reimport All Maven Projects в окне Maven
    • перед первым билдом укажите Project SDK, который предпочитаете (File \ Project Structure \ Project Settings \ Project \ Project SDK)
  5. выберите конфигурацию с примером. Например, lsFusion server: hockeystats (Run \ Edit configurations...)

  6. запустите эту конфигурацию (Run \ Run 'lsFusion server: hockeystats')

  7. запустите desktop-клиент:

    • если у вас установлен IcedTea Web Control, то кликните на jnlp-ссылку, которая появится в конце build-лога в информационном окне Run
    • или запустите jar-файл с desktop-клиентом lsFusion

Дополнительно для Linux

Docker plugin для IntelliJ IDEA

Docker plugin позволяет работать с докером непосредственно из IntelliJ IDEA. Плагин уже включен в Ultimate edition. В IDEA Community edition его нужно установить.

Как установить:
  • откройте File \ Settings \ Plugins в IDEA
  • найдите плагин Docker и нажмите Install

Как запустить pgadmin в браузере

  1. скачайте и распакуйте ZIP-архив проекта или склонируйте проект на свой компьютер:

    $ git clone https://github.com/mazzy-ax/lsfusion-samples.git
    
  2. войдите в каталог проекта lsfusion-samples

    $ cd lsfusion-samples
    
  3. выполните команду docker-compose up -d, чтобы запустить сервер базы данных и lsFusion-client

    $ docker-compose up -d
    
  4. откройте в браузере страницу по адресу localhost:5050

  5. в первый раз pgadmin спросит email и пароль администратора.

    • введите email: pgadmin4@pgadmin.org
    • введите пароль: 11111
  6. в первый раз pgadmin автоматически добавит сервер с базой данных и попросит пароль администратора postgres

    • введите пароль: 11111
    • если хотите, установите галочку Save password