NebulaBootstrap

NebulaBootstrap представляет собой комплексное решение «всё в одном» для установки и развёртывания Nebula. Оно подходит как для одиночных серверов, так и для распределённых сервисов и может быть легко установлено с помощью NebulaBootstrap.

Ядром NebulaBootstrap являются несколько скриптов оболочки, а его структура каталогов соответствует структуре каталогов проекта Nebula во время выполнения. Проект NebulaBootstrap обновляется вместе с проектом Nebula или остаётся неизменным в зависимости от необходимости.

• Структура каталогов NebulaBootstrap:

  • bin — путь к файлам bin сервера;
  • build — путь для создания (можно удалить после развёртывания, если больше не требуется);
  • conf — путь к конфигурационным файлам;
  • data — путь к данным файлов, например, данные точек взаимодействия на основе Nebula, собранные и проанализированные в реальном времени Nebio (https://github.com/Bwar/Nebio), размещаются здесь (необязательно);
  • lib — путь к библиотекам, необходимым для запуска;
  • log — путь к журналам программы;
  • plugins — путь к плагинам (динамически загружаемая бизнес-логика so);
    • logic — путь к логическим плагинам сервера (необязательно, можно хранить непосредственно в каталоге plugins);
  • script — путь к библиотеке скриптов, включая deploy.sh, startup.sh и shutdown.sh;
  • temp — путь к временным файлам (необязательно).
  • configure.sh — скрипт конфигурации, который выполняется перед первым запуском сервера после развёртывания для выполнения простой настройки или настройки каждого файла конфигурации по отдельности;
  • deploy.sh — сценарий автоматического построения и развёртывания, который автоматически загружает и устанавливает зависимости, автоматически строит и развёртывает;
  • shutdown.sh — закрывает сервер, может закрыть один или несколько серверов или все серверы, если не указан параметр, закрывает все серверы (требуется подтверждение пользователя);
  • startup.sh — запускает сервер, может запустить один или несколько серверов или все серверы.
  • README_cn.md — файл;
  • README.md — файл.

Файлы конфигурации хранятся в каталоге conf. Обычно они содержат конфигурацию запуска сервера и пользовательские настройки для бизнеса. Имя файла конфигурации запуска сервера должно соответствовать имени двоичного файла в каталоге bin, добавленного с расширением .json, иначе служба не сможет запуститься нормально. Например, двоичный файл NebulaBeacon в каталоге bin соответствует файлу конфигурации conf/NebulaBeacon.json. Это строгое требование введено для удобства управления и наглядности, что также является одним из стандартов развёртывания Nebula. Пользовательские файлы конфигурации могут иметь любое имя и формат, но рекомендуется использовать формат json.

Установка

NebulaBootstrap упрощает развёртывание Nebula, требуя лишь нескольких шагов: получение источника установки, распаковка установочного пакета и установка с помощью одной команды.

Если в системе отсутствует инструмент autotool, сначала установите его. В Ubuntu используйте apt-get для установки, в CentOS используйте yum для установки. Ниже приведён пример установки в CentOS:

sudo yum install -y gcc gcc-c++
sudo yum install -y autoconf automake libtool

Установка:

1. Получите источник установки:

   wget https://github.com/Bwar/NebulaBootstrap/archive/master.zip

2. Распакуйте установочный пакет и предоставьте скриптам права на выполнение:

   unzip master.zip; rm master.zip; mv NebulaBootstrap-master NebulaBootstrap; cd NebulaBootstrap; chmod u+x deploy.sh

3. Установите с помощью одной команды:

   ./deploy.sh

Здесь для простоты установки и тестирования все распределённые службы развёрнуты в одном каталоге, и каждый сервис запускает только один рабочий процесс. На практике, при развёртывании в производственной среде, обычно на каждой машине развёртывается только одна служба, и количество рабочих процессов совпадает с количеством ядер процессора машины. При развёртывании в рабочей среде каждая служба имеет ту же структуру каталогов, что и NebulaBootstrap, каталог build не нужен, а в каталоге plugins нет необходимости создавать подкаталоги, и сценарий deploy.sh также можно удалить.