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

10min
Данная инструкция описывает подготовку и миграцию Пассворка, установленного в Windows Server, на Docker, установленный на Linux.
Данная инструкция предназначена для одиночной установки Пассворка и не подходит для отказоустойчивого решения.
Подготовка
Создание резервной копии MongoDB
Открыть powershell.exe от имени Администратора и перейти в директорию — cd "C:\Program Files\MongoDB\Server\x.x\bin"
Примеры создания резервной копии:
Локальная установка (MongoDB) без авторизации — mongodump.exe --archive="mongo.dump"
Локальная установка (MongoDB) с авторизацией — mongodump.exe --authenticationDatabase admin --username=username --password=password --archive="mongo.dump"
Установка (MongoDB) на отдельном сервере — mongodump --host host:port  --authenticationDatabase admin --username=username --password=password --archive="mongo.dump"
Копирование файла config.ini и лицензионного ключа
Создать копию конфигурационного файла config.ini, по умолчанию расположенного:
Ручная установка — C:\inetpub\wwwroot\app\config\config.ini
С помощью установщика Windows — C:\inetpub\wwwroot\passwork\app\config\config.ini
Создать копию лицензионного ключа passwork-*.keys, по умолчанию расположенного:
Ручная установка — C:\inetpub\wwwroot\app\keys\passwork-*.keys
С помощью установщика Windows — C:\inetpub\wwwroot\passwork\app\keys\passwork-*.keys
Копирование сертификата
Если установка в Docker будет использовать тоже доменное имя и SSL сертификат, что и предыдущая установка Пассворка. Необходимо скопировать SSL сертификат, в ручную (полная цепочка сертификатов в pfx), или воспользоваться следующим PowerShell кодом:
PowerShell
$iisCerts = Get-ChildItem -Path "cert:\LocalMachine\My"

if ($iisCerts.Count -eq 0) {
    Write-Host "Сертификаты из IIS не найдены."
} else {
    Write-Host "Список сертификатов из IIS:"
    for ($i = 0; $i -lt $iisCerts.Count; $i++) {
        $cert = $iisCerts[$i]
        Write-Host "$($i+1). Subject: $($cert.Subject), Issuer: $($cert.Issuer), Действителен с: $($cert.NotBefore), Действителен до: $($cert.NotAfter)"
    }
    # Просим пользователя выбрать сертификат
    $selectedIndex = Read-Host "Выберите номер сертификата для экспорта"

    if ($selectedIndex -ge 1 -and $selectedIndex -le $iisCerts.Count) {
        $selectedCert = $iisCerts[$selectedIndex - 1]
        do {
            $scriptDirectory = $PWD
            # Указываем путь к файлу PFX в текущей директории
            $pfxFilePath = Join-Path -Path $scriptDirectory -ChildPath "passwork.pfx"
            # Проверяем, можно ли записать файл в указанную директорию
            if (-not (Test-Path $pfxFilePath -IsValid)) {
                Write-Host "Недостаточно прав для записи файла в указанную директорию."
                continue
            }
            break
        } while ($true)
        # Экспортируем сертификат в файл PFX
        Export-PfxCertificate -Cert $selectedCert -FilePath $pfxFilePath -Password (ConvertTo-SecureString -String "default" -Force -AsPlainText)
        Write-Host "Сертификат успешно экспортирован в $pfxFilePath."
    } else {
        Write-Host "Некорректный номер сертификата."
    }
}
$iisCerts = Get-ChildItem -Path "cert:\LocalMachine\My"

if ($iisCerts.Count -eq 0) {
    Write-Host "Сертификаты из IIS не найдены."
} else {
    Write-Host "Список сертификатов из IIS:"
    for ($i = 0; $i -lt $iisCerts.Count; $i++) {
        $cert = $iisCerts[$i]
        Write-Host "$($i+1). Subject: $($cert.Subject), Issuer: $($cert.Issuer), Действителен с: $($cert.NotBefore), Действителен до: $($cert.NotAfter)"
    }
    # Просим пользователя выбрать сертификат
    $selectedIndex = Read-Host "Выберите номер сертификата для экспорта"

    if ($selectedIndex -ge 1 -and $selectedIndex -le $iisCerts.Count) {
        $selectedCert = $iisCerts[$selectedIndex - 1]
        do {
            $scriptDirectory = $PWD
            # Указываем путь к файлу PFX в текущей директории
            $pfxFilePath = Join-Path -Path $scriptDirectory -ChildPath "passwork.pfx"
            # Проверяем, можно ли записать файл в указанную директорию
            if (-not (Test-Path $pfxFilePath -IsValid)) {
                Write-Host "Недостаточно прав для записи файла в указанную директорию."
                continue
            }
            break
        } while ($true)
        # Экспортируем сертификат в файл PFX
        Export-PfxCertificate -Cert $selectedCert -FilePath $pfxFilePath -Password (ConvertTo-SecureString -String "default" -Force -AsPlainText)
        Write-Host "Сертификат успешно экспортирован в $pfxFilePath."
    } else {
        Write-Host "Некорректный номер сертификата."
    }
}
﻿
Установка
Установка основных компонентов
Установить 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 ./windows
Поместить в директорию — windows ранее скопированные файлы из этапа «Подготовки»:
Конфигурационный файл — config.ini
Лицензионный ключ — passwork-*.keys
Резервную копию MongoDB
Сертификат веб-сайта Пассворка 
Запуск процесса миграции
Запустить скрипт с флагом -mv — sudo ./passwork_compose_install.sh -mw
Скрипт установки выполнит базовую установку последней версии Пассворка, доступной в вашей лицензии и автоматически запустит скрипт миграции.
Дополнительные настройки после установки
После завершения работы скриптов, проверьте работоспособность новой установки и выполните донастройку если это необходимо
Для добавления корневых сертификатов почтового сервера или 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
﻿
Обновлено 04 Oct 2024
Помогла ли вам эта страница?
Миграция с Linux на Docker
Windows Server