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

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

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

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

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

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

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

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

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

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

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

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

2. В поле имени репозитория щелкните Issues.

   

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

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

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

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

• Загрузка журнала миграции репозитория с помощью ADO2GH extension
• Загрузка журнала миграции репозитория с помощью BBS2GH extension
• Загрузка журнала миграции репозитория с помощью GEI extension

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

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

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

gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

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.

• Если вы переносите данные 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 именем файла для скачанного файла.

gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

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 именем файла для скачанного файла.

gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

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.

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

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

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

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

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

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