Importare un repository Git

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Questo articolo illustra come importare un repository Git esistente da GitHub, Bitbucket, GitLab o un altro percorso in un repository esistente nuovo o vuoto nel progetto Azure DevOps.

Prerequisiti

Importare in un nuovo repository

1. Selezionare Repository, File.

   

2. Nell'elenco a discesa repository selezionare Importa repository.

   

3. Se il repository di origine è disponibile pubblicamente, immettere solo l'URL clone del repository di origine e un nome per il nuovo repository Git.

   Se il repository di origine è privato ma è accessibile usando l'autenticazione di base (nome utente-password, token di accesso personale e così via), selezionare Richiede autorizzazione e immettere le credenziali. L'autenticazione SSH non è supportata, ma è possibile importare manualmente un repository che usa l'autenticazione SSH seguendo la procedura descritta in Importare manualmente un repository usando l'interfaccia della riga di comando git.

   

::: moniker-end

Importare in un repository vuoto esistente

Nella pagina File del repository Git vuoto, selezionare Importa e inserire l'URL del clone. Specificare le credenziali se il repository di origine richiede l'autenticazione.

az repos import create --git-source-url
                       [--detect {false, true}]
                       [--git-service-endpoint-id]
                       [--org]
                       [--project]
                       [--repository]
                       [--requires-authorization]
                       [--subscription]
                       [--user-name]

az repos import create --git-source-url https://github.com/fabrikamprime/fabrikam-open-source --repository fabrikam-open-source
{
  "detailedStatus": {
    "allSteps": [
      "Processing request",
      "Analyzing repository objects",
      "Storing objects",
      "Storing index file",
      "Updating references",
      "Import completed successfully"
    ],
    "currentStep": 6,
    "errorMessage": null
  },
  "importRequestId": 8,
  "parameters": {
    "deleteServiceEndpointAfterImportIsDone": null,
    "gitSource": {
      "overwrite": false,
      "url": "https://github.com/fabrikamprime/fabrikam-open-source"
    },
    "serviceEndpointId": null,
    "tfvcSource": null
  },
  "repository": {
    "defaultBranch": null,
    "id": "0f6919cd-a4db-4f34-a73f-2354114a66c4",
    "isDisabled": false,
    "isFork": null,
    "name": "new-empty-repo",
    "parentRepository": null,
    "project": {
      "abbreviation": null,
      "defaultTeamImageUrl": null,
      "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
      "id": "56af920d-393b-4236-9a07-24439ccaa85c",
      "lastUpdateTime": "2021-05-24T21:52:14.95Z",
      "name": "Fabrikam Fiber",
      "revision": 438023732,
      "state": "wellFormed",
      "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
      "visibility": "private"
    },
    "remoteUrl": "https://[email protected]/fabrikamprime/Fabrikam%20Fiber/_git/fabrikam-open-source",
    "size": 12477,
    "sshUrl": "[email protected]:v3/kelliott/Fabrikam%20Fiber/new-empty-repo",
    "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/0f6919cd-a4db-4f34-a73f-2354114a66c4",
    "validRemoteUrls": null,
    "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/fabrikam-open-source"
  },
  "status": "completed",
  "url": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_apis/git/repositories/0f6919cd-a4db-4f34-a73f-2354114a66c4/importRequests/8"
}

Importare manualmente un repository usando l'interfaccia della riga di comando git

La funzionalità del repository di importazione è stata introdotta nell'aggiornamento 1 2017. È anche possibile seguire questa procedura per importare manualmente un repository in un repository di Azure DevOps Services sostituendo "TFS" con Azure Repos nei passaggi seguenti.

1. Clonare il repository di origine in una cartella temporanea nel computer usando l'opzione bare , come illustrato nell'esempio della riga di comando seguente, quindi passare alla cartella del repository. Quando si clona usando l'opzione bare , il nome della cartella include il .git suffisso . In questo esempio, https://github.com/contoso/old-contoso-repo.git è il repository di origine da importare manualmente.

   git clone --bare https://github.com/contoso/old-contoso-repo.git
   cd old-contoso-repo.git
   

2. Creare un repository di destinazione e prendere nota dell'URL clone. In questo esempio è https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo l'URL del nuovo repository di destinazione.

3. Eseguire il comando seguente per copiare il repository di origine nel repository di destinazione.

   git push --mirror https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo
   

   Avviso

   L'utilizzo di --mirror sovrascrive tutti i branch nel repository di destinazione, il che comporta l'eliminazione di eventuali branch non presenti nel repository di origine.

4. Se il repository di origine include oggetti LFS, recuperarli e copiarli dal repository di origine al repository di destinazione.

   git lfs fetch origin --all
   git lfs push --all https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo
   

5. Eliminare la cartella temporanea eseguendo i comandi seguenti.

   cd ..
   rm -rf old-contoso-repo.git
   

Domande frequenti

Anche se le importazioni hanno più spesso esito positivo, le condizioni seguenti potrebbero causare problemi.

• Cosa accade se il repository di origine si trova dietro l'autenticazione a due fattori?
• Cosa accade se il repository di origine non supporta multi_ack?
• È possibile importare da versioni precedenti di Team Foundation Server ?
• È possibile usare le credenziali basate su MSA?
• È possibile importare da TFVC?
• Cosa accade se il repository di origine contiene oggetti Git LFS?

D: Cosa accade se il repository di origine è protetto dall'autenticazione a due fattori?

R: il servizio di importazione usa le API REST per convalidare e attivare l'importazione e non può funzionare direttamente con i repository che richiedono l'autenticazione a due fattori. La maggior parte dei provider di hosting Git come GitHub e Azure DevOps Services supportano i token personali che possono essere forniti al servizio di importazione.

D: Cosa accade se il repository di origine non supporta multi_ack?

R: Il servizio di importazione usa la funzionalità di multi_ack del protocollo Git durante l'importazione. Se il repository di origine non fornisce questa funzionalità, il servizio di importazione non può eseguire l'importazione dall'origine specificata. Questo errore può verificarsi durante la creazione della richiesta di importazione o durante l'importazione.

D: È possibile importare da versioni precedenti?

R: Se il repository Git di origine si trova in una versione TFS precedente a TFS 2017 RTM, l'importazione non riesce. Ciò si verifica a causa di una mancata corrispondenza del contratto tra la versione più recente di Azure DevOps e le versioni precedenti.

D: È possibile usare le credenziali basate su MSA?

R: Sfortunatamente, le credenziali basate su MSA (account Microsoft, in precedenza Live ID) non funzionano. Il servizio di importazione si basa sull'autenticazione di base per comunicare con il repository di origine. Se il nome utente o la password in uso non sono autenticati di base, l'autenticazione e l'importazione hanno esito negativo. Un modo per verificare se il nome utente o la password in uso sono l'autenticazione di base o meno consiste nel provare a usare Git per clonare il repository usando il formato seguente

git clone https://<<username>>:<<password>>@<<remaining clone Url>>

D: È possibile importare da TFVC?

R: È possibile eseguire la migrazione del codice da un repository TFVC esistente a un nuovo repository Git all'interno dello stesso account. Sebbene la migrazione a Git offra molti vantaggi, è un processo complesso per i repository TFVC di grandi dimensioni e i team. I sistemi di controllo della versione centralizzati, ad esempio TFVC, si comportano in modo diverso rispetto a Git in modi fondamentali. L'opzione prevede molto di più rispetto all'apprendimento di nuovi comandi. Si tratta di un cambiamento dirompente che richiede un'attenta pianificazione. Per altre informazioni, vedere Importare da TFVC a Git.

D: Cosa accade se il repository di origine contiene oggetti Git LFS?

R: L'importazione Git non importa gli oggetti Git LFS.

Gli oggetti LFS possono essere spostati seguendo questa procedura:

• Importare il repository usando la funzionalità import repository in Azure DevOps. Questa azione copia tutti gli oggetti Git dall'origine ad Azure DevOps, che importa anche i puntatori LFS che sono oggetti Git, ma non i file LFS

Per spostarsi sui file LFS, sono necessari sia Git.exe che il client LFS nella stessa casella e l'accesso sia al repository di origine che al repository di destinazione

• Clonare il repository importato da Azure DevOps nel sistema locale. Il clone funziona, ma non riesce durante il check-out dei file LFS
• Aggiungere il repository di origine come remoto, ad esempio "source"
• Eseguire git lfs fetch source --all, che porta tutti i file LFS dall'origine al repository locale
• Supponendo che il repository VSTS di destinazione sia il "target" remoto
• Eseguire git lfs push target --all

D: È possibile importare gli aggiornamenti se l'origine cambia in un secondo momento?

R: Il servizio di importazione prevede l'importazione iniziale di un intero repository. Per eseguire il mirroring delle modifiche successive, è necessario un clone locale del repository con remote impostate sia su origine che su destinazione.

È possibile sincronizzare le modifiche usando i comandi seguenti. L'importazione di Azure Repos viene considerata come origin e il repository originale come upstream.

git clone --bare <Azure-Repos-clone-URL>.git
cd <name-of-repo>
git remote add --mirror=fetch upstream <original-repo-URL>
git fetch upstream --tags
git push origin --all

Passaggi successivi

Articoli correlati

• Altre informazioni sul flusso di lavoro Git