Перейти к содержанию

Импорт страниц из другого инстанса TeamStorm

Документ описывает инструкцию по копированию wiki-страниц пространства из другого инстанса TeamStorm.

Исходные данные

Для копирования страниц пространства из одного инстанса TeamStorm в другой потребуются следующие данные:

  • архив со скриптами импорта
  • URL серверов TeamStorm - исходный и целевой
  • логины и пароли пользователей TeamStorm в исходном и целевом инстансах
  • ключ пространства в исходном инстансе, которое необходимо скопировать
  • ключ пространства в целевом инстансе, в который будет выполнено копирование

Запуск скрипта

  1. Добавьте пользователей в TeamStorm в целевом инстансе перед запуском импорта. E-mail или отображаемое имя пользователей TeamStorm должны совпадать для автоматического маппинга.
  2. Установите среду выполнения Python 3.11.
  3. Перейдите в папку с разархивированными скриптами.
  4. Выполните команды: 
    cd import
export PYTHONPATH=$(pwd)
  5. Установите необходимые для запуска скрипта зависимости. 
    pip install --no-cache-dir -r requirements.txt
  6. Запустите скрипт с нужными параметрами.

Пример вызова скрипта:

python3 ./copy_space/copy_wiki.py \
    "http://src.TeamStorm" "admin" "123456" "WSOLD" \
    "http://dest.TeamStorm" "admin" "123456" "WSNEW"

Обязательные параметры скрипта

Обязательные параметры являются позиционными и должны указываться в следующем порядке:

  • <URL исходного сервера TeamStorm>
  • <логин пользователя на исходном сервере TeamStorm>
  • <пароль пользователя TeamStorm>
  • <ключ исходного пространства>
  • <URL целевого сервера TeamStorm>
  • <логин пользователя на целевом сервере TeamStorm>
  • <пароль пользователя TeamStorm>
  • <ключ целевого пространства>

Дополнительные параметры скрипта

Дополнительные параметры не являются обязательными для запуска скрипта. Указываются в формате --ключ="значение"

  • --from_page_id — идентификатор родительской страницы в исходном пространстве. Скрипт перенесет все её дочерние страницы в целевое пространство. Если параметр не указан, будут перенесены все страницы исходного пространства.
  • --to_page_id — идентификатор родительской страницы в целевом пространстве. Если параметр не указан, страницы будут перенесены в корень целевого пространства.
  • --provider_from — провайдер аутентификации пользователя исходного инстанса.
  • --provider_to — провайдер аутентификации пользователя целевого инстанса.