Для установки решения docker-образы предварительно загружаются из приватного реестра на компьютер с доступом к сети Интернет, а затем переносятся на целевой сервер. На обоих компьютерах должно быть установлено программное обеспечение Docker и Docker Compose одинаковой версии. Подробнее см. в разделе «Комплект поставки и системные требования».

1.На компьютере с доступом к сети Интернет войдите в учетную запись в приватном реестре. Для этого выполните команду:

sudo docker login ciaregistry.directum.ru --username <Имя учетной записи> --password <Пароль учетной записи>

2.Скачайте из приватного реестра Docker новые версии образов с сервисами онлайн-редакторов. Для этого выполните команду:

sudo docker-compose -f docker-compose.yml -f docker-compose.tenant1.yml pull

ВАЖНО. Все команды docker-compose необходимо выполнять из папки, в которую распаковано решение.

3.Запустите скачанные сервисы с помощью команды:

sudo docker-compose -f docker-compose.yml -f docker-compose.tenant1.yml up -d

4.Отобразите список загруженных docker-образов. Для этого из папки со скачанными образами выполните команду:

sudo docker-compose -f docker-compose.yml -f docker-compose.tenant1.yml images

В результате отображается полный список образов с указанием тегов.

5.Сохраните docker-образы в архив формата TAR с помощью команды:

sudo docker save <Список docker-образов решения> > <Название архива>.tar

Образы указываются в формате <Название образа>:<Тег> и отделяются пробелом.

В названии архива рекомендуется указать название и версию решения.

ПРИМЕЧАНИЕ. Выполнение команды может занять некоторое время.

Пример команды:

sudo docker save ciaregistry.directum.ru/collaboration/backend:v1.4.2 ciaregistry.directum.ru/collaboration/documentserver:v1.4.2 ciaregistry.directum.ru/collaboration/haproxy:v1.4.2 umputun/docker-logger:latest postgres:11 rabbitmq:3 redis:5 ciaregistry.directum.ru/collaboration/saver:v1.4.2 ciaregistry.directum.ru/collaboration/service-controller:v1.4.2 ciaregistry.directum.ru/collaboration/static:v1.4.2 > collaboration-1.4.2.tar

6.На сервер, где планируется разворачивать решение:

•скопируйте архив с загруженными docker-образами;

•распакуйте дистрибутив решения в локальную папку, например /srv/collaboration/.

Дальнейшие действия выполняются на этом сервере.

7.В папке со скопированным архивом выполните команду:

sudo docker load < <Название архива>.tar

Пример команды:

sudo docker load < collaboration-1.4.2.tar

В результате отображается список скопированных образов.

8.В папке с дистрибутивом решения в подпапке settings откройте конфигурационный файл tenant1.env. Задайте в нем основные настройки решения:

•CLIENT_HOST – доменное имя веб-клиента, например, rx.company.ru;

•CLIENT_PATH – имя приложения веб-клиента, например, /DrxWeb;

•CLIENT_USERNAME – имя системной учетной записи для работы с онлайн-редакторами. Укажите имя учетной записи пользователя Service User в формате, соответствующем типу аутентификации в Directum RX: внешней или по паролю. Подробнее см. в разделе «Настройка аутентификации»;

•CLIENT_PASSWORD – пароль системной учетной записи.

ВАЖНО. Так как пароль для пользователя Service User хранится в файле tenant1.env в открытом виде, убедитесь, что доступ к файлу имеют только администраторы;

•AUTH_TYPE – тип аутентификации системного пользователя. Возможные значения: password – аутентификация по паролю, windows – аутентификация с помощью учетной записи Windows, adfs – сквозная аутентификация с помощью служб AD FS.

ВАЖНО. Значения параметров не должны содержать символ #, так как этим символом отмечается начало комментария.

9.В папке с дистрибутивом решения в подпапке settings откройте конфигурационный файл settings.share.env. Раскомментируйте в нем параметр JWT_SECRET и укажите в нем строку для генерации JWT-токенов длиной не менее 20 символов. Рекомендуется сгенерировать строку с помощью любого специализированного сервиса генерации безопасных случайных паролей.

10.При необходимости задайте дополнительные настройки решения:

•ограничение доступа к онлайн-редакторам;

•автоматическое отключение сервисов, например, на время проведения технических работ в системе Directum RX;

•использование онлайн-редактора «Р7-Офис. Профессиональный. Сервер документов».

Подробнее см. в разделе «Настройка решения».

11.Запустите сервисы с помощью команды:

sudo docker-compose -f docker-compose.yml -f docker-compose.tenant1.yml up -d

12.Проверьте, что все сервисы запустились. Для этого подождите несколько минут и выполните команду:

sudo docker-compose -f docker-compose.yml -f docker-compose.tenant1.yml ps

Все сервисы должны быть в состоянии Up:

Если у одного или нескольких сервисов состояние Down, обратитесь к лог-файлам сервисов, чтобы выявить причину сбоя.

Чтобы посмотреть лог-файлы всех сервисов, используйте команду:

sudo docker-compose -f docker-compose.yml -f docker-compose.tenant1.yml logs

Чтобы посмотреть лог-файл конкретного сервиса, используйте команду:

sudo docker logs <имя_сервиса (колонка Name)>

Чтобы просматривать ошибки в лог-файле в режиме реального времени, вызовите команду с ключом -f:

sudo docker logs -f <имя_сервиса (колонка Name)>

Устраните причину самостоятельно или обратитесь в службу поддержки Directum RX.

13.Для корректного отображения шрифтов в онлайн-редакторах добавьте используемые в компании шрифты в формате TTF в папку <Папка с установленным решением>/fonts.

СМ. ТАКЖЕ

© Компания Directum, 2024