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 deine erste Migration ist, musst du GitHub CLI und die 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 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. Lege Umgebungsvariablen für die personal access tokens fest, indem du TOKEN in den Befehlen unten durch die personal access tokens ersetzt, die du zuvor erstellt hast. 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.

Nächste Schritte

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