Prerequisites
- You must have completed all previous phases of this guide.
- Убедитесь, что вы понимаете данные, которые будут перенесены, и известные ограничения поддержки импорта. For more information, see Understand migrations from Azure DevOps to GitHub.
- Хотя и не требуется, рекомендуется остановить работу во время рабочей миграции. Importer не поддерживает разностную миграцию, поэтому любые изменения, которые происходят во время миграции, не будут переноситься. Если вы решили не останавливать работу во время рабочей миграции, необходимо вручную перенести эти изменения.
Generate a migration script
Если вы хотите перенести несколько репозиториев в GitHub Enterprise Cloud одновременно, используйте GitHub CLI для создания скрипта миграции. Результирующий скрипт будет содержать список команд миграции, по одному на репозиторий.
Примечание.
Создание скрипта выводит скрипт PowerShell. Если вы используете терминал, вам потребуется вывести сценарий с .ps1 расширением файла и установить PowerShell для Mac[ или Linux, ](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-macos?view=powershell-7.2)чтобы запустить его.
To generate a migration script, run the gh ado2gh generate-script command.
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
Замените заполнители в приведенной выше команде следующими значениями.
| Заполнитель | Значение |
|---|---|
| ИСТОЧНИК | Имя исходной организации |
| НАЗНАЧЕНИЕ | Имя целевой организации |
| FILENAME | Имя файла для результирующего скрипта миграции Если вы используете терминал, используйте .ps1 расширение файла в качестве созданного скрипта, чтобы запустить PowerShell. Вы можете установить PowerShell для Mac или Linux. |
Additional arguments
| Argument | Description |
|---|---|
--target-api-url TARGET-API-URL | Если вы переносите данные GHE.com, добавьте --target-api-url TARGET-API-URL, где TARGET-API-URL является базовым URL-адресом API для поддомена предприятия. Например: https:/. |
--all | Add additional functionality to the script, such as rewiring pipelines, creating teams, and configuring Azure Boards integrations. |
--download-migration-logs | Download the migration log for each migrated repository. For more information about migration logs, see Доступ к журналам миграции для GitHub Enterprise Importer. |
Reviewing the migration script
После создания скрипта просмотрите файл и, при необходимости, измените скрипт.
- Если есть какие-либо репозитории, которые вы не хотите перенести, удалить или закомментировать соответствующие строки.
- Если в целевой организации есть другое имя репозиториев, обновите значение соответствующего
--target-repoфлага. - Если вы хотите изменить видимость нового репозитория, обновите значение соответствующего
--target-repo-visibilityфлага. По умолчанию скрипт задает ту же видимость, что и исходный репозиторий.
Perform a trial run
Чтобы выявить проблемы, которые могут быть уникальны для вашего предприятия, мы настоятельно рекомендуем провести пробный запуск вашей миграции. На пробном запуске вы узнаете:
- Может ли миграция для конкретного репозитория успешно завершиться.
- Сможете ли вы вернуть мигрированный репозиторий в рабочее состояние.
- Сколько времени займёт миграция?
Пробные запуски могут проводиться в любое время, и работа не обязательно останавливается во время миграции. Чтобы сократить время, необходимое для завершения миграции пробных версий, можно запланировать пакеты для пробной версии. Пользователи этих репозиториев могут проверять результаты самостоятельно.
-
Create a test organization for your trial migrations.
You can use a single organization for all trial runs, or you can create one test organization for each intended destination organization. Consider including
-sandboxat the end of the organization names, to clarify that the organizations are intended only for migration validation and not for production. You can delete the test organizations after you're done. -
Run the trial migrations.
-
Confirm that you are able to complete the follow-up tasks in Follow-up tasks.
-
Ask users to validate the results of the migrations.
-
Resolve any issues uncovered by your trial migrations.
-
При необходимости удалите тестовую организацию.
Migrate repositories
If your trial run was successful, and you were able to complete the follow-up tasks, you can proceed to the real migration.
Предупреждение
We recommend halting work in the repositories you are migrating. Any changes made during or after the migration will need to be manually migrated.
Чтобы мигрировать несколько репозиториев, запустите сгенерированный вами скрипт. Замените FILENAME в приведенных ниже командах именем файла, указанным при создании скрипта.
-
Если вы используете терминал, используйте
./.Shell ./FILENAME
./FILENAME -
Если вы используете PowerShell, используйте
.\.Shell .\FILENAME
.\FILENAME