移行者ロールの付与

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

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 を移行者ロールを付与する 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)。