Skip to content
Java Dockerfile
Branch: master
Clone or download
Pull request Compare This branch is 32 commits ahead, 4 commits behind lsfusion:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.docker
.idea/runConfigurations
betgame
documentation
euroleague
features
hockeystats
mm
tryonline
.gitignore
LICENSE
README.md
docker-compose.yml
pom.xml

README.md

lsfusion-samples

logo

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

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

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

Проект устроен так, что вам не нужно изучать и использовать maven-команды, достаточно запускать конфигурации нужных вам модулей в IntelliJ IDEA.

Оглавление:

Windows

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

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

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

Linux

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

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

Примечание 2: Данный проект тестировался на Ubuntu 16.04, 18.04, 19.04 и на 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.24.1
    
    sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/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.24.1. Обязательно посмотрите на процедуру правильной установки по ссылке 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. откройте в браузере страницу по адресу http://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 версии 2.1 по ссылке: https://download.lsfusion.org/java/lsfusion-client-2.1.jar

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

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

      `chmod +x lsfusion-client-2.1.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. откройте в браузере страницу по адресу http://localhost:5050

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

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

    • введите пароль: 11111
    • если хотите, установите галочку Save password
You can’t perform that action at this time.