Описание процесса миграции на версию TeamStorm v3.0

Внимание!

Настоятельно рекомендуется сделать резервную копию системы перед обновлением.

Для обновления на версию TeamStorm v3.0 запустите скрипт ./setup_teamstorm.sh из состава поставки.

При обновлении скрипт выполнит следующие шаги:

Скопирует базы данных TestIt в контейнер database_service. Ниже представлена схема переноса баз данных.
Остановит контейнеры TestIt.
Запустит TeamStorm 3.0. На этом шаге запустятся механизмы миграции, используйте команду docker compose -p teamstorm logs -f для отслеживания.

Внимание!

Обязательно удостоверьтесь в наличии достаточного свободного места на диске перед копированием вложений.
Скрипт использует утилиту rsync, убедитесь в ее наличии.

На последнем шаге нужно перенести данные, которые раньше хранились в разделах TestIt. Это могут быть:

вложения в задачи и страницы;
аватары пользователей;
сертификаты для HTTPS-соединения;
сертификаты доверительных подключений;

По умолчанию разделы docker находятся в /var/lib/docker/volumes/.

Ниже представлена таблица соответствия разделов.

Для переноса вложений и других данных запустите скрипт от имени суперпользователя командой sudo ./copy_minio.sh

Схема переноса БД

%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#660066',
      'primaryTextColor': '#FFFFFF',
      'primaryBorderColor': '#000000',
      'lineColor': '#FFFFFF',
      'secondaryColor': '#000000',
      'tertiaryColor': '#1F2041',
      'fontFamily': 'Helvetica',
      'fontSize': '20pt'
    }
  }
}%%
flowchart TD
    subgraph Migrations
    direction LR
        subgraph TestIT_containers
            direction TB
            id10(db) o--> id11[(testitdb)]
            style id10 fill:#0066CC;
            id12(authdb) o--> id13[(authdb)]
            style id12 fill:#0066CC;
            id14(avatars.db) o--> id15[(avatarsdb)]
            style id14 fill:#0066CC;
            id16(backgrounddb) o--> id17[(backgrounddb)]
            style id16 fill:#0066CC;
            id18(licensedb) o--> id19[(licensedb)]
            style id18 fill:#0066CC;
            id120(globalsearchdb) o--> id121[(globalsearchdb)]
            style id120 fill:#0066CC;
        end
        subgraph Teamstorm_database_service
            direction TB
            id22[(testit_testitdb)]
            id23[(testit_authdb)]
            id24[(testit_avatarsdb)]
            id25[(testit_backgrounddb)]
            id26[(testit_licensedb)]
            id27[(testit_globalsearchdb)]
        end
    id11 x-..-x id22
    id13 o---> id23
    id15 o---> id24
    id17 x-..-x id25
    id19 o---> id26
    id121 x-..-x id27
    end

Таблица соответствия разделов

TestIt	TeamStorm	Описание
testit_minio-data-volume	teamstorm_minio	Каталоги `cwm`, `wiki`, `testit`
testit_avatars-minio-data-volume	teamstorm_minio	Каталог `avatars`
testit_ssl-volume	teamstorm_ssl-volume	Сертификаты `crt` и `key`