Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。 最新の情報については、「英語のドキュメント」を参照してください。

GitHub Enterprise Importer に移行者ロールを付与する

Organization の所有者ではないユーザーが移行を実行できるようにするには、ユーザーまたはチームに移行者ロールを付与します。

この機能を使用できるユーザー

Organization owners can grant the migrator role.

移行者ロールについて

Organization の所有者が移行を完了する必要を取り除くために、GitHub.com には、GitHub Enterprise Importer を使うための個別のロールが含まれています。 移行者ロールを付与すると、移行を処理する他のチームまたは個人を指定できます。

移行者ロールは、個々のユーザーまたはチームに付与できます。 移行者ロールをチームに割り当てることを強くお勧めします。 その後、チーム メンバーシップを調整することで、移行を実行できるユーザーをさらにカスタマイズできます。 チーム メンバーシップの変更について詳しくは、「Team への Organization メンバーの追加」または「Team から Organization メンバーを削除する」をご覧ください。

移行者ロールは、GitHub.com 上の Organization に対してのみ付与できます。 GitHub.com 上の 2 つの Organization 間でリポジトリを移行する場合は、両方の Organization の同じユーザーまたはチームに移行者ロールを付与できますが、それぞれを個別に付与する必要があります。

注: Enterprise アカウントに移行者ロールを付与することはできません。 そのため、Organization の移行は、移行先 Enterprise の所有者である場合にのみ実行できます。 ただし、移行元の Organization の Enterprise 所有者に移行者ロールを付与できます。

移行者ロールを付与したら、移行を実行するためのすべての要件を満たす personal access token を移行者が使っていることを確認します。 これらの要件について詳しくは、「GitHub Enterprise Importer のアクセスの管理」をご覧ください。

API の使い方を確認するには、ページの上部にあるツール スイッチャーを使います。

ADO2GH extension を使って移行者ロールを付与する

  1. GitHub.com で、移行者ロールを付与するためのすべての要件を満たす personal access token を作成して記録します。 すべての要件の一覧については、「GitHub Enterprise Importer のアクセスの管理」をご覧ください。

  2. personal access token を環境変数として設定します。次のコマンドの TOKEN は、上で記録した personal access token に置き換えます。

    • ターミナルを使っている場合は、export コマンドを使います。
      Shell
      export GH_PAT="TOKEN"
    • PowerShell を使っている場合は、$env コマンドを使います。
      Shell
      $env:GH_PAT="TOKEN"
  3. 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

BBS2GH extension を使って移行者ロールを付与する

注: 現在、GitHub Enterprise Importer を使った Bitbucket Server からの移行はプライベート ベータ版であり、変更される可能性があります。 ベータ版へのアクセスを要求するには、「Bitbucket Server 移行待機リストに参加する」を参照してください。

  1. GitHub.com で、移行者ロールを付与するためのすべての要件を満たす personal access token を作成して記録します。 すべての要件の一覧については、「GitHub Enterprise Importer のアクセスの管理」をご覧ください。

  2. personal access token を環境変数として設定します。次のコマンドの TOKEN は、上で記録した personal access token に置き換えます。

    • ターミナルを使っている場合は、export コマンドを使います。
      Shell
      export GH_PAT="TOKEN"
    • PowerShell を使っている場合は、$env コマンドを使います。
      Shell
      $env:GH_PAT="TOKEN"
  3. gh bbs2gh grant-migrator-role コマンドを使って、ORGANIZATION を移行者ロールを付与する Organization に、ACTOR をユーザーまたはチーム名に、TYPE を USER または TEAM に置き換えます。

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

GEI extension を使って移行者ロールを付与する

注: GitHub CLI では、GitHub Enterprise Server 上の Organization への移行者ロールの付与はサポートされていません。を付与することはできません。そのため、GitHub Enterprise Server からリポジトリを移行するには、移行元 Organization の Organization 所有者である必要があります。

  1. GitHub.com で、移行者ロールを付与するためのすべての要件を満たす personal access token を作成して記録します。 すべての要件の一覧については、「GitHub Enterprise Importer のアクセスの管理」をご覧ください。

  2. personal access token を環境変数として設定します。次のコマンドの TOKEN は、上で記録した personal access token に置き換えます。

    • ターミナルを使っている場合は、export コマンドを使います。
      Shell
      export GH_PAT="TOKEN"
    • PowerShell を使っている場合は、$env コマンドを使います。
      Shell
      $env:GH_PAT="TOKEN"
  3. gh gei grant-migrator-role コマンドを使って、ORGANIZATION を移行者ロールを付与する Organization に、ACTOR をユーザーまたはチーム名に、TYPE を USER または TEAM に置き換えます。

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

GitHub CLI の使い方を確認するには、ページの上部にあるツール スイッチャーを使います。

GraphQL API を使って移行者ロールを付与する

grantMigratorRole GraphQL ミューテーションを使って移行者ロールを割り当て、revokeMigratorRole ミューテーションを使って移行者ロールを取り消すことができます。

すべてのアクセス要件を満たす personal access token (PAT) を使う必要があります。 詳しくは、「GitHub Enterprise Importer のアクセスの管理」を参照してください。

grantMigratorRole ミューテーション

この GraphQL ミューテーションは、移行ロールを設定します。

mutation grantMigratorRole (
  $organizationId: ID!,
  $actor: String!,
  $actor_type: ActorType!
) {
  grantMigratorRole( input: {
    organizationId: $organizationId,
    actor: $actor,
    actorType: $actor_type
  })
   { success }
}
クエリ変数説明
organizationIdownerId クエリからの Organization の GetOrgInfo (または Organization ID)。
actor移行ロールを割り当てるチームまたはユーザー名。
actor_type移行者が USERTEAM のどちらであるかを指定します。

revokeMigratorRole ミューテーション

このミューテーションにより、移行者ロールが削除されます。

mutation revokeMigratorRole (
  $organizationId: ID!,
  $actor: String!,
  $actor_type: ActorType!
) {
  revokeMigratorRole( input: {
    organizationId: $organizationId,
    actor: $actor,
    actorType: $actor_type
  })
   { success }
}