Миграция с Linux на Docker

13min
Данная инструкция описывает подготовку и миграцию Пассворка, установленного в Linux, на Docker.
Данная инструкция предназначена для одиночной установки Пассворка и не подходит для отказоустойчивого решения.
Подготовка
Проверка версии Пассворка
Проверить установленную версию Пассворка — cat /var/www/app/config/config.php | grep version. Если версия:
Ниже чем 0602xx — необходимо выполнить обновление до актуальной версии﻿.
Ниже чем 06xxxx — необходимо выполнить миграцию на Пассворк 6.
Создание резервной копии MongoDB
Создать резервную копию MongoDB:
Локальная установка (MongoDB) без авторизации — mongodump --archive > mongo.dump
Локальная установка (MongoDB) с авторизацией — mongodump --archive --authenticationDatabase admin --username=username --password=password > mongo.dump
Установка (MongoDB) на отдельном сервере — mongodump --host host:port --archive --authenticationDatabase admin --username=username --password=password > mongo.dump
Копирование файла config.ini и лицензионного ключа
Создать копию конфигурационного файла config.ini, по умолчанию расположенного в — /var/www/app/config/config.ini
Создать копию лицензионного ключа, по умолчанию расположенного в — /var/www/app/keys/passwork-*.keys
Копирование сертификата
Если установка в Docker будет использовать тоже доменное имя и SSL сертификат, что и предыдущая установка Пассворка. Необходимо скопировать SSL сертификаты если настроено HTTPS соединение. Узнать пути к файлам сертификата, ключа и полной цепочки можно с помощью команд:
DEB (Debian, Ubuntu и Astra Linux) — grep -rE 'SSLCertificate(File|ChainFile|KeyFile)' /etc/apache2/sites-enabled/
RMP (RedHat, RedOS и Centos) — grep -rE 'SSLCertificate(File|ChainFile|KeyFile)' /etc/httpd/conf.d/
Установка
Установка основных компонентов
Установить Docker и Docker Compose 
Создать и перейти в директорию, где планируется развёртывание новой Docker сборки Пассворка.
Скачивание скриптов
Скачать скрипт установки — wget https://repos.passwork.ru/repository/passwork_docker/passwork_compose_install.sh
Скачать скрипт миграции — wget https://repos.passwork.ru/repository/passwork_docker/migrate.sh
Назначить права на исполнение — chmod +x ./*.sh
Перенос файлов из этапа «Подготовки»
Создать директорию — mkdir ./linux
Поместить в директорию — linux ранее скопированные файлы из этапа «Подготовки»:
Конфигурационный файл — config.ini
Лицензионный ключ — passwork-*.keys
Резервную копию MongoDB
SSL сертификаты веб-сайта Пассворка 
Запуск процесса миграции
Запустить скрипт с флагом -ml — sudo ./passwork_compose_install.sh -ml
Скрипт установки выполнит базовую установку последней версии Пассворка, доступной в вашей лицензии и автоматически запустит скрипт миграции.
Дополнительные настройки после установки
После завершения работы скриптов, проверьте работоспособность новой установки и выполните донастройку если это необходимо
Для добавления корневых сертификатов почтового сервера или LDAPS протокола в доверенные, необходимо скопировать корневые сертификаты .pem или .crt в директорию ./conf/custom_ca и перезапустить контейнер PHP — docker compose restart passwork_php
Для изменения используемого сертификата SSL, необходимо скопировать сертификат\цепочку сертификатов в ./conf/ssl/fullchain.pem и приватный ключ в ./conf/ssl/privkey.pem и перезапустить контейнер Nginx — docker compose restart passwork_nginx
Возможные проблемы и их решения
Проблема. Ошибка прав на ту или иную базу при попытке создать полную резервную копию:
shell
2024-02-02T06:51:51.712+0000 Failed: error creating intents to dump: error creating intents for database config: error getting collections for database config: (Unauthorized) not authorized on config to execute command { listCollections: 1, filter: {}, lsid: { id: UUID("9601425c-9ae1-4905-8cfc-cdb0b9e15cd5") }, $db: "config" }
2024-02-02T06:51:51.712+0000 Failed: error creating intents to dump: error creating intents for database config: error getting collections for database config: (Unauthorized) not authorized on config to execute command { listCollections: 1, filter: {}, lsid: { id: UUID("9601425c-9ae1-4905-8cfc-cdb0b9e15cd5") }, $db: "config" }
﻿
Решение. Войти в оболочку управления MongoDB под текущим администратором и добавить ему роль:
shell
use admin
db.grantRolesToUser('username', [{
  role: 'backup',
  db: 'admin'
}])
use admin
db.grantRolesToUser('username', [{
  role: 'backup',
  db: 'admin'
}])
﻿
﻿
Обновлено 04 Oct 2024
Помогла ли вам эта страница?
Старый Docker миграция на новый
Миграция с Windows на Docker