移行者ロールの付与

Organization の所有者以外のユーザーが移行を実行したり、移行ログをダウンロードしたりできるようにするには、ユーザーまたはチームに移行者ロールを付与します。

CLI を使用して移行者ロールを付与するには、ADO2GH extension of the GitHub CLI を使用します。

1.        GitHub CLIをインストールします。
   

   • GitHub CLI のインストール手順については、GitHub CLI リポジトリを参照してください。

   •      GitHub CLIが既にインストールされている場合は、`gh --version`を実行して、バージョン 2.4.0 以降を実行していることを確認します。 古いバージョンをお持ちの場合は、 [GitHub CLI リポジトリ](https://github.com/cli/cli#installation) にアクセスしてアップグレード手順を確認してください。
     

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 を移行者ロールを付与する Organization に、ACTOR をユーザーまたはチーム名に、TYPE を `USER` または `TEAM` に置き換えます。
   

   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)。