Skip to main content

授予迁移者角色

迁移者角色使用户或团队能够代表组织运行迁移。

若要允许除组织所有者以外的其他人运行迁移或下载迁移日志,可以向用户或团队授予迁移者角色。

若要使用 CLI 授予迁移者角色,可以使用 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. 在 GitHub 上,创建并记录一个具有 admin:org 范围的 personal access token。

  5. 将 personal access token 设置为环境变量,将以下命令中的 TOKEN 替换为你在上面记录的 personal access token。

    • 如果使用终端,请使用 export 命令。

      Shell
      export GH_PAT="TOKEN"
      
    • 如果使用 PowerShell,请使用 $env 命令。

      Shell
      $env:GH_PAT="TOKEN"
      
  6. 使用 gh ado2gh grant-migrator-role 命令,将 ORGANIZATION 替换为你要为其授予迁移者角色的组织,将 ACTOR 替换为用户或团队名称,并将 TYPE 替换为 USERTEAM

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

    注意

    如果你要授予 GHE.com 的迁移者角色,则你还必须包含企业子域的目标 API URL。 例如:--target-api-url https://api.octocorp.ghe.com