Развертывание сервера приложений в Docker

Замечание

Для получения docker-образа Колибри-Сфера потребуется подключение к репозиторию https://hub.docker.octonica.com. Репозиторий с ограниченным доступом. Доступ предоставляется по запросу.

Логин в репозиторий hub.docker.octonica.com

Получив логин и пароль для доступа к репозиторию образов hub.docker.octonica.com, потребуется подключиться к нему с использованием команды:

docker login hub.docker.octonica.com

Укажите предоставленный вам логин и пароль.

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

Конфигурация сервера приложений Колибри-Сфера требует наличия или создания двух постоянных хранилищ. Первое хранилище должно монтироваться в директорию /etc/opt/colibri/ и необходимо для хранения настроек сервера приложений. Второе должно быть смонтировано в директорию /var/opt/colibri/ и предназначено для хранения лицензионного файла (/var/opt/colibri/*.colibrikey), настроек моделей (/var/opt/colibri/app/) и файлов журналов (/var/opt/colibri/log/).
Описание файловой структуры платформы Колибри для ОС семейства Debian.

Docker-образ hub.docker.octonica.com/colibri-release/web содержит последнюю версию сервера приложений.

Ниже приведен пример конфигурации для запуска контейнера с использованием инструмента docker compose.

В этом примере монтируются два постоянных хранилища в виде локальных папок на хосте: для настроек сервера приложений (относительный путь ./etc) и для настроек используемых моделей (относительный путь ./var). В сервисе init в смонтированные разделы производится копирование конфигурации сервера приложений Колибри-Сфера по умолчанию, а также структуры папок для настроек моделей и файлов журналов. После первого запуска потребуется выполнить донастройку сервера приложений Колибри-Сфера.

Замечание

При первом запуске сервис init копирует конфигурацию по умолчанию из контейнера в смонтированные папки на хосте. Копирование выполняется без перезаписи существующих файлов, поэтому вы можете изменить конфигурацию в смонтированных папках перед запуском или после первого запуска. При последующих запусках существующие файлы не изменяются.

Файл docker-compose.yml:

services:
  init:
    image: hub.docker.octonica.com/colibri-release/web
    volumes:
      - ./etc:/etc/opt/colibri
      - ./var:/var/opt/colibri
    command: /bin/bash -c "cp -n -R /tmp/etc/opt/colibri/* /etc/opt/colibri/ && cp -n -R /tmp/var/opt/colibri/* /var/opt/colibri/"
  web:
    image: hub.docker.octonica.com/colibri-release/web
    volumes:
      - ./etc:/etc/opt/colibri
      - ./var:/var/opt/colibri
    ports:
      - "5000:5000"
    depends_on:
      - init

Замечание

Использование в качестве постоянных хранилищ локальных папок на хосте приведено исключительно для примера. Вы же можете выбрать хранилища любого другого типа.

Для первого запуска из директории с файлом docker-compose.yml потребуется выполнить команду:

docker compose up

Замечание

Для запуска в фоновом режиме в приведенных выше командах нужно добавить опцию -d.

Настройка сервера приложений Колибри-Сфера

В примере выше смонтированные разделы для хранения настроек и моделей приложений содержат относительные пути ./etc и ./var соответственно. Для краткости назовем эти разделы etc и var, а ниже эти названия будут использоваться для ссылок на соответствующие смонтированные разделы.

Для настройки сервера приложений Колибри-Сфера требуется выполнить три шага:

1. Установить файл лицензии.
2. Установить настройки моделей (настройки конкретного приложения, построенного на базе Колибри-Сфера).
3. Внести изменения в colibriSettings.json.

Установка файла лицензии

Для работы Колибри-Сфера требуется файл действующей лицензии *.colibrikey.
Файл лицензии *.colibrikey требуется поместить в корень раздела var.

Установка настроек моделей

Конкретные приложения (модели) обладают своими уникальными настройками. Для работы с такими приложениями у разработчиков необходимо получить папку с данными настройками.
Настройки моделей должны быть помещены в раздел var в директорию app.

Настройка сервера приложений

Все настройки сервера приложений вне зависимости от вида инсталляции находятся в файле конфигурации colibriSettings.json и описаны в соответствующем разделе. Файл конфигурации colibriSettings.json должен находиться в корне смонтированного раздела etc.

Просмотр журнала

В случае ошибок запуска Колибри-Сфера или необходимости просмотреть журнал, файл текстового журнала на текущую дату может быть найден в смонтированном разделе var в папке log и называется colibri.log.