Importación de un repositorio de Git en un proyecto

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

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

Realice los pasos siguientes para importar en un nuevo repositorio:

1. En su navegador, inicie sesión en su organización y seleccione Repos>.

   

2. En la lista desplegable del repositorio, seleccione Importar repositorio.

   

3. Escriba la dirección URL de clonación del repositorio de origen y un nombre para el nuevo repositorio de Git.

   

4. Seleccione Importar un repositorio.

El repositorio se importa.

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. Proporcione 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

1. Clone el repositorio de origen en una carpeta temporal del equipo usando la opción bare, como se muestra en el siguiente ejemplo de línea de comandos, y luego acceda 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 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

   El uso de --mirror sobrescribe 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, recójalos y cópielos del repositorio de origen al 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 (FAQ)

Aunque las importaciones se realizan con más frecuencia, las siguientes condiciones pueden causar problemas.

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

P: ¿Qué ocurre si mi repositorio de origen está detrás de la autenticación en dos fases?

R: El servicio de importación usa las API REST para validar y desencadenar la importación y no puede trabajar directamente con repositorios que requieren autenticación en dos fases.

La mayoría de los proveedores de hospedaje de Git admiten tokens de autenticación que se pueden proporcionar al servicio de importación:

Tokens de id. de Microsoft Entra (recomendado): Los tokens de id. de Microsoft Entra proporcionan una mayor seguridad y son el método de autenticación recomendado. Puede obtener estos tokens a través de:

• CLI de Azure (para desarrollo y pruebas):

  az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query "accessToken" --output tsv
  

• Principal de servicio (para escenarios de producción o automatizados):

  • Registro de una aplicación en Microsoft Entra ID
  • Creación de un secreto de cliente para la aplicación
  • Concesión de permisos adecuados a la aplicación en Azure DevOps
  • Uso de las credenciales de la entidad de servicio para obtener tokens de forma programática

Tokens de acceso personal (alternativa):GitHub y Azure DevOps también admiten tokens de acceso personal.

P: ¿Qué ocurre si mi repositorio de origen no admite multi_ack?

R: 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, el servicio de importación puede no importar desde el origen especificado. Este error puede producirse al crear una solicitud de importación o mientras la importación está en curso.

P: ¿Puedo importar desde versiones anteriores?

R: Si el repositorio git de origen está en una versión local anterior a 2017 RTM, se produce un error en la importación debido a un error de coincidencia de contrato entre las versiones anteriores y Azure DevOps más recientes.

P: ¿Puedo usar credenciales basadas en MSA?

R: Desafortunadamente, las credenciales basadas en MSA (cuenta microsoft) no funcionan. El servicio de importación emplea una autenticación básica para comunicarse con el repositorio de origen. Si el nombre de usuario y la contraseña que usa no son autenticación básica, se producirá un error en la autenticación e importación. Una manera de comprobar si el nombre de usuario o la contraseña que usa son autenticación básica es intentar usar Git para clonar el repositorio con el formato siguiente:

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

P: ¿Puedo importar desde TFVC?

R: Puede migrar código de un repositorio TFVC existente a un nuevo repositorio de Git dentro de la misma cuenta. Aunque la migración a Git tiene muchas ventajas, es un proceso implicado para los grandes repositorios y equipos de TFVC. Los sistemas de control de versiones centralizados, como TFVC, se comportan de forma diferente a Git de maneras fundamentales. El cambio acarrea mucho más que aprender nuevos comandos. Es un cambio disruptivo que requiere una planificación cuidadosa. Para obtener más información, vea Importación de TFVC a Git.

P: ¿Qué ocurre si mi repositorio de origen contiene objetos LFS de Git?

R: La importación de Git no importa objetos LFS de Git.

Para mover objetos LFS, puede hacer lo siguiente:

• Importe el repositorio mediante la característica de importación del repositorio en Azure DevOps. Esta acción copia todos los objetos de Git desde el origen a Azure DevOps, que también importa los punteros LFS que son objetos git, pero no los archivos LFS.

Para desplazarse por los archivos LFS, necesita Git.exe y el cliente LFS en la misma máquina, con acceso tanto al repositorio de origen como al repositorio de destino.

• Clone el repositorio importado de Azure DevOps en el sistema local. La clonación funciona, pero se produce un error al realizar el chequeo de archivos LFS.
• Agregue el repositorio de origen como remoto, por ejemplo, "source".
• Ejecute git lfs fetch source --all, que lleva todos los archivos LFS del origen al repositorio local.
• Suponiendo que el repositorio de Azure DevOps de destino sea el remoto "destino".
• Ejecute git lfs push target --all.

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

R: El servicio de importación es para importar inicialmente un repositorio completo. Para reflejar cambios posteriores, necesita un clon local del repositorio con los remotos configurados tanto para origen como para destino.

Los cambios se pueden sincronizar mediante los siguientes comandos. En el ejemplo siguiente se trata 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

Contenido relacionado

• Más información sobre el flujo de trabajo de Git