Installieren und Konfigurieren von GitHub Enterprise Importer

Schritt 1: Installieren des ADO2GH extension of the GitHub CLI

GitHub Enterprise Importer ist eine Sammlung von Erweiterungen für GitHub CLI. Wenn dies Ihre erste Migration ist, müssen Sie GitHub CLI und ADO2GH extension installieren.

1. Installieren Sie GitHub CLI.

   • Installationsanweisungen für GitHub CLI findest du im GitHub CLI-Repository.
   • Wenn Sie GitHub CLI bereits installiert haben, führen Sie gh --version aus, um zu bestätigen, dass Sie Version 2.4.0 oder höher verwenden. Wenn Sie über eine ältere Version verfügen, besuchen Sie das GitHub CLI Repository , um Upgradeanweisungen zu erhalten.

2. Installieren Sie ADO2GH extension.

   Shell

   gh extension install github/gh-ado2gh
   

3. Die ADO2GH extension of the GitHub CLI wird wöchentlich aktualisiert. Aktualisieren die Erweiterung, um sicherzustellen, dass du die neueste Version verwendest.

   Shell

   gh extension upgrade github/gh-ado2gh
   

Wenn du Hilfe zur ADO2GH extension benötigst, kannst du immer das Flag --help mit einem Befehl verwenden. Mit gh ado2gh --help listest du z. B. alle verfügbaren Befehle auf, und mit gh ado2gh migrate-repo --help zeigst du alle Optionen an, die für den Befehl migrate-repo verfügbar sind.

Schritt 2: Festlegen von Umgebungsvariablen

Bevor Sie das ADO2GH extension für die Migration zu GitHub Enterprise Cloud verwenden können, müssen Sie personal access tokens erstellen, die auf die Quell- und Zielorganisationen zugreifen können, und die personal access tokens als Umgebungsvariablen festlegen.

1. Stellen Sie sicher, dass Ihre personal access token sowohl für GitHub als auch für Azure DevOps bereit sind. Wenn Sie noch kein Token erstellt haben, lesen Sie Zugriff verwalten .

2. Legen Sie Umgebungsvariablen für die personal access tokens fest und ersetzen Sie TOKEN in den folgenden Befehlen durch die personal access tokens, die Sie zuvor erstellt haben. Verwende das GH_PAT für die Zielorganisation und das ADO_PAT für die Quellorganisation.

   • Wenn du ein Terminal verwendest, führe den Befehl export aus.

     Shell

     export GH_PAT="TOKEN"
     export ADO_PAT="TOKEN"
     

   • Wenn du PowerShell verwendest, führe den Befehl $env aus.

     Shell

     $env:GH_PAT="TOKEN"
     $env:ADO_PAT="TOKEN"
     

3. Wenn Sie auf GitHub Enterprise-Cloud mit Datenresidenz migrieren, legen Sie zur Vereinfachung eine Umgebungsvariable für die Basis-API-URL für Ihr Unternehmen fest.

   Stellen Sie sicher, dass Sie SUBDOMAIN durch die Unterdomäne Ihres Unternehmens ersetzen. Wenn die Unterdomäne Ihres Unternehmens beispielsweise "acme" lautet, wäre der Wert von "TARGET_API_URL" "https://api.acme.ghe.com".

   • Wenn du ein Terminal verwendest, führe den Befehl export aus.

     Shell

     export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     

   • Wenn du PowerShell verwendest, führe den Befehl $env aus.

     Shell

     $env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     

   Sie verwenden diese Variable mit der --target-api-url-Option in Befehlen, die Sie mit der GitHub CLI ausführen.