Доступ к журналам миграции для GitHub Enterprise Importer

После выполнения миграции необходимо просмотреть журнал миграции, чтобы проверить наличие данных, которые не переносятся должным образом.

В этой статье

Сведения о журналах миграции

При каждом запуске миграции с помощью GitHub Enterprise Importerсоздается журнал миграции. После каждой миграции необходимо проверить журнал миграции, чтобы просмотреть предупреждения о миграции.

В журнале миграции перечислены шаги, которые были выполнены в процессе миграции и содержат дополнительные сведения.

  • Предупреждения о миграции, представляющие данные (например, проблемы, запросы на вытягивание или комментарии), которые не переносятся должным образом.
  • Кто запустил миграцию
  • Источник миграции
  • Сколько времени занимает миграция

Журнал миграции для миграции репозитория можно получить несколькими способами.

  • На GitHub, просмотрев проблему "Журнал миграции" в перенесенном репозитории. Эту проблему можно использовать для обсуждения любых предупреждений с командой и записи любых решений.
  • Скачав файл журнала с помощью GitHub CLI.

При миграции организации GitHub Enterprise Importer дополнительно создает репозиторий с именем gei-migration-results в целевой организации. Этот репозиторий содержит сведения о миграции данных уровня организации и дублирует сведения в проблемах журнала миграции для каждого перенесенного репозитория.

Дополнительные сведения о интерпретации предупреждений в журнале миграции см. в разделе "Устранение неполадок миграции с помощью GitHub Enterprise Importer".

Просмотр журнала миграции репозитория на GitHub

Пользователи с доступом на чтение к репозиторию могут получить доступ к журналу миграции для репозитория на GitHub.

  1. Перейдите в перенесенный репозиторий в целевой организации.

  2. Щелкните проблему с заголовком "Журнал миграции".

Скачивание журнала миграции репозитория с помощью GitHub CLI

Владельцы организации и члены организации с ролью миграции могут скачать журналы миграции с помощью GitHub CLI.

С помощью команды можно скачать последний журнал миграции для отдельного репозитория download-logs . Точную команду зависит от источника миграции.

Журналы миграции доступны для скачивания в течение 24 часов после завершения миграции.

Скачивание журнала миграции репозитория с помощью ADO2GH extension

Если источник миграции — Azure DevOps, можно скачать последний журнал миграции для отдельного репозитория с gh ado2gh download-logs помощью команды. Замените DESTINATION целевой организацией, РЕПОЗИТОРИЙ именем репозитория и FILENAME именем файла для скачанного файла.

Shell
gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • Если у вас еще нет GH_PAT переменной среды для personal access token с доступом к целевой организации, добавьте --github-target-pat TOKEN, заменив TOKEN personal access token. Требования к personal access token см. в разделе "Управление доступом к миграции из Azure DevOps".
  • Если вы переносите данные GHE.com, добавьте --target-api-url TARGET-API-URL, где TARGET-API-URL является базовым URL-адресом API для поддомена предприятия. Например: https://api.octocorp.ghe.com.

Скачивание журнала миграции репозитория с помощью BBS2GH extension

Если источник миграции — Bitbucket Server, можно скачать последний журнал миграции для отдельного репозитория с gh bbs2gh download-logs помощью команды. Замените DESTINATION целевой организацией, РЕПОЗИТОРИЙ именем репозитория и FILENAME именем файла для скачанного файла.

Shell
gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • Если у вас еще нет GH_PAT переменной среды для personal access token с доступом к целевой организации, добавьте --github-target-pat TOKEN, заменив TOKEN personal access token. Требования к personal access token см. в разделе "Управление доступом к миграции с сервера Bitbucket".
  • Если вы переносите данные GHE.com, добавьте --target-api-url TARGET-API-URL, где TARGET-API-URL является базовым URL-адресом API для поддомена предприятия. Например: https://api.octocorp.ghe.com.

Скачивание журнала миграции репозитория с помощью GEI extension

Если источником миграции является продукт GitHub, можно скачать последний журнал миграции для отдельного репозитория с gh gei download-logs помощью команды. Замените DESTINATION целевой организацией, РЕПОЗИТОРИЙ именем репозитория и FILENAME именем файла для скачанного файла.

Shell
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • Если у вас еще нет GH_PAT переменной среды для personal access token с доступом к целевой организации, добавьте --github-target-pat TOKEN, заменив TOKEN personal access token. Требования к personal access token см. в разделе "Управление доступом к миграции между продуктами GitHub".
  • Если вы переносите данные GHE.com, добавьте --target-api-url TARGET-API-URL, где TARGET-API-URL является базовым URL-адресом API для поддомена предприятия. Например: https://api.octocorp.ghe.com.

Скачивание всех журналов миграции репозитория для скрипта миграции

Чтобы обеспечить доступ к журналам миграции для всех перенесенных репозиториев, можно использовать --download-migration-logs флаг при создании скрипта миграции для миграции репозиториев. При использовании этого флага скрипт будет включать download-logs команду для каждого репозитория, перенесенного в скрипт. Дополнительные сведения см. в разделе Сведения о GitHub Enterprise Importer.

Примечание. Флаг можно использовать --download-migration-logs только с миграцией репозитория, а не с миграцией организации.

Доступ к журналу миграции организации

Владельцы целевой организации могут получить доступ к журналу миграции для миграции организации на GitHub.

Чтобы получить доступ к журналу миграции для миграции организации, перейдите в репозиторий с именем gei-migration-results в целевой организации.

Файл README.md в корневом каталоге репозитория содержит следующие сведения о миграции организации:

  • Любые предупреждения или ошибки, связанные с миграцией данных уровня организации, например параметров и команд
  • Количество репозиториев, которые были успешно перенесены, и количество репозиториев, которые не удалось выполнить миграцию

/failure Каталоги/success содержат один файл для каждого репозитория, который успешно перенесен или не удалось выполнить миграцию соответственно. Эти файлы соответствуют соглашению REPO_NAME.mdоб именовании.

Примечание. Репозиторий gei-migration-results создается в начале процесса миграции, но обновляется только с помощью журналов миграции после завершения миграции.