Фаза 5. Migrate your repositories from Azure DevOps to Github

Проведите пробный запуск, а затем перенесите репозитории из Azure DevOps в GitHub.

В этой статье

Предпосылки

  • Вы должны были пройти все предыдущие этапы этого руководства.
  • Убедитесь, что вы понимаете данные, которые будут перенесены, и известные ограничения поддержки импорта. Дополнительные сведения см. в разделе Этап 1. Understand migrations from Azure DevOps to GitHub.
  • Хотя и не требуется, рекомендуется остановить работу во время рабочей миграции. Importer не поддерживает разностную миграцию, поэтому любые изменения, которые происходят во время миграции, не будут переноситься. Если вы решили не останавливать работу во время рабочей миграции, необходимо вручную перенести эти изменения.

Сгенерировать скрипт миграции

Если вы хотите перенести несколько репозиториев в 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)чтобы запустить его.

Чтобы создать скрипт миграции, выполните gh ado2gh generate-script команду.

Shell
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME

Замените заполнители в приведенной выше команде следующими значениями.

ЗаполнительЗначение
ИСТОЧНИКИмя исходной организации
НАЗНАЧЕНИЕИмя целевой организации
FILENAMEИмя файла для результирующего скрипта миграции

Если вы используете терминал, используйте .ps1 расширение файла в качестве созданного скрипта, чтобы запустить PowerShell. Вы можете установить PowerShell для Mac или Linux.

Дополнительные аргументы

АргументDescription
--target-api-url TARGET-API-URLЕсли вы переносите данные GHE.com, добавьте --target-api-url TARGET-API-URL, где TARGET-API-URL является базовым URL-адресом API для поддомена предприятия. Например: https://api.octocorp.ghe.com.
--allДобавьте в скрипт дополнительные функциональные возможности, такие как перебор конвейеров, создание команд и настройка интеграции с Azure Boards.
--download-migration-logsСкачайте журнал миграции для каждого перенесенного репозитория. Дополнительные сведения о журналах миграции см. в разделе Доступ к журналам миграции для GitHub Enterprise Importer.

Просмотр скрипта миграции

После создания скрипта просмотрите файл и, при необходимости, измените скрипт.

  • Если есть какие-либо репозитории, которые вы не хотите перенести, удалить или закомментировать соответствующие строки.
  • Если в целевой организации есть другое имя репозиториев, обновите значение соответствующего --target-repo флага.
  • Если вы хотите изменить видимость нового репозитория, обновите значение соответствующего --target-repo-visibility флага. По умолчанию скрипт задает ту же видимость, что и исходный репозиторий.

Проведите пробный запуск

Чтобы выявить проблемы, которые могут быть уникальны для вашего предприятия, мы настоятельно рекомендуем провести пробный запуск вашей миграции. На пробном запуске вы узнаете:

  • Может ли миграция для конкретного репозитория успешно завершиться.
  • Сможете ли вы вернуть мигрированный репозиторий в рабочее состояние.
  • Сколько времени займёт миграция?

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

  1. Создайте тестовую организацию для пробной миграции.

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

  2. Запустите пробные миграции.

  3. Убедитесь, что вы можете выполнить последующие задачи в AUTOTITLE.

  4. Попросите пользователей проверить результаты миграции.

  5. Устраните все проблемы, обнаруженные миграцией пробной версии.

  6. При необходимости удалите тестовую организацию.

Перенос репозиториев

Если ваш пробный запуск прошёл успешно и вы смогли выполнить последующие задачи, можно перейти к реальной миграции.

Предупреждение

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

Дальнейшие шаги

На следующем и заключительном этапе вы выполните последующие задачи, проверите журналы и подготовите свои репозитории к использованию. См . раздел AUTOTITLE.