# Конструктор приложений

## Введение

Конструктор приложений ARTA SYNERGY - отдельный модуль платформы, позволяющий разработчику SYNERGY создавать и настраивать произвольные приложения на основе компонентов платформы. Использование основных возможностей Конструктора не требует от разработчика SYNERGY навыков написания кода на JavaScript, Java и других языках программирования. При этом, в случае необходимости кастомизации приложений (использования дополнительного скриптинга или настройки стилей), такая возможность представлена и не потребует больших усилий разработчика.

## Установка пакета

Пакет Конструктора `arta-synergy-apps-constructor` устанавливается из репозитория

`deb http://deb.arta.kz/tengri product-stable main contrib non-free`.

При этом необходимо, чтобы на сервере уже был установлен пакет `arta-synergy-synergy` из репозитория `minsky`.

### Процедура установки

Для установки пакета необходимо выполнить команды (в консоли сервера):

- установить или обновить пакет `arta-synergy-synergy`;

- открыть список репозиториев:

      # nano /etc/apt/sources.list

- добавить в список строку

      deb http://deb.arta.kz/tengri product-stable main contrib non-free

- обновить репозитории:

      # aptitude update

- установить пакет `arta-synergy-apps-constructor`:

      # aptitude install arta-synergy-apps-constructor

### После установки

После установки необходимо в Административном приложении `/SynergyAdmin` выполнить:

- Обновление БД
- Добавить пользователю, который будет использовать Конструктор, роль “Конструктор web-клиента”:

Приложение Конструктора доступно по адресу: `http[s]://<host>:<port>/constructor`. Это приложение требует авторизации от имени пользователя с ролью “Конструктор web-клиента”.

## Обновление пакета

Для обновления уже установленного Конструктора приложений до актуальной версии необходимо:

- убедиться, что нужная ветка указана в `sources.list`

- обновить репозитории:

  >     # aptitude update

- установить пакет `arta-synergy-apps-constructor`:

      # aptitude install arta-synergy-apps-constructor

- в Административном приложении `/SynergyAdmin` выполнить обновление БД.

## Настройка nginx при использовании DNS-имени на стенде

Конструктор приложений версии 2.2 работает с web-сокетами. Если к стенду с Конструктором обращаться по IP, то, как правило, проблем при работе с приложениями не возникает. Однако если дать стенду DNS-имя (например, `demostand.arta.pro`), то страницы приложения могут не открываться. Для исправления этой проблемы необходимо на стенде, где настроено DNS-имя для стенда (как правило, это `192.168.1.1`), прописать в конфигурационные файлы настройки для работы сокетов.

В `nginx.conf` в `http` прописать:

>     map $http_upgrade $connection_upgrade {
>     default upgrade;
>     ''      close;}
>     upstream websocket {
>     server 127.0.0.1:8080;
>     }

В `synergy.base`:

>     location /constructor/websocket {
>     proxy_pass http://websocket;
>     proxy_http_version 1.1;
>     proxy_set_header Upgrade $http_upgrade;
>     proxy_set_header Connection "Upgrade";
>     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
>     }

В случае добавления `ws` для нескольких серверов на `DNS`-сервере запись `upstream` в `nginx.conf` может выглядеть так:

>        upstream websocket {
>     server 192.168.3.1:8080;
>     server 192.168.3.2:8080;
>     }

Read the Docs v: latest

Versions
  latest

Downloads
  pdf
  docx
  htmlzip
  epub

On Read the Docs
  Project Home
  Builds

Free document hosting provided by Read the Docs.