Installieren und Konfigurieren von GitHub Enterprise Importer

Schritt 1: Installieren des GL2GH 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 GL2GH 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 GL2GH extension.

   Shell

   gh extension install github/gh-gl2gh
   

3. Die GL2GH extension of the GitHub CLI Aktualisierung erfolgt häufig. Aktualisieren die Erweiterung, um sicherzustellen, dass du die neueste Version verwendest.

   Shell

   gh extension upgrade github/gh-gl2gh
   

Schritt 2: Festlegen von Umgebungsvariablen

Bevor Sie die GL2GH extension Migration verwenden GitHub Enterprise Cloudkönnen, müssen Sie S erstellen personal access token, die auf die Quelle und das Ziel zugreifen können, und dann die personal access tokens als Umgebungsvariablen festlegen.

1. Stellen Sie sicher, dass Sie Ihre s sowohl für GitLab als auch für personal access token GitLab bereit habenGitHub. Wenn Sie noch kein Token erstellt haben, lesen Sie Verwalten des Zugriffs für eine Migration von GitLab zu GitHub .

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. Wird GH_PAT für die Zielorganisation und GITLAB_PAT für die GitLab-Quellinstanz verwendet.

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

     Shell

     export GH_PAT="TOKEN"
     export GITLAB_PAT="TOKEN"
     

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

     Shell

     $env:GH_PAT="TOKEN"
     $env:GITLAB_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.