À 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.
Migration avec Azure Repos (recommandé)
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 :
- Git
- Stockage Fichiers volumineux Git (Git LFS) (voir « Installation de Git Large File Storage »)
-
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 Enterprise Cloud. Pour plus d’informations, consultez « Création d’un dépôt ».
-
Pour vérifier que Git est installé sur votre ordinateur, exécutez
git --version.
La sortie devrait ressembler à
git version 2.40.0
. -
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)
. -
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.
-
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.
-
Pour ajouter votre dépôt GitHub en tant que dépôt distant, exécutez
git remote add origin URL
, en remplaçantURL
par l’URL du dépôt GitHub que vous avez créée précédemment, par exemplehttps://github.com/octocat/example-repository.git
. -
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 Enterprise Cloud, 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 :
- Visual Studio Team Explorer
git-tfs
, installé avec Chocolatey ou en téléchargeant manuellement la version binaire- Git
- Stockage Fichiers volumineux Git (Git LFS) (voir « Installation de Git Large File Storage »)
-
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 Enterprise Cloud. Pour plus d’informations, consultez « Création d’un dépôt ».
-
Pour vérifier que Git est installé sur votre ordinateur, exécutez
git --version.
La sortie devrait ressembler à
git version 2.40.0
. -
Pour vérifier que
git-tfs
est installé sur votre ordinateur, exécutezgit 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é. -
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)
. -
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"
etgit config --global user.email EMAIL
, en remplaçant NOM par votre nom et EMAIL par votre adresse e-mail. -
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ôtexample
surhttps://dev.azure.com/octocat
en un dépôt Git stocké dans le répertoire/example
, exécutezgit tfs clone --branches=all https://dev.azure.com/octocat $/example
. -
Accédez au répertoire du dépôt Git nouvellement créé.
-
Pour ajouter votre dépôt GitHub en tant que dépôt distant, exécutez
git remote add origin URL
, en remplaçantURL
par l’URL du dépôt GitHub que vous avez créée précédemment, par exemplehttps://github.com/octocat/example-repository.git
. -
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 Enterprise Cloud, votre poussée peut échouer. Déplacez les gros fichiers vers Git LFS en exécutant
git lfs import
, puis réessayez.