Gewähren der Migrationsrolle

Die Migrationsrolle gibt einem Benutzer oder Team die Möglichkeit, Migrationen im Auftrag einer Organisation auszuführen.

Um einer anderen Person als einer Organisationsbesitzer das Ausführen einer Migration oder das Herunterladen von Migrationsprotokollen zu ermöglichen, können einem Benutzer oder Team die Migrationsrolle zuweisen.

Um die Migratorrolle über die CLI zu vergeben, können Sie ADO2GH extension of the GitHub CLI verwenden.

  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

  4. Auf GitHub wird ein personal access token mit dem Gültigkeitsbereich admin:org erstellt und aufgezeichnet.

  5. Lege das personal access token als Umgebungsvariable fest, und ersetze in den folgenden Befehlen TOKEN durch das personal access token, das du oben gespeichert hast.

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

      Shell
      export GH_PAT="TOKEN"

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

      Shell
      $env:GH_PAT="TOKEN"

  6. Verwende den Befehl gh ado2gh grant-migrator-role, und ersetze ORGANIZATION durch die Organisation, der du die Migrationsrolle zuweisen möchtest, ACTOR durch den Benutzer- oder Teamnamen und TYPE durch USER oder TEAM.

    Shell
    gh ado2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE

    Hinweis

    Wenn du die Migrationsrolle für GHE.com gewährst, musst du auch die Ziel-API-URL für die Unterdomäne deines Unternehmens einschließen. Beispiel: --target-api-url https://api.octocorp.ghe.com