Получение экземпляра приложения в виде tar и его установка

Скачивание контейнера

Ссылка на контейнер: https://whiteboard.hb.ru-msk.vkcs.cloud/docker/editboard.tar

Скачать контейнер в текущий рабочий каталог:

wget "https://whiteboard.hb.ru-msk.vkcs.cloud/docker/editboard.tar"

Загрузка контейнера в Docker

После скачивания tar-файла, загрузите его в Docker:

docker load < editboard.tar

Запуск контейнера в режиме установки

Запустите контейнер с загруженным образом в режиме установки, подставив нужные значения:

  • ДОМЕН— доменное имя, на котором работает приложение
  • ДОМЕН ИЛИ IP — имя хоста, на котором работает приложение
  • ПОЛЬЗОВАТЕЛЬ— имя учетной записи, с которой выполняется установка
docker run -it \
--rm \
--network host \
-e TZ=Europe/Moscow \
-e DOMAIN=ДОМЕН \ 
-e HOSTNAME=ДОМЕН ИЛИ IP \
-e WHITEBOARD_MODE=install \
-v /home/ПОЛЬЗОВАТЕЛЬ/docker/conf:/conf \
-v /home/ПОЛЬЗОВАТЕЛЬ/docker/logs_nginx:/var/log/nginx \
-v /home/ПОЛЬЗОВАТЕЛЬ/docker/logs_app:/root/.pm2/logs \
-v /mnt/editboard-storage:/storage \
--name editboard editboard

В результате выполнения:

  • Контейнер будет загружен в Docker.
  • Создадутся конфигурационные файлы и самоподписные сертификаты.

Расположение конфигурационных файлов

Базовое расположение конфигурационных файлов:

/home/user/docker/conf

Здесь находятся:

  • config.json – файл конфигурации приложения
  • nginx.conf – настройки по умолчанию для nginx
  • redis.conf – настройки по умолчанию для Redis

Расположение сертификатов

/home/user/docker/conf/ssl

При необходимости файлы можно заменить своими.

Перед основным запуском необходимо внести необходимые настройки в конфигурационные файлы. В первую очередь это касается config.json.

Подробнее настройка описана в разделах Описание параметров конфигурации приложения и Настройка Object Storage.

Основной запуск

Перед основным запуском остановите запуск контейнера в режиме установки, который вы выполняли на предыдущем шаге:

docker stop editboard

Выполните основной запуск. Убедитесь, что приложение не находится в режиме установки: в config.json должно быть "install": false.

docker run -d \
--rm \
--network host \
-e TZ=Europe/Moscow \
-e DOMAIN=ДОМЕН \
-e HOSTNAME=ДОМЕН ИЛИ IP \
-v /home/ПОЛЬЗОВАТЕЛЬ/docker/conf:/conf \
-v /home/ПОЛЬЗОВАТЕЛЬ/docker/logs_nginx:/var/log/nginx \
-v /home/ПОЛЬЗОВАТЕЛЬ/docker/logs_app:/root/.pm2/logs \
-v /mnt/editboard-storage:/storage \
--name editboard editboard

Примечание

Без запуска в основном режиме не получится проверить работоспособность приложения.

Проверка работоспособности приложения

Без запуска в основном режиме проверить работоспособность не получится.

В зависимости от настройки config.json приведены примеры URL:

  • При запуске тестового модуля: https://editboard.mycorp.com/test/
  • При запуске основной версии личного кабинета: https://editboard.mycorp.com/cabinet/

Для полноценного использования приложения необходимо произвести настройку SSO.