# Octroi du rôle de migrateur

Le rôle de migration permet à un utilisateur ou à une équipe d’exécuter des migrations au nom d’une organisation.

Pour permettre à une personne autre que le propriétaire de l'organisation d'exécuter une migration ou de télécharger les journaux de migration, vous pouvez octroyer le rôle de migrateur à un utilisateur ou à une équipe.

Pour accorder le rôle de migration à l’aide de l’interface CLI, vous pouvez utiliser le GL2GH extension of the GitHub CLI.

1. Installez le GitHub CLI.
   * Pour obtenir des instructions d’installation pour GitHub CLI, consultez le [dépôt GitHub CLI](https://github.com/cli/cli#installation).
   * Si vous avez GitHub CLI déjà installé, exécutez `gh --version` pour vous assurer que vous exécutez la version 2.4.0 ou ultérieure. Si vous avez une version antérieure, consultez le [GitHub CLI référentiel](https://github.com/cli/cli#installation) pour obtenir des instructions de mise à niveau.
1. Installez le GL2GH extension.

   ```shell copy
   gh extension install github/gh-gl2gh
   ```

1. La GL2GH extension of the GitHub CLI mise à jour est fréquemment mise à jour. Pour être sûr d’utiliser la version la plus récente, mettez à jour l’extension.

    ```shell copy
    gh extension upgrade github/gh-gl2gh
    ```

1. Sur GitHub, créez et enregistrez un personal access token qui a l’étendue `admin:org` .
1. Définissez le personal access token comme variable d’environnement, en remplaçant TOKEN dans les commandes ci-dessous par le personal access token que vous avez enregistré ci-dessus.

   * Si vous utilisez le Terminal, utilisez la commande `export`.

      ```shell copy
      export GH_PAT="TOKEN"
      ```

   * Si vous utilisez PowerShell, utilisez la commande `$env`.

      ```shell copy
      $env:GH_PAT="TOKEN"
      ```
1. Utilisez la commande `gh gl2gh grant-migrator-role` en remplaçant ORGANIZATION par l’organisation pour laquelle vous souhaitez accorder le rôle de migrateur, ACTOR par le nom d’utilisateur ou d’équipe et TYPE par `USER` ou `TEAM`.

   ```shell copy
   gh gl2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
   ```

   >[!NOTE] Si vous accordez le rôle de migration pour GHE.com, vous devez également inclure l’URL de l’API cible pour le sous-domaine de votre entreprise. Par exemple : `--target-api-url https://api.octocorp.ghe.com`.