3. Запуск миграции

1. Войдите в Azure CLI:

   az login
   

2. Задайте организацию Azure DevOps по умолчанию:

   az devops configure --defaults organization=https://dev.azure.com/myorg
   

   Подсказка

   Если ваш локальный удалённый репозиторий Git указывает на другую организацию, добавьте --detect false ко всем командам миграции, чтобы механизм автоопределения не выбрал неправильную организацию.

3. Проверьте доступ:

   az devops project list
   

4. Получите GUID репозитория:

   az repos show --org https://dev.azure.com/<org>
                 --project <project>
                 --repository <repo-name>
                 --query id
                 -o tsv
   

1. Войдите в свою организацию Azure DevOps по адресу https://dev.azure.com/<org>.
2. Откройте целевой project и выберите параметры Project.
3. Выберите репозитории и подтвердите наличие репозитория, который планируется перенести.
4. Оставьте портал открытым, чтобы позже проверить состояние агента в разделе Параметры проекта>Пулы агентов.

Начните с этой базовой команды для каждой миграции:

az devops migrations create --org https://dev.azure.com/<org>
                            --repository-id <repo-guid>
                            --target-repository https://github.com/<org>/<repo>
                            --github-token <github-pat>
                            --service-endpoint-id <service-connection-guid>
                            --agent-pool <agent-pool-name>

В --target-repository, <repo> — это имя репозитория GitHub. Выберите любое доступное имя. Необязательно, чтобы оно совпадало с именем репозитория Azure DevOps.

Добавьте необязательные параметры в зависимости от сценария миграции:

Проверьте состояние миграции:

az devops migrations status --org https://dev.azure.com/<org>
                            --repository-id <repo-guid>

Искать:

• status— текущее состояние миграции (Active, , SucceededCompleted, ) FailedSuspended
• stage— текущий этап миграции (Queued, , ValidationSynchronizationCutover, ReviewForCutover, , ) ReadyForCutoverMigrated
• validationIssues — список сбоев предварительной проверки с кодами ошибок и сообщениями
• errorMessage — сведения о сбое

1. В project откройте параметры Project.
2. В разделе Repos выберите "Миграция в GitHub".
3. Нажмите кнопку "Начать новую миграцию".
4. Выберите один или несколько репозиториев для миграции, а затем нажмите кнопку "Далее".
5. На странице сведений о миграции укажите следующие значения:
   • Действие миграции: Выберите Перенести выбранные репозитории после проверки или Запустить проверку и перенести позже.
   • Целевой репозиторий: введите URL-адрес репозитория GitHub в форматеhttps://<enterpriseUrl>/<orgname>/<repo>.
   • Токен GitHub: Вставьте свой персональный токен доступа GitHub.
   • Настройте имена целевых репозиториев для всех выбранных репозиториев (необязательно): добавьте префикс и/или суффикс. Не используйте пробелы в именах репозитория.
   • Подключение к сервису: Выберите подключение к сервису GitHub, созданное на этапе предварительной настройки.
   • Пул агентов: выберите автономный пул агентов Linux, в котором выполняется агент миграции.
   • Создайте подключение Boards (необязательно): выберите, хотите ли ELM создать подключение Boards.
   • Автоматически обнаруживать и перенастраивать конвейеры (необязательно): Выберите, чтобы использовать перенастройку конвейеров.
   • Подключение службы конвейера (необязательно): выберите подключение службы конвейера, созданное на этапе предварительной настройки.
6. Выберите "Выполнить проверку " или " Начать миграцию" в зависимости от выбранного действия миграции.
7. Откройте сведения о миграции и убедитесь, что проверка выполняется.

1. Запустите синхронизацию в течение 24 часов после успешной проверки:

   az devops migrations resume --org https://dev.azure.com/<org>
                               --repository-id <repo-guid>
                               --migration
   

2. Повторная проверка состояния:

   az devops migrations status --org https://dev.azure.com/<org>
                               --repository-id <repo-guid>
   

1. В проекте Azure DevOps перейдите в Параметры проекта>Repos>Миграция в GitHub.
2. Откройте миграцию, которая успешно прошла проверку.
3. Нажмите кнопку "Начать синхронизацию ", чтобы повысить уровень проверки до полной синхронизации.
4. Подтвердите изменения состояния миграции на этапе синхронизации.

1. Найдите идентификаторы определений конвейера, которые ссылаются на мигрируемый репозиторий.

   az devops migrations pipelines list показывает только конвейеры, которые уже включены в процесс перенастройки, и их статус перенастройки. Перед отправкой конвейеров он возвращает пустой результат, поэтому его нельзя использовать для обнаружения потенциальных конвейеров. Чтобы найти идентификаторы определений для повторной обработки, перечислите конвейеры, которые создаются из исходного репозитория:

   az pipelines list --org $org \
                     --project $project \
                     --repository $rid \
                     --repository-type tfsgit \
                     --query "[].{id:id, name:name}" -o table
   

   Используйте значения id из выходных данных в качестве --pipeline-ids на следующем шаге.

   Note

   az pipelines list --repository возвращает только конвейеры, репозиторий триггеров которых по умолчанию — исходный репозиторий. Конвейер, который ссылается на репозиторий через ресурс, шаблон или шаг checkout (а не как на свой основной репозиторий), может не отображаться здесь. Включите также эти идентификаторы определений, если знаете, что они зависят от перемещаемого репозитория.

2. Отправьте выбранные идентификаторы определений конвейера для перенастройки (не более 200 идентификаторов на запрос):

   az devops migrations pipelines submit --org $org \
                                        --repository-id $rid \
                                        --pipeline-ids 42 43 44 \
                                        --service-connection-id $scid
   

   --service-connection-id необязателен, если вы уже добавили подключение через --pipeline-service-connection-id в migrations create или в предыдущем pipelines update --service-connection-id.

3. Если конвейер ссылается на другие репозитории, сопоставляет каждый исходный репозиторий с целевым объектом GitHub:

   az devops migrations pipelines submit --org $org \
                                        --repository-id $rid \
                                        --pipeline-ids 42 43 44 \
                                        --service-connection-id $scid \
                                        --repository-mapping aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa=<GH_ORG>/shared-templates \
                                        --repository-mapping bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb=<GH_ORG>/another-repo
   

   Формат: --repository-mapping <sourceRepoId>=<targetOwner>/<targetRepo> (повторяемый).

4. Мониторинг и настройка набора конвейеров:

   az devops migrations pipelines list --org $org --repository-id $rid -o table
   

   После отправки конвейеров эта команда выводит список всех зарегистрированных конвейеров и их статус перенастройки:

   Column	Значение
   DefinitionId	Идентификатор определения конвейера
   Name	Имя конвейера (возвращается к имени файла YAML, если имя еще недоступно)
   Classification	Как конвейер ссылается на репозиторий
   Status	Текущее состояние перенастройки конвейера
   ErrorMessage	Сведения о сбое, когда конвейер находится в состоянии сбоя

   az devops migrations pipelines update --org $org \
                                        --repository-id $rid \
                                        --add-ids 50 51 \
                                        --remove-ids 42 \
                                        --retry-ids 43 \
                                        --service-connection-id $scid
   

   • --add-ids: добавление дополнительных конвейеров.
   • --remove-ids: удалите конвейеры из повторной настройки.
   • --retry-ids: повторный запуск конвейеров в состоянии Failed.
   • По крайней мере один из --add-ids, --remove-idsили --retry-ids--service-connection-id--repository-mapping требуется.

   Ярлык только для повторных попыток:

   az devops migrations pipelines retry --org $org --repository-id $rid --pipeline-ids 43
   

5. Проверить и утвердить во время переключения, когда этап — ReviewForCutover:

   az devops migrations cutover review --org $org --repository-id $rid -o table
   

   Просмотрите ключевые поля:

   Поле	Значение
   FailedCount / BlockedCount / PendingCount / TotalUnprocessedCount	Количество необработанных элементов (с ошибками, заблокированных, ожидающих обработки и всего)
   RequiresPipelineVerification (requiresPipelineVerificationAcknowledgment)	Если true, утверждение должно включать --pipelines-verified
   State / Type / PullRequestUrl (из failedItems[])	Сведения о сбое для каждого элемента

6. Утвердить переключение:

   az devops migrations cutover approve --org $org \
                                       --repository-id $rid \
                                       --pipelines-verified
   

   Если вы также принимаете необработанные элементы:

   az devops migrations cutover approve --org $org \
                                       --repository-id $rid \
                                       --accept-failures 3 \
                                       --pipelines-verified
   

   Необходимо предоставить по крайней мере одно из --accept-failures или --pipelines-verified.

1. На панели миграции откройте меню для переносимого репозитория и выберите Перенастроить конвейеры.
2. Выберите Rewire в конвейерах, которые требуется подключить.
3. Синий индикатор состояния показывает перенастроенные конвейеры.