Сведения о журналах миграции
При каждом запуске миграции с помощью GitHub Enterprise Importerсоздается журнал миграции. После каждой миграции необходимо проверить журнал миграции, чтобы просмотреть предупреждения о миграции.
В журнале миграции перечислены шаги, которые были выполнены в процессе миграции и содержат дополнительные сведения.
- Предупреждения о миграции, представляющие данные (например, проблемы, запросы на вытягивание или комментарии), которые не переносятся должным образом.
- Кто запустил миграцию
- Источник миграции
- Сколько времени занимает миграция
Журнал миграции для миграции репозитория можно получить несколькими способами.
- На GitHub, просмотрев проблему "Журнал миграции" в перенесенном репозитории. Эту проблему можно использовать для обсуждения любых предупреждений с командой и записи любых решений.
- Скачав файл журнала с помощью GitHub CLI.
При миграции организации GitHub Enterprise Importer дополнительно создает репозиторий с именем gei-migration-results
в целевой организации. Этот репозиторий содержит сведения о миграции данных уровня организации и дублирует сведения в проблемах журнала миграции для каждого перенесенного репозитория.
Дополнительные сведения о интерпретации предупреждений в журнале миграции см. в разделе "Устранение неполадок миграции с помощью GitHub Enterprise Importer".
Просмотр журнала миграции репозитория на GitHub
Пользователи с доступом на чтение к репозиторию могут получить доступ к журналу миграции для репозитория на GitHub.
-
Перейдите в перенесенный репозиторий в целевой организации.
-
Щелкните проблему с заголовком "Журнал миграции".
Скачивание журнала миграции репозитория с помощью 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. Требования к 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 именем файла для скачанного файла.
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».
Note
Флаг можно использовать --download-migration-logs
только с миграциями репозитория, а не с миграциями организации.
Доступ к журналу миграции организации
Владельцы целевой организации могут получить доступ к журналу миграции для миграции организации на GitHub.
Чтобы получить доступ к журналу миграции для миграции организации, перейдите в репозиторий с именем gei-migration-results
в целевой организации.
Файл README.md
в корневом каталоге репозитория содержит следующие сведения о миграции организации:
- Любые предупреждения или ошибки, связанные с миграцией данных уровня организации, например параметров и команд
- Количество репозиториев, которые были успешно перенесены, и количество репозиториев, которые не удалось выполнить миграцию
/failure
Каталоги/success
содержат один файл для каждого репозитория, который успешно перенесен или не удалось выполнить миграцию соответственно. Эти файлы соответствуют соглашению REPO_NAME.md
об именовании.
Note
Репозиторий gei-migration-results
создается в начале процесса миграции, но обновляется только с помощью журналов миграции после завершения миграции.