Skip to main content
Skip to content

Granting the migrator role

The migrator role gives a user or team the ability to run migrations on behalf of an organization.

To allow someone other than an organization owner to run a migration or download migration logs, you can grant the migrator role to a user or team.

To grant the migrator role using the CLI, you can use the ADO2GH extension of the GitHub CLI.

  1. Установите GitHub CLI.

    • Инструкции по установке для GitHub CLI см. в репозитории GitHub CLI.
    • Если уже установлена GitHub CLI , запустите gh --version , чтобы убедиться, что у вас версия 2.4.0 или новее. Если у вас более старая версия, посетите GitHub CLI репозиторий для инструкций по обновлению.
  2. Установите ADO2GH extension.

    Shell
    gh extension install github/gh-ado2gh
    
  3. Обновление ADO2GH extension of the GitHub CLI обновляется еженедельно. Чтобы убедиться, что вы используете последнюю версию, обновите расширение.

    Shell
    gh extension upgrade github/gh-ado2gh
    
  4. On GitHub, create and record a personal access token that has the admin:org scope.

  5. Задайте для personal access token в качестве переменной среды, заменив TOKEN в командах ниже personal access token, записанных выше.

    • Если вы используете терминал, используйте export команду.

      Shell
      export GH_PAT="TOKEN"
      
    • Если вы используете PowerShell, используйте $env команду.

      Shell
      $env:GH_PAT="TOKEN"
      
  6. Use the gh ado2gh grant-migrator-role command, replacing ORGANIZATION with the organization you want to grant the migrator role for, ACTOR with the user or team name, and TYPE with USER or TEAM.

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

    Примечание.

    Если вы предоставляете роль GHE.comмиграции для, необходимо также включить URL-адрес целевого API для поддомена предприятия. Например: --target-api-url https://api.octocorp.ghe.com.