Phase 3 Installieren und Konfigurieren von GitHub Enterprise Importer

Installieren Sie ADO2GH extension of the GitHub CLI und konfigurieren Sie Ihre Umgebung für die Migration.

In diesem Artikel

Schritt 1: Installieren der 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.

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 du die ADO2GH extension zum Migrieren zu GitHub Enterprise Cloud verwenden kannst, musst du personal access token erstellen, die auf die Quell- und Zielorganisationen zugreifen können, und dann die personal access token als Umgebungsvariablen festlegen.

  1. Stellen Sie sicher, dass Ihre personal access tokens sowohl für GitHub als auch für Azure DevOps bereit sind. Weitere Informationen findest du unter Phase 2. Verwalten des Zugriffs.

  2. Legen Sie Umgebungsvariablen für die personal access token fest. Ersetzen Sie TOKEN in den nachfolgenden Befehlen durch die personal access token, 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. Lege bei der Migration zu GitHub Enterprise-Cloud mit Datenresidenz der Einfachheit halber eine Umgebungsvariable für die Basis-API-URL für dein 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"

    Du verwendest diese Variable mit der Option --target-api-url in Befehlen, die du mit der GitHub CLI ausführst.

Nächste Schritte

In der nächsten Phase verwenden Sie GitHub Enterprise Cloud, um sich auf die Migration vorzubereiten. Weitere Informationen findest du unter Phase 4. Vorbereiten der Migration von Azure DevOps auf GitHub.