Skip to main content
Skip to content

Manage access

Set up the required access for migrating from Azure DevOps to GitHub.

To migrate repositories from Azure DevOps to GitHub, you need sufficient access to the source (an organization on Azure DevOps) and the destination (an organization on GitHub). After you complete the steps in this article, your access and permissions will ready for your migration.

Decide who will perform the migration

If the person who will perform the migration is not a GitHub organization owner, a GitHub organization owner must first grant them the migrator role.

  • If you're a GitHub organization owner, and intend to perform the migration yourself, you can continue reading this guide.
  • If you wish to assign the migrator role to someone else, do that now. Then, the migrator should perform the rest of the steps in these guides. See Granting the migrator role.

Create a personal access token (classic) on GitHub

Next, you will need to create a personal access token (classic) which the ADO2GH extension of the GitHub CLI will use to communicate with GitHub. GitHub personal access token (classic)に必要なスコープは、あなたの役割と実行したいタスクによって異なります。

メモ

personal access token (classic) のみを使用でき、fine-grained personal access token は使用できません。つまり、組織が "組織へのアクセスをGitHub Enterprise Importerに制限する" ポリシーを使用している場合、personal access tokens (classic)を使用することはできません。 詳しくは、「Enterprise 内の個人用アクセス トークンに対するポリシーの適用」をご覧ください。

タスク組織の所有者移行ツール
リポジトリ移行用の移行ロールを割り当てるadmin:org
リポジトリの移行の実行 (移行先の Organization)
repo、workflow、admin:org
repo、workflow、read:org
移行ログのダウンロード
repo、workflow、admin:org
repo、workflow、read:org
マネキンの回収
repo、workflow、admin:org

To learn how to create the token, see 個人用アクセス トークンを管理する.

Create a Personal access token on Azure

Your Azure DevOps personal access token must have work item (read), code (read), and identity (read) scopes.

We recommend that you grant full access to your personal access token so you can use the inventory-report flag in phase 4.

If you want to migrate from multiple organizations, allow the personal access token to access all accessible organizations.

See Use personal access tokens in Microsoft Docs.

Configure IP allow lists on GitHub

If you use GitHub's IP allow list feature, you must add the GitHub IP ranges below to the allow list for the source and/or destination organizations.

If your destination organization is on GitHub.com, you will need to allow the following IP addresses:

  • 192.30.252.0/22
  • 185.199.108.0/22
  • 140.82.112.0/20
  • 143.55.64.0/20
  • 135.234.59.224/28 (2025 年 7 月 28 日に追加)
  • 2a0a:a440::/29
  • 2606:50c0::/32
  • 20.99.172.64/28 (2025 年 7 月 28 日に追加)

See 組織に対する許可 IP アドレスを管理する and IP 許可リストを使用して Enterprise へのネットワーク トラフィックを制限する.

Temporarily configure your identity provider's (IdP) restrictions

If you use your IdP's IP allow list (such as Azure CAP) to restrict access to your enterprise on GitHub, you should disable these restrictions in your enterprise account settings until after your migration is complete.

Allow migrations to bypass repository rulesets

移行先の組織または企業でルールセットが有効になっている場合、移行されたリポジトリの履歴がそれらのルールに違反する可能性があります。 ルールセットを無効にせずに移行を許可するには、該当する各ルールセットのバイパス リストに "Repository migrations" を追加します。 このバイパスは、移行中にのみ適用されます。 完了すると、すべての新しいコントリビューションにルールセットが適用されます。

バイパスを構成するには:

  1. 各エンタープライズまたは組織のルール セットに移動します。
  2. [バイパス リスト] セクションで、[バイパスの 追加] をクリックします。
  3. [リポジトリの移行] を選択します。

詳細については、「組織内のリポジトリのルールセットを作成する」および「リポジトリ移行のルールセットのバイパス設定」を参照してください。