Informationen zu Importen aus der Team Foundation-Versionskontrolle
Es wird die Verwendung von Azure Repos zum Konvertieren von Repositorys aus der Team Foundation-Versionskontrolle (TFVC) in Git empfohlen. Azure Repos migriert jedoch nur bis zu 180 Tage des Verlaufs. Wenn du einen längeren Verlauf beibehalten möchtest, kannst du stattdessen git-tfs
verwenden.
Migrieren mit Azure Repos (empfohlen)
Hinweis: Azure Repos migriert nur bis zu 180 Tage des Verlaufs. Der Status deines Repositorys vor dem Schwellenwert von 180 Tagen wird in einem einzelnen Commit migriert. Weitere Informationen zum Beibehalten des Verlaufs findest du unter Migrieren mit git-tfs
.
Für diese Schritte musst du ein macOS- oder Linux-System verwenden und die folgenden Tools installiert haben:
- Git
- Git Large File Storage (Git LFS) (siehe Git Large File Storage installieren)
-
Erstelle ein neues Repository auf Ihre GitHub Enterprise Server-Instance. Initialisiere das neue Repository nicht mit README-, Lizenz- oder gitignore-Dateien, um Fehler zu vermeiden. Du kannst diese Dateien hinzufügen, nachdem dein Projekt per Push an GitHub Enterprise Server übergeben wurde. Weitere Informationen findest du unter Ein neues Repository erstellen.
-
Führe
git --version.
aus, um zu bestätigen, dass Git auf deinem Computer installiert ist.Die Ausgabe sollte in etwa wie folgt aussehen:
git version 2.40.0
. -
Führe
git lfs --version
aus, um zu bestätigen, dass Git LFS auf deinem Computer installiert ist.Die Ausgabe sollte in etwa wie folgt aussehen:
git-lfs/3.1.4 (GitHub; darwin arm64; go 1.18.1)
. -
Konvertiere dein TFVC-Repository mithilfe von Azure Repos in Git. Anweisungen findest du unter Importieren von Repositorys aus TFVC in Git in Microsoft Learn.
-
Um dein Azure Repos-Repository auf deinen lokalen Computer zu klonen, führe
git clone --mirror URL
aus, und ersetze die URL durch die Klon-URL für dein Azure DevOps-Repository.Wie du die Klon-URL für dein Azure DevOps-Repository findest, erfährst du unter Abrufen der Klon-URL eines Azure Repos Git-Repositorys in Microsoft Learn.
-
Führe
git remote add origin URL
aus, und ersetze dabeiURL
durch die URL für das zuvor erstellte GitHub-Repository (z. B.https://github.com/octocat/example-repository.git
), um das GitHub-Repository als Remoterepository hinzuzufügen. -
Führe
git push --mirror origin
aus, um das Repository per Push an GitHub zu übertragen.Enthält das Repository Dateien, die größer als die maximale Dateigröße in GitHub Enterprise Server sind, führt der Pushvorgang möglicherweise zu einem Fehler. Führe
git lfs import
aus, um die großen Dateien in Git LFS zu verschieben, und versuch es dann erneut.
Migrieren mit git-tfs
Wenn du mit git-tfs
migrierst, bleibt der vollständige Verlauf deines TFVC-Repositorys erhalten.
Um diese Schritte auszuführen, musst du Windows verwenden und die folgenden Tools installiert haben:
- Visual Studio Team Explorer
git-tfs
, installiert mit Chocolatey oder durch manuelles Herunterladen der Binärversion- Git
- Git Large File Storage (Git LFS) (siehe Git Large File Storage installieren)
-
Erstelle ein neues Repository auf Ihre GitHub Enterprise Server-Instance. Initialisiere das neue Repository nicht mit README-, Lizenz- oder gitignore-Dateien, um Fehler zu vermeiden. Du kannst diese Dateien hinzufügen, nachdem dein Projekt per Push an GitHub Enterprise Server übergeben wurde. Weitere Informationen findest du unter Ein neues Repository erstellen.
-
Führe
git --version.
aus, um zu bestätigen, dass Git auf deinem Computer installiert ist.Die Ausgabe sollte in etwa wie folgt aussehen:
git version 2.40.0
. -
Führe
git tfs --version
aus, um zu bestätigen, dassgit-tfs
auf deinem Computer installiert ist.Der Beginn der Ausgabe sollte
git-tfs version 0.32.0.0 (TFS client library 16.0.0.0 (MS))
ähneln.Wenn du eine
Unable to load DLL 'Microsoft.VisualStudio.Setup.Configuration.Native.dll': The specified module could not be found. (Exception from HRESULT: 0x8007007E)
ähnelnde Ausgabe erhältst, stelle sicher, dass Visual Studio Team Explorer ordnungsgemäß installiert ist. -
Führe
git lfs --version
aus, um zu bestätigen, dass Git LFS auf deinem Computer installiert ist.Die Ausgabe sollte in etwa wie folgt aussehen:
git-lfs/3.1.4 (GitHub; darwin arm64; go 1.18.1)
. -
Falls noch nicht geschehen, konfiguriere Git mit deinem Namen und deiner E-Mail-Adresse, indem du
git config --global user.name "NAME"
undgit config --global user.email EMAIL
ausführst und NAME durch deinen Namen und EMAIL durch deine E-Mail-Adresse ersetzt. -
Führe
git tfs clone
aus, und übergib die URL und den Repositorypfad deines TFVC-Repositorys als Argumente. Führe beispielsweisegit tfs clone --branches=all https://dev.azure.com/octocat $/example
aus, um dasexample
-Repository vonhttps://dev.azure.com/octocat
in ein im/example
-Verzeichnis gespeichertes Git-Repository zu konvertieren. -
Wechsle in das Verzeichnis für das neu erstellte Git-Repository.
-
Führe
git remote add origin URL
aus, und ersetze dabeiURL
durch die URL für das zuvor erstellte GitHub-Repository (z. B.https://github.com/octocat/example-repository.git
), um das GitHub-Repository als Remoterepository hinzuzufügen. -
Führe
git push --mirror origin
aus, um das Repository per Push an GitHub zu übertragen.Enthält das Repository Dateien, die größer als die maximale Dateigröße in GitHub Enterprise Server sind, führt der Pushvorgang möglicherweise zu einem Fehler. Führe
git lfs import
aus, um die großen Dateien in Git LFS zu verschieben, und versuch es dann erneut.