lsfusion-samples

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

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

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

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

Оглавление:

• Windows
• Linux
  • Необходимо установить
  • Как запустить lsFusion в браузере
  • Необходимо установить для desktop-клиента lsFusion
  • Как запустить desktop-клиент
• Дополнительно для Linux
  • Docker plugin для IntelliJ IDEA
  • Как запустить pgadmin в браузере

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