Importieren von Repositorys von TFVC zu Git

  • Artikel
  • 3 Minuten Lesedauer

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Sie können Code von einem vorhandenen TFVC-Repository zu einem neuen Git-Repository innerhalb derselben Organisation migrieren. Die Migration zu Git ist ein beteiligter Prozess für große TFVC-Repositorys und Teams. Zentralisierte Versionssteuerungssysteme wie TFVC verhalten sich anders als Git auf grundlegende Weise. Der Schalter umfasst viel mehr als das Lernen neuer Befehle. Es ist eine unterbrechungsfreie Änderung, die eine sorgfältige Planung erfordert. Sie müssen folgendes berücksichtigen:

  • Überarbeitung von Tools und Prozessen
  • Entfernen von Binärdateien und ausführbaren Dateien
  • Schulung Ihres Teams

Hinweis

Das in diesem Artikel dokumentierte Feature erfordert TFS 2017 Update 2 oder höher.

Wir empfehlen dringend, unsere Whitepapers zu lesen - Zentrale Versionskontrolle für Git und TFVC zu Git , bevor Sie die Migration starten.

Die Importerfahrung eignet sich hervorragend für kleine einfache TFVC-Repositorys. Es ist auch gut für Repositorys, die bereits "bereinigt" wurden, wie in den vorherigen Whitepapers beschrieben. Diese Whitepaper empfehlen auch andere Tools für erweiterte TFVC-Repositorykonfigurationen.

Wichtig

Aufgrund der Unterschiede beim Verlauf der TFVC- und Git Store-Versionskontrolle empfehlen wir, dass Sie Ihren Verlauf nicht migrieren. Dies ist auch der Ansatz, den Microsoft verfolgt hat, als Windows und andere Produkte von der zentralen Versionskontrolle zu Git migriert wurden.

Importieren des Repositorys

  1. Wählen Sie Repos, Dateien aus.

    View your branches

  2. Wählen Sie im Dropdownmenü "Repo" die Option "Repository importieren" aus.

    Import Repository Option

  3. Wählen Sie TFVC aus der Dropdownliste "Quelltyp " aus.

  4. Geben Sie den Pfad zum Repository / Branch / Folder ein, den Sie in das Git-Repository importieren möchten. Zum Beispiel, $/Fabrikam/FabrikamWebsite

  5. Wenn Sie den Verlauf aus dem TFVC-Repository migrieren möchten, klicken Sie auf " Verlauf migrieren", und wählen Sie die Anzahl der Tage aus. Sie können bis zu 180 Tage Verlauf ab dem neuesten Änderungenet migrieren. Ein Link zum TFVC-Repository wird in der Commitnachricht des 1. Changeset hinzugefügt, das zu Git migriert wird. Dies macht es einfach, ältere Geschichte bei Bedarf zu finden.

  6. Geben Sie dem neuen Git-Repository einen Namen, und klicken Sie auf "Importieren". Je nach Größe des Imports wäre Ihr Git-Repository in wenigen Minuten bereit.

    Import Repository Dialog

  1. Wählen Sie im Dropdownmenü "Repo" die Option "Repository importieren" aus.

Import Repository Option

  1. Wählen Sie TFVC aus der Dropdownliste "Quelltyp " aus.

  2. Geben Sie den Pfad zum Repository / Branch / Folder ein, den Sie in das Git-Repository importieren möchten. Zum Beispiel, $/Fabrikam/FabrikamWebsite

  3. Wenn Sie den Verlauf aus dem TFVC-Repository migrieren möchten, klicken Sie auf " Verlauf migrieren", und wählen Sie die Anzahl der Tage aus. Sie können bis zu 180 Tage Verlauf ab dem neuesten Änderungenet migrieren. Ein Link zum TFVC-Repository wird in der Commitnachricht des 1. Changeset hinzugefügt, das zu Git migriert wird. Dies macht es einfach, ältere Geschichte bei Bedarf zu finden.

  4. Geben Sie dem neuen Git-Repository einen Namen, und klicken Sie auf "Importieren". Je nach Größe des Imports wäre Ihr Git-Repository in wenigen Minuten bereit.

Import Repository Dialog

Wichtig

Aufgrund der Unterschiede beim Verlauf der TFVC- und Git Store-Versionskontrolle empfehlen wir, dass Sie Ihren Verlauf nicht migrieren. Dies ist auch der Ansatz, den Microsoft verfolgt hat, als Windows und andere Produkte von der zentralen Versionskontrolle zu Git migriert wurden.

Problembehandlung

Diese Erfahrung ist für kleine, einfache TFVC-Repositorys oder Repositorys optimiert, die für eine Migration vorbereitet wurden. Dies bedeutet, dass es einige Einschränkungen hat.

  1. Es migriert nur den Inhalt des Stamms oder eines Zweigs. Wenn Sie beispielsweise über ein TFVC-Projekt verfügen, bei $/Fabrikam dem 1 Verzweigung und 1 Ordner darin enthalten sind, würde ein Pfad zum Importieren $/Fabrikam den Ordner importieren, während $/Fabrikam/<branch> nur die Verzweigung importiert würde.
  2. Das importierte Repository und der zugeordnete Verlauf (wenn importiert) kann 1 GB nicht überschreiten.
  3. Sie können bis zu 180 Tage Verlauf importieren.

Wenn es sich bei einem der obigen Elemente um einen Blocker für Ihren Import handelt, empfehlen wir Ihnen, externe Tools wie Git-TFS zum Importieren und Lesen unserer Whitepapers zu testen – Zentrale Versionssteuerung auf Git und TFVC zu Git