Importación de un repositorio de Git

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

En este artículo se explica cómo importar un repositorio Git existente desde GitHub, Bitbucket, GitLab u otra ubicación en un repositorio nuevo o vacío existente en el proyecto de Azure DevOps.

Requisitos previos

Importación a un repositorio nuevo

Importación en un repositorio vacío existente

En la página Archivos del repositorio Git vacío, seleccione Importar y escriba la dirección URL de clonación. Deberá proporcionar credenciales si el repositorio de origen requiere autenticación.

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://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/fabrikam-open-source",
    "size": 12477,
    "sshUrl": "git@ssh.dev.azure.com: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"
}

Importación manual de un repositorio mediante la CLI de Git

La característica de importación de repositorio se incluyó a partir de TFS 2017 Update 1. Si usa TFS 2017 RTM o una versión anterior, puede usar los siguientes pasos para importar un repositorio manualmente a TFS. También puede seguir estos pasos para importar un repositorio manualmente a un repositorio de Azure DevOps Services, reemplazando TFS por Azure Repos.

1. Clone el repositorio de origen en una carpeta temporal del equipo con la opción bare, como se muestra en el siguiente ejemplo de línea de comandos, y luego vaya a la carpeta del repositorio. Cuando se clona con la opción bare, el nombre de la carpeta incluye el sufijo .git. En este ejemplo, https://github.com/contoso/old-contoso-repo.git es el repositorio de origen que se va a importar manualmente.

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

2. Cree un repositorio de destino con TFS 2017 RTM y anote la dirección URL de clonación. En este ejemplo, https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo es la dirección URL del nuevo repositorio de destino.

3. Ejecute el siguiente comando para copiar el repositorio de origen en el repositorio de destino.

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

   Advertencia

   Usar --mirror hará que se sobrescriban todas las ramas del repositorio de destino, lo que incluye eliminar las ramas que no estén en el repositorio de origen.

4. Si el repositorio de origen tiene objetos LFS, captúrelos y cópielos del repositorio de origen en el repositorio de destino.

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

5. Para eliminar la carpeta temporal, ejecute los siguientes comandos.

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

Preguntas más frecuentes

Aunque la mayoría de las veces la importación se realiza correctamente, las siguientes situaciones pueden causar problemas.

• ¿Qué ocurre si el repositorio de origen requiere autenticación en dos fases?
• ¿Qué ocurre si el repositorio de origen no admite multi_ack?
• ¿Puedo importar desde versiones anteriores de Team Foundation Server?
• ¿Puedo usar credenciales basadas en MSA?
• ¿Puedo importar desde TFVC?
• ¿Qué ocurre si el repositorio de origen contiene objetos LFS de Git?

¿Qué ocurre si el repositorio de origen requiere autenticación en dos fases?

El servicio de importación usa API REST para validar y desencadenar la importación, y no puede trabajar directamente con repositorios que requieran autenticación en dos fases. La mayoría de los proveedores de hospedaje de Git, como GitHub y Azure DevOps Services, admite tokens personales que se pueden proporcionar al servicio de importación.

¿Qué ocurre si el repositorio de origen no admite multi_ack?

El servicio de importación usa la funcionalidad multi_ack del protocolo Git durante la importación. Si el repositorio de origen no proporciona esta funcionalidad, es posible que el servicio de importación no pueda realizar la importación desde el origen especificado. Este error puede producirse al crear una solicitud de importación o mientras la importación está en curso.

¿Puedo importar desde versiones anteriores de Team Foundation Server?

Si el repositorio Git de origen está en una versión de TFS anterior a TFS 2017 RTM, se producirá un error en la importación. Esto sucede debido a una discrepancia de contrato entre las versiones más recientes de Azure DevOps Services/TFS y las versiones de TFS anteriores a 2017 RTM.

¿Puedo usar credenciales basadas en MSA?

Desafortunadamente, las credenciales basadas en MSA (cuenta Microsoft, anteriormente Live ID) no funcionarán. El servicio de importación emplea una autenticación básica para comunicarse con el repositorio de origen. Si el nombre de usuario o la contraseña que use no pertenecen a la autenticación básica, se producirá un error en la autenticación y la importación no se llevará a cabo. Una manera de comprobar si el nombre de usuario o la contraseña que está usando pertenecen o no a la autenticación básica es intentar usar Git para clonar el repositorio con el siguiente formato.

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

¿Puedo importar desde TFVC?

Se puede migrar código de un repositorio TFVC existente a un nuevo repositorio Git dentro de la misma cuenta. Aunque la migración a Git tiene muchas ventajas, se trata de un proceso complicado para los equipos y los repositorios de TFVC grandes. Los sistemas de control de versiones centralizados, como TFVC, se comportan en esencia de forma distinta a Git. El cambio acarrea mucho más que aprender nuevos comandos. Se trata de un cambio trascendental que precisa una planificación meticulosa. Para obtener más información, vea Importación de TFVC a Git.

¿Qué ocurre si el repositorio de origen contiene objetos LFS de Git?

La importación de Git no importará los objetos LFS de Git.

Para mover objetos LFS, puede hacer lo siguiente:

• Importe el repositorio usando la característica de importación de repositorio de Azure DevOps. Esto hará que se copien todos los objetos de Git desde el origen a Azure DevOps (lo cual también importará los punteros LFS, que son objetos de Git, pero no los archivos LFS).

Para mover los archivos LFS (necesitará tener tanto Git.exe como el cliente LFS en el mismo sitio, así como acceso al repositorio tanto de origen como de destino):

• Clone el repositorio importado de Azure DevOps en el sistema local; el clon funcionará, pero se producirá un error al intentar extraer del repositorio los archivos LFS.
• Agregue el repositorio de origen como un repositorio remoto (digamos que se llama "source").
• Use el comando git lfs fetch source --all (esto trasladará todos los archivos LFS del origen al repositorio local).
• Suponiendo que el repositorio VSTS de destino es un repositorio remoto llamado "target":
• Use el comando git lfs push target --all.

¿Puedo importar actualizaciones si el origen cambia más adelante?

El servicio de importación sirve para importar inicialmente un repositorio entero. Para reflejar los cambios que se produzcan posteriormente, necesitará un clon local del repositorio con referencias remotas establecidas en el origen y el destino.

Los cambios se pueden sincronizar mediante los siguientes comandos. Consideraremos la importación de Azure Repos como origin y el repositorio original como 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

Pasos siguientes

Artículos relacionados

• Más información sobre Git en el tutorial de Git