3. Avviare la migrazione

1. Accedere all'interfaccia della riga di comando di Azure:

   az login
   

2. Impostare l'organizzazione Azure DevOps predefinita:

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

   Suggerimento

   Se il remote Git locale punta a un'organizzazione diversa, aggiungi --detect false a tutti i comandi di migrazione per impedire al rilevamento automatico di scegliere l'organizzazione sbagliata.

3. Verificare l'accesso:

   az devops project list
   

4. Ottenere il GUID del repository:

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

1. Accedere all'organizzazione Azure DevOps all'indirizzo https://dev.azure.com/<org>.
2. Aprire il project di destinazione e quindi selezionare Project impostazioni.
3. Selezionare Repository e verificare che il repository di cui si intende eseguire la migrazione sia presente.
4. Tieni aperto il portale così potrai verificare più tardi lo stato dell'agente in Impostazioni del progetto>Pool di agenti.

Iniziare con questo comando di base per ogni migrazione:

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>

In --target-repository, <repo> è il nome del repository GitHub. Scegliere qualsiasi nome disponibile. Non è necessario che corrisponda al nome del repository Azure DevOps.

Aggiungere parametri facoltativi in base al proprio scenario di migrazione:

Controllare lo stato della migrazione:

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

Cerca:

• status- Stato della migrazione corrente (Active, Succeeded, CompletedFailed, , Suspended)
• stage- Fase di migrazione corrente (Queued, Validation, SynchronizationCutover, ReviewForCutover, ReadyForCutover, , ) Migrated
• validationIssues - elenco di errori di controllo preliminare con codici di errore e messaggi
• errorMessage - dettagli sull'errore

1. Nel tuo progetto, apri Impostazioni progetto.
2. In Repos selezionare Migrazione a GitHub.
3. Selezionare Avvia una nuova migrazione.
4. Scegliere uno o più repository di cui eseguire la migrazione e quindi selezionare Avanti.
5. Nella pagina dei dettagli della migrazione specificare i valori seguenti:
   • Azione di migrazione: selezionare Eseguire la migrazione dei repository selezionati dopo la convalida o Eseguire la convalida ed eseguire la migrazione in un secondo momento.
   • Repository di destinazione: immettere l'URL del repository GitHub nel formato https://<enterpriseUrl>/<orgname>/<repo>.
   • GitHub token: incollare il token di accesso personale GitHub.
   • Personalizzare i nomi dei repository di destinazione per tutti i repository selezionati (facoltativo): aggiungere un prefisso e/o un suffisso. Non usare spazi nei nomi dei repository.
   • Connessione al servizio: selezionare la connessione al servizio GitHub creata nei prerequisiti.
   • Pool di agenti: selezionare il pool di agenti Linux self-hosted in cui è in esecuzione l'agente di migrazione.
   • Creare una connessione Boards (facoltativa): selezionare se si vuole che ELM crei una connessione Boards.
   • Individua e riconfigura automaticamente le pipeline (facoltativo): selezionare per utilizzare la riconfigurazione delle pipeline.
   • Connessione al servizio pipeline (facoltativo): selezionare la connessione al servizio pipeline creata nei prerequisiti.
6. Selezionare Esegui convalida o Avvia migrazione in base all'azione di migrazione selezionata.
7. Aprire i dettagli della migrazione e verificare che la convalida sia in esecuzione.

1. Avviare la sincronizzazione entro 24 ore dopo che la convalida ha esito positivo:

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

2. Ricontrollare lo stato:

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

1. Nel progetto Azure DevOps, vai a Impostazioni del progetto>Repos>Migrazione a GitHub.
2. Aprire la migrazione che ha completato correttamente la convalida.
3. Selezionare Avvia sincronizzazione per alzare di livello la convalida alla sincronizzazione completa.
4. Verificare che lo stato della migrazione venga modificato nella fase di sincronizzazione.

1. Trova gli ID delle definizioni della pipeline che fanno riferimento al repository in fase di migrazione.

   az devops migrations pipelines list riporta solo le pipeline già incluse nel processo di riconfigurazione e il relativo stato di riconfigurazione. Prima di inviare le pipeline, restituisce un risultato vuoto, quindi non è possibile usarlo per individuare le pipeline candidate. Per trovare gli ID di definizione da ricollegare, elencare le pipeline che vengono compilate a partire dal repository di origine:

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

   Usare i valori id dell'output come --pipeline-ids nel passaggio seguente.

   Note

   az pipelines list --repository restituisce solo le pipeline il cui repository di trigger predefinito è il repository di origine. Una pipeline che fa riferimento al repository tramite una risorsa, un modello o un passaggio di checkout (anziché come repository principale) potrebbe non essere visualizzata qui. Includi anche questi ID di definizione se sai che dipendono dal repository in fase di migrazione.

2. Inviare gli ID delle definizioni di pipeline selezionate per la riconfigurazione (massimo 200 ID per richiesta):

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

   --service-connection-id è facoltativo se hai già collegato una connessione tramite --pipeline-service-connection-id in migrations create o in un pipelines update --service-connection-id precedente.

3. Se una pipeline fa riferimento ad altri repository, eseguire il mapping di ogni repository di origine alla destinazione 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
   

   Formato: --repository-mapping <sourceRepoId>=<targetOwner>/<targetRepo> (ripetibile).

4. Monitorare e regolare il set di pipeline:

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

   Dopo aver inviato le pipeline, questo comando elenca ciascuna pipeline registrata e il relativo stato di riconfigurazione:

   Column	Meaning
   DefinitionId	ID definizione della pipeline
   Name	Nome della pipeline (se il nome della pipeline non è ancora disponibile, viene usato il nome del file YAML)
   Classification	In che modo la pipeline fa riferimento al repository
   Status	Stato attuale del ricablaggio della pipeline
   ErrorMessage	Dettagli dell'errore quando la pipeline si trova in uno stato di errore

   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: aggiungere altre pipeline.
   • --remove-ids: rimuovere le pipeline dalla riconfigurazione.
   • --retry-ids: ripetere le pipeline in stato Failed.
   • È necessario almeno uno di --add-ids, --remove-ids--retry-ids, --service-connection-id, o --repository-mapping .

   Collegamento di sola ripetizione:

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

5. Rivedere e approvare durante il cutover quando la fase è ReviewForCutover:

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

   Esaminare i campi chiave:

   Campo	Meaning
   FailedCount / BlockedCount / PendingCount / TotalUnprocessedCount	Numero di elementi non elaborati (non riusciti, bloccati, in sospeso e totale)
   RequiresPipelineVerification (requiresPipelineVerificationAcknowledgment)	Se true, l'approvazione deve includere --pipelines-verified
   State / Type / PullRequestUrl (da failedItems[])	Dettagli sugli errori per elemento

6. Approva il passaggio:

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

   Se si accettano anche elementi non elaborati:

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

   È necessario specificare almeno uno di --accept-failures o --pipelines-verified.

1. Nel dashboard di migrazione aprire il menu per il repository di migrazione e selezionare Pipeline rewire.
2. Selezionare Rewire nelle pipeline da connettere.
3. Un indicatore di stato blu mostra le pipeline riconfigurate.