Для облегчения развертывания системы QoW, предусмотрен вариант развертывания при помощи Docker. Для работы сервера на хосте необходим только установленный Docker и встроенный в него плагин Docker Compose, а также открытые и незанятые порты 80 и 8883 в системе (при использовании HTTPS также необходим открытый порт 443).
Система QoW представлена в виде файла конфигурации для инструмента Docker Compose, в котором заданы конфигурации для отдельных контейнеров с Nginx, MQTT сервером, MongoDB сервером и QoW сервером. При развертывании инструмент Docker Compose автоматически создает и настраивает отдельные контейнеры, а также связывает их в общую сеть для их коммуникации, открывая наружу только минимум необходимых портов для работы системы. Модульность системы Compose позволяет гибко настраивать конфигурацию сервера и отдельных его компонентов, что позволяет запускать его как в базовом варианте с минимумом настроек, так и создавать более сложные конфигурации.
Ниже приведена инструкция для развертывания системы QoW в системе Linux, но возможно развертывание и под Windows.
Для развертывания необходимо выполнить следующие действия:
- Установите Docker и Docker Compose, если они еще не установлены в системе. Информацию по установке можно найти в официальной документации к Docker Engine (https://docs.docker.com/engine/install/).
- Создайте директорию, в которой будут храниться конфигурационные файлы и данные из контейнеров, а также необходимые директории для работы контейнеров:
mkdir -p qow-server-docker/ cd qow-server-docker mkdir -p mosquitto/certs/ nginx/
- Скачайте конфигурационный файл
docker-compose.ymlпо данной ссылке TODO и положите его в корень директорииqow-server-docker. - Запросите у нашей службы технической поддержки файлы сертификатов для работы MQTT, написав на почту support@netams.com.
- После получения файлов сертификатов (qow-ca.crt, qow-server.crt, qow-server.key), положите их в созданную ранее директорию
./mosqutto/certs/. Имена файлов обязательно должны быть такими же, иначе измените их имена в файлеdocker-compose.yml. - Откройте файл docker-compose.yml в текстовом редакторе, найдите переменную NETAMS_LICENSE_KEY и замените ее значение LICENSE_KEY на ваш лицензионный ключ.
- Выполните логин в наш Docker Registry для скачивания образа сервера QoW, логин и пароль для входа запросите у службы технической поддержки:
docker login packages.wnam.ru
- После успешной авторизации выполните скачивание всех необходимых для работы образов контейнеров:
docker compose pull
- После скачивания всех образов запустите контейнеры:
docker compose up -d
- После запуска контейнеров перейдите в браузере по адресу http://localhost или по IP адресу хоста, на котором вы запустили контейнеры.
- Просмотреть логи можно при помощи команды
docker compose logs -f -n 0, либо в папке ./qow/logs/. - Обновить образ QoW можно следующими командами:
docker compose down docker compose pull docker compose up -d