2. Completare i prerequisiti

Servizi di Azure DevOps

Prima di usare ELM, verificare che i requisiti seguenti siano soddisfatti nei servizi di Azure DevOps e GitHub Enterprise Cloud con residenza dei dati.

Requisiti del repository di origine e di destinazione

• La migrazione deve provenire da Azure DevOps Services (dev.azure.com). Azure DevOps Server non è supportato.
• Una destinazione GitHub Enterprise Cloud con l'azienda di residenza dei dati (<enterprise>.ghe.com) deve già esistere.
• Il nome del repository GitHub di destinazione non deve essere in uso.

Per ottenere il GUID del repository Azure DevOps, scegliere una delle schede seguenti:

az repos show --repository <repo-name> --query id -o tsv

Requisiti di accesso

Servizi di Azure DevOps

Installare l'app Azure DevOps ELM da GitHub Marketplace

Come amministratore dell'organizzazione GitHub, installare l'app ELM Azure DevOps sia per l'organizzazione aziendale che per l'organizzazione di destinazione.

1. Passare a https://<enterprise>.ghe.com/apps/external-app/azure-devops-elm.

2. Selezionare l'azienda di destinazione.

   

3. Seleziona Installa.

   

4. Tornare a https://<enterprise>.ghe.com/apps/external-app/azure-devops-elme quindi selezionare l'organizzazione di destinazione.

   

5. Selezionare Tutti i repository>Installa.

   

Strumenti necessari

I passaggi descritti in questa sezione usano la riga di comando. Installare il interfaccia della riga di comando di Azure e l'estensione dell'interfaccia della riga di comando di Azure DevOps nel computer usato per eseguire i comandi di migrazione.

1. Installare il interfaccia della riga di comando di Azure. Per altre informazioni, vedere Come installare il interfaccia della riga di comando di Azure.

   Ad esempio, aprire Visual Studio Code ed eseguire:

   winget install -e --id Microsoft.AzureCLI
   

2. Installare l'estensione dell'interfaccia della riga di comando Azure DevOps. Per altre informazioni, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps:

   az extension add -n azure-devops
   

   I comandi az devops migrations sono inclusi nell'estensione standard azure-devops. Non è disponibile un'estensione ELM separata da installare.

3. Verificare l'estensione caricata:

   az devops migrations --help
   

4. Per aggiornare un'installazione esistente:

   az extension update -n azure-devops
   

5. (Scelta consigliata) Impostare l'organizzazione Azure DevOps come predefinita, in modo che ogni comando migrations sia destinato all'host corretto:

   az devops configure --defaults organization=https://dev.azure.com/<org>
   

   Se si ignora questo passaggio e si eseguono comandi da una cartella in cui il remote git punta a un'organizzazione diversa, il rilevamento automatico della CLI seleziona invece quel remote anziché il valore di --org. Per disattivarlo per un singolo comando, aggiungi --detect false.

Configurare un agente Linux ospitato autonomamente

Usare il portale di Azure DevOps per selezionare o creare un pool di agenti e quindi eseguire gli script di installazione dell'agente in un computer Linux.

1. In Impostazioni progetto, vai a Pool di agenti in Pipeline, scegli il pool che vuoi usare per la migrazione e salva il nome del pool.

2. Se non si dispone di un pool, creare un agente Linux ospitato autonomamente. Per altre informazioni, vedere Deploy an Azure Pipelines agent on Linux. Versione breve:

   1. Verificare di avere l'autorizzazione per registrare un agente. Se sei un PCA, hai già questo accesso.
   2. Nelle impostazioni dell'organizzazione di Azure DevOps, vai a Pipelines>Pool di agenti.
   3. Selezionare il pool Default o quello ospitato autonomamente.
   4. Aprire la scheda Agenti e selezionare Nuovo agente.
   5. Nella finestra di dialogo Ottieni l'agente selezionare Linux e scaricare l'agente.
   6. Sul computer Linux, decomprimete l'agente nella directory desiderata e passate quindi a tale directory.
   7. Eseguire ./config.sh e quindi ./run.sh.

Attivare il controllo

ELM registra gli eventi del ciclo di vita della migrazione nel log di controllo di Azure DevOps, tra cui avvio, sospensione, ripresa, passaggio pianificato e abbandono. Gli amministratori possono visualizzare questi eventi in Controllo delle impostazioni>dell'organizzazione.

Configurazione facoltativa per scenari ibridi

Usare questa sezione se si prevede di continuare a usare Azure DevOps con GitHub dopo la migrazione.

Installare Azure Boards su GitHub

Se si prevede di continuare a usare Azure Boards dopo la migrazione, un amministratore aziendale di GitHub deve installare l'app Azure Boards nell'organizzazione GitHub prima dell'avvio della migrazione. Questa app consente a ELM di creare la connessione a Boards in modo che i team possano collegare i commit di GitHub e le pull request agli elementi di lavoro di Azure DevOps.

Per verificare l'installazione, passare a https://<enterpriseUrl>/organizations/<orgName>/settings/installations e verificare che Azure Boards sia elencato. Se Azure Boards non è elencato, chiedere a un amministratore dell'organizzazione di GitHub di installare l'app Azure Boards nel catalogo delle app aziendali.

Crea una connessione di servizio per la riconfigurazione della pipeline

Se si prevede di usare Azure DevOps e GitHub in una configurazione ibrida e connettere il repository GitHub a Azure Pipelines, completare questi passaggi prima di avviare la migrazione.

1. Verificare che l'app Azure Pipelines sia installata nell'organizzazione GitHub all'indirizzo https://<enterpriseUrl>/organizations/<orgName>/settings/installations.
2. Se Azure Pipelines non è elencato, chiedere a un amministratore dell'organizzazione di GitHub di installare l'app: https://<enterprise>.ghe.com/apps/external-app/azure-pipelines. Selezionare Configura e assicurarsi che l'accesso al repository sia impostato su Tutti i repository.
3. In Azure DevOps, in Impostazioni Project selezionare Connessioni al servizio.
4. Selezionare Nuova connessione al servizio e scegliere GitHub Enterprise Cloud con residenza dei dati.
5. Aggiungere l'URL GitHub e il nome dell'organizzazione e quindi selezionare Autorizza.
6. Aggiungere un nome di connessione al servizio e quindi selezionare Salva.
7. Aprire la connessione al servizio creata e copiare l'ID. Questo ID è necessario per la riconfigurazione della pipeline.

Valori da raccogliere per la migrazione basata su CLI

Usare questo elenco di controllo se si prevede di avviare e gestire la migrazione usando i comandi dell'interfaccia della riga di comando di Azure DevOps anziché l'interfaccia utente Azure DevOps.

Passo successivo

Contenuti correlati

• Informazioni su Enterprise Live Migrations
• Avviare la migrazione
• Informazioni di riferimento per l'interfaccia della riga di comando ELM