Руководтсво администратора/разработчика

Документация

Интегрированная среда разработки Buildbox

Запуск/настройка

Через панель

Для запуска/остановки проектов используется панель управления проектами.

 

Через терминал (CLI)

Для запуска сервера Buildbox на выделенном сервере/компьютере необходимо существует набор команда:

buildbox команда опции

команда - операции как с текущим проектом, так и с запущенными сервисами

  • run
  • start
  • stop
  • destroy
  • service

опции - зависят от объекта управления

  • --config -c - идентификатор конфигурации, используемой для запуска.
  • --action -a - операция start/stop (для команды service)
  • --name -n - имя запускаемого сервиса (для команды service)

Внимание! Для команды service существует возможност не указывать --config, если вам необходимо запустить системный сервис, либо сервис, который имеет один экзепляр конфигурации (была создана конфигурация в одном экземпляре). В этом случае происходит сканирование всех конфигурационных файлов на предмет совпадения названия сервиса с указанного в команде в пути файла запуска указанного в конфигурации. В случае нахождения, сервис будет запущен с первым найденных конфигурационным файлом, в котором произошло совпадение.

Через REST-запросы

Через REST API возможно управлять состоянием запущенного проекта/сервиса и осуществлять следущие операции:

  • запуск сервиса;
  • остановка сервиса;
  • перезапуск сервиса.

 

Операции с проектом

Структура запросов для осуществляения операций с проектом следующая:

http://адрес_сервера/project/операция/идентификатор_конфигурации

адрес_сервиса - адрес вашей хостовой машины (например: http://mysite.com/)

операция - операция над проектом (run/stop/reload, соответственно запустить/остановить/перезагрузить)

идентификатор_конфигурации - при созании проекта создается конфигурационный файл, который автоматически получает имя равное - идентификатор_проекта.json (например: 2019-03-03T03-46-27Z-40a5ca,json). Конфигурационные файлы сохраняются в директории /ini и хранят текущие настройки, которые будут обработаны при запуске проекта. После изменения настроек объекта в Studio сохраните изменения в конфигурационный файл (нажмите "Сохранить конфигурацию")

 

Операции с сервисами

Проект включает в себя набор сервисов, количество которых зависит от выбранных настроект проекта. По-умолчанию, в одном экземпляре стартуют сервисы API (взаимодействие с базой данных) и GUI Studio (графический редатор проекта)

Также могут быть запущены другие системные сервисы (такие как Proxy, Auth и т.д) см.Системные сервисы контроллера Buildbox.

Структура запросов для осуществляения операций с сервисами следующая:

http://адрес_сервера/service/операция/имя_сервиса/идентификатор_конфигурации

адрес_сервиса - адрес вашей хостовой машины (например: http://mysite.com/)

операция - операция над сервисом (run/stop/reload, соответственно запустить/остановить/перезагрузить)

имя_сервиса - как правило это имя файла сервиса, который был сохранен в директории исполняемых файлов (/upload/имя_проекта/bin)

идентификатор_конфигурации - при созании сервиса создается конфигурационный файл, который автоматически получает имя равное - идентификатор_сервиса.json (например: 2019-03-03T03-46-27Z-40a5c1,json). Конфигурационные файлы сохраняются в директории /ini и хранят текущие настройки, которые будут обработаны при запуске сервиса. После изменения настроек объекта в Studio сохраните изменения в конфигурационный файл (нажмите "Сохранить конфигурацию")

В случае запуска дополнительных копий системных сервисов (например API), настройки которых сохранены в конфигурационном файла проекта, данные настройки будут прочитаны из общего конфигурационного файла проекта.