移行者ロールについて
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
を使って移行者ロールを付与する
-
GitHub.com で、移行者ロールを付与するためのすべての要件を満たす personal access token を作成して記録します。 すべての要件の一覧については、「GitHub Enterprise Importer のアクセスの管理」をご覧ください。
-
personal access token を環境変数として設定します。次のコマンドの TOKEN は、上で記録した personal access token に置き換えます。
-
ターミナルを使っている場合は、
exportコマンドを使います。Shell export GH_PAT="TOKEN"
export GH_PAT="TOKEN" -
PowerShell を使っている場合は、
$envコマンドを使います。Shell $env:GH_PAT="TOKEN"
$env:GH_PAT="TOKEN"
-
-
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
gh ado2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
BBS2GH extension
を使って移行者ロールを付与する
注: 現在、GitHub Enterprise Importer を使った Bitbucket Server からの移行はパブリック ベータ版であり、変更される可能性があります。
-
GitHub.com で、移行者ロールを付与するためのすべての要件を満たす personal access token を作成して記録します。 すべての要件の一覧については、「GitHub Enterprise Importer のアクセスの管理」をご覧ください。
-
personal access token を環境変数として設定します。次のコマンドの TOKEN は、上で記録した personal access token に置き換えます。
-
ターミナルを使っている場合は、
exportコマンドを使います。Shell export GH_PAT="TOKEN"
export GH_PAT="TOKEN" -
PowerShell を使っている場合は、
$envコマンドを使います。Shell $env:GH_PAT="TOKEN"
$env:GH_PAT="TOKEN"
-
-
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
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 所有者である必要があります。
-
GitHub.com で、移行者ロールを付与するためのすべての要件を満たす personal access token を作成して記録します。 すべての要件の一覧については、「GitHub Enterprise Importer のアクセスの管理」をご覧ください。
-
personal access token を環境変数として設定します。次のコマンドの TOKEN は、上で記録した personal access token に置き換えます。
-
ターミナルを使っている場合は、
exportコマンドを使います。Shell export GH_PAT="TOKEN"
export GH_PAT="TOKEN" -
PowerShell を使っている場合は、
$envコマンドを使います。Shell $env:GH_PAT="TOKEN"
$env:GH_PAT="TOKEN"
-
-
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
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 }
}
| クエリ変数 | 説明 |
|---|---|
organizationId | ownerId クエリからの Organization の GetOrgInfo (または Organization ID)。 |
actor | 移行ロールを割り当てるチームまたはユーザー名。 |
actor_type | 移行者が USER か TEAM のどちらであるかを指定します。 |
revokeMigratorRole ミューテーション
このミューテーションにより、移行者ロールが削除されます。
mutation revokeMigratorRole (
$organizationId: ID!,
$actor: String!,
$actor_type: ActorType!
) {
revokeMigratorRole( input: {
organizationId: $organizationId,
actor: $actor,
actorType: $actor_type
})
{ success }
}