Миграция со старого Docker на новый

12min
Данная инструкция предназначена для одиночной установки Пассворка и не подходит для отказоустойчивого решения
Подготовка
Проверка версии Пассворка
Проверить установленную версию Пассворка — cat /server/sites/prod/app/config/config.php | grep version.

Если версия:
ниже чем 0602xx — необходимо выполнить обновление до актуальной версии﻿;
ниже чем 06xxxx — необходимо выполнить миграцию на Пассворк 6.
Создание резервной копии MongoDB
Перейти в каталог Пассворка и создать директорию для файлов — cd /server/docker-compose/ && mkdir old_docker
Создать резервную копию MongoDB:
Локальная установка MongoDB без авторизации — docker-compose exec -T db sh -c 'mongodump --archive' > "./old_docker/my.dump"
Локальная установка MongoDB с авторизацией — docker-compose exec -T db sh -c 'mongodump --archive --authenticationDatabase admin --username=your-admin --password=your-password' > "./old_docker/my.dump"
Установка MongoDB на отдельном сервере — docker-compose exec -T db sh -c 'mongodump --host your-host:your-port --archive --authenticationDatabase admin --username=your-admin --password=your-password' > "./old_docker/my.dump"
Копирование файла config.ini и лицензионного ключа
Создать копию файла конфигурации config.ini — cp /server/sites/prod/app/config/config.ini ./old_docker/
Создать копию лицензионного ключа passwork-*.keys — cp /server/sites/prod/app/keys/*.keys ./old_docker/
Копирование сертификата
Если установка в Docker будет использовать то же доменное имя и SSL-сертификат, что и предыдущая установка Пассворка, то при настроенном HTTPS-соединении потребуется скопировать SSL-сертификаты:  cp -Rf /server/conf/ssl/ ./old_docker/
Установка
Установка основных компонентов
Установить Docker и Docker Compose.
Создать и перейти в директорию, где планируется развёртывание новой Docker-сборки Пассворка.
Остановить старый (используемый) контейнер nginx с помощью команды docker stop nginx && docker rm nginx
Загрузка скриптов
Скачать скрипт установки — 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
Перенос файлов из этапа подготовки
Перенести созданную директорию ./old_docker в каталог, где планируется развёртывание новой Docker-сборки
В директории должны находиться следующие файлы:
Конфигурационный файл — config.ini
Лицензионный ключ — passwork-*.keys
Резервная копия MongoDB
SSL-сертификаты веб-сайта Пассворка
Запуск процесса миграции
Запустить скрипт с флагом -md — sudo ./passwork_compose_install.sh -md
Скрипт установки выполнит базовую установку последней версии Пассворка, доступной в вашей лицензии и автоматически запустит скрипт миграции.
Опциональные шаги после установки
После завершения работы скриптов, проверьте работоспособность новой установки и выполните донастройку если это необходимо
Для добавления корневых сертификатов почтового сервера или 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'
}])
﻿
﻿
Обновлено 23 Jan 2025
Помогла ли вам эта страница?
Миграция на Docker
Миграция с Linux на Docker