Importation d’un dépôt Team Foundation Version Control

Vous pouvez importer un dépôt de Team Foundation Version Control (TFVC) en le convertissant en dépôt Git, puis en poussant le dépôt Git vers GitHub.

Dans cet article

À propos des importations de Team Foundation Version Control

Nous vous recommandons d’utiliser Azure Repos pour convertir votre dépôt Team Foundation Version Control (TFVC) en Git. Toutefois, Azure Repos migre jusqu’à 180 jours d’historique uniquement. Si vous souhaitez conserver un historique plus long, vous pouvez utiliser git-tfs à la place.

Remarque : Azure Repos migre jusqu’à 180 jours d’historique uniquement. L’état de votre dépôt avant le seuil des 180 jours est migré dans un seul commit initial. Pour conserver un historique plus long, consultez « Migration avec git-tfs ».

Pour suivre ces étapes, vous devez utiliser un système macOS ou Linux et avoir les outils suivants installés :

  1. Créez un référentiel dans GitHub. Pour éviter les erreurs, n’initialisez pas le nouveau dépôt avec le fichier README, la licence ou les fichiers gitignore. Vous pouvez ajouter ces fichiers une fois que votre projet a été poussé vers GitHub. Pour plus d’informations, consultez « Création d’un dépôt ».

  2. Pour vérifier que Git est installé sur votre ordinateur, exécutez git --version.

    La sortie devrait ressembler à git version 2.40.0.

  3. Pour vérifier que Git LFS est installé sur votre ordinateur, exécutez git lfs --version.

    La sortie devrait ressembler à git-lfs/3.1.4 (GitHub; darwin arm64; go 1.18.1).

  4. Convertissez votre dépôt TFVC en Git avec Azure Repos. Pour obtenir des instructions, consultez Importer des dépôts de TFVC vers Git dans Microsoft Learn.

  5. Pour cloner votre dépôt Azure Repos sur votre ordinateur local, exécutez git clone --mirror URL en remplaçant l’URL par l’URL de clone de votre dépôt Azure DevOps.

    Pour identifier l’URL de clone de votre dépôt Azure DevOps, consultez Obtenir l’URL de clone d’un dépôt Git Azure Repos dans Microsoft Learn.

  6. Pour ajouter votre dépôt GitHub en tant que dépôt distant, exécutez git remote add origin URL, en remplaçant URL par l’URL du dépôt GitHub que vous avez créée précédemment, par exemple https://github.com/octocat/example-repository.git.

  7. Pour envoyer le dépôt sur GitHub, exécutez git push --mirror origin.

    Si votre dépôt contient des fichiers dont la taille est supérieure à la limite de taille de fichier de GitHub, votre poussée peut échouer. Déplacez les gros fichiers vers Git LFS en exécutant git lfs import, puis réessayez.

Migration avec git-tfs

Si vous migrez avec git-tfs, vous conservez l’historique complet de votre dépôt TFVC.

Pour suivre ces étapes, vous devez utiliser Windows et avoir les outils suivants installés :

  1. Créez un référentiel dans GitHub. Pour éviter les erreurs, n’initialisez pas le nouveau dépôt avec le fichier README, la licence ou les fichiers gitignore. Vous pouvez ajouter ces fichiers une fois que votre projet a été poussé vers GitHub. Pour plus d’informations, consultez « Création d’un dépôt ».

  2. Pour vérifier que Git est installé sur votre ordinateur, exécutez git --version.

    La sortie devrait ressembler à git version 2.40.0.

  3. Pour vérifier que git-tfs est installé sur votre ordinateur, exécutez git tfs --version.

    La sortie devrait commencer par quelque chose qui ressemble à git-tfs version 0.32.0.0 (TFS client library 16.0.0.0 (MS)).

    Si vous obtenez une sortie similaire à Unable to load DLL 'Microsoft.VisualStudio.Setup.Configuration.Native.dll': The specified module could not be found. (Exception from HRESULT: 0x8007007E), assurez-vous que Visual Studio Team Explorer est correctement installé.

  4. Pour vérifier que Git LFS est installé sur votre ordinateur, exécutez git lfs --version.

    La sortie devrait ressembler à git-lfs/3.1.4 (GitHub; darwin arm64; go 1.18.1).

  5. Si ce n’est déjà fait, configurez Git avec votre nom et votre adresse e-mail en exécutant git config --global user.name "NAME" et git config --global user.email EMAIL, en remplaçant NOM par votre nom et EMAIL par votre adresse e-mail.

  6. Exécutez git tfs clone, en passant l’URL et le chemin du dépôt TFVC en tant qu’arguments. Par exemple, pour convertir le dépôt example sur https://dev.azure.com/octocat en un dépôt Git stocké dans le répertoire /example, exécutez git tfs clone --branches=all https://dev.azure.com/octocat $/example.

  7. Accédez au répertoire du dépôt Git nouvellement créé.

  8. Pour ajouter votre dépôt GitHub en tant que dépôt distant, exécutez git remote add origin URL, en remplaçant URL par l’URL du dépôt GitHub que vous avez créée précédemment, par exemple https://github.com/octocat/example-repository.git.

  9. Pour envoyer le dépôt sur GitHub, exécutez git push --mirror origin.

    Si votre dépôt contient des fichiers dont la taille est supérieure à la limite de taille de fichier de GitHub, votre poussée peut échouer. Déplacez les gros fichiers vers Git LFS en exécutant git lfs import, puis réessayez.

Pour aller plus loin