Octroi du rôle de migrateur pour GitHub Enterprise Importer

À propos du rôle de migrateur

Pour éviter aux propriétaires d’organisation de devoir effectuer des migrations, GitHub.com inclut un rôle distinct pour l’utilisation de GitHub Enterprise Importer. L’octroi du rôle de migrateur vous permet de désigner d’autres équipes ou individus pour gérer vos migrations.

Vous pouvez accorder le rôle de migrateur à un utilisateur individuel ou à une équipe. Nous vous recommandons vivement d’attribuer le rôle de migrateur à une équipe. Ensuite, vous pouvez personnaliser plus précisément qui peut exécuter une migration en ajustant l’appartenance à l’équipe. Pour plus d’informations sur la modification de l’appartenance à une équipe, consultez « Ajout de membres d’une organisation à une équipe » ou « Suppression de membres d’organisation d’une équipe ».

Vous pouvez uniquement accorder le rôle de migrateur pour une organisation sur GitHub.com. Si vous migrez un dépôt entre deux organisations sur GitHub.com, vous pouvez accorder le rôle de migrateur à la même personne ou à la même équipe pour les deux organisations, mais vous devez accorder chacune séparément.

Remarque : Vous ne pouvez pas accorder le rôle de migrateur pour les comptes d’entreprise. Par conséquent, vous pouvez exécuter une migration d’organisation seulement si vous êtes propriétaire de l’entreprise de destination. Toutefois, vous pouvez accorder le rôle de migrateur à ce propriétaire d’entreprise pour l’organisation source.

Après avoir accordé le rôle de migrateur, assurez-vous que le migrateur utilise un personal access token qui répond à toutes les conditions requises pour exécuter des migrations. Pour plus d’informations sur ces conditions, consultez « Gestion de l’accès pour GitHub Enterprise Importer ».

Pour voir les instructions d’utilisation de l’API, utilisez le sélecteur d’outils en haut de la page.

Octroi du rôle de migrateur avec l’ADO2GH extension

Sur GitHub.com, créez et enregistrez un personal access token qui répond à toutes les conditions d’octroi du rôle de migrateur. Pour obtenir la liste complète des conditions, consultez « Gestion de l’accès pour GitHub Enterprise Importer ».
Définissez le personal access token comme variable d’environnement, en remplaçant TOKEN dans les commandes ci-dessous par le personal access token que vous avez enregistré ci-dessus.
- Si vous utilisez le Terminal, utilisez la commande export.
  Shell
```
export GH_PAT="TOKEN"
```
- Si vous utilisez PowerShell, utilisez la commande $env.
  Shell
```
$env:GH_PAT="TOKEN"
```
Utilisez la commande gh ado2gh grant-migrator-role en remplaçant ORGANIZATION par l’organisation pour laquelle vous souhaitez accorder le rôle de migrateur, ACTOR par le nom d’utilisateur ou d’équipe et TYPE par USER ou TEAM.
Shell
```
gh ado2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
```

Octroi du rôle de migrateur avec l’BBS2GH extension

Remarque : Les migrations à partir de Bitbucket Server utilisant GitHub Enterprise Importer sont actuellement en version bêta privée et sont susceptibles être modifiées. Pour demander l’accès à la version bêta, consultez Rejoindre la liste d’attente des migrations Bitbucket Server.

Sur GitHub.com, créez et enregistrez un personal access token qui répond à toutes les conditions d’octroi du rôle de migrateur. Pour obtenir la liste complète des conditions, consultez « Gestion de l’accès pour GitHub Enterprise Importer ».
Définissez le personal access token comme variable d’environnement, en remplaçant TOKEN dans les commandes ci-dessous par le personal access token que vous avez enregistré ci-dessus.
- Si vous utilisez le Terminal, utilisez la commande export.
  Shell
```
export GH_PAT="TOKEN"
```
- Si vous utilisez PowerShell, utilisez la commande $env.
  Shell
```
$env:GH_PAT="TOKEN"
```
Utilisez la commande gh bbs2gh grant-migrator-role en remplaçant ORGANIZATION par l’organisation pour laquelle vous souhaitez accorder le rôle de migrateur, ACTOR par le nom d’utilisateur ou d’équipe et TYPE par USER ou TEAM.
Shell
```
gh bbs2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
```

Octroi du rôle de migrateur avec l’GEI extension

Remarque : GitHub CLI ne prend pas en charge l’octroi du rôle de migrateur pour les organisations sur GitHub Enterprise Server, donc vous devez être propriétaire de l’organisation source pour migrer des dépôts à partir de GitHub Enterprise Server.

Sur GitHub.com, créez et enregistrez un personal access token qui répond à toutes les conditions d’octroi du rôle de migrateur. Pour obtenir la liste complète des conditions, consultez « Gestion de l’accès pour GitHub Enterprise Importer ».
Définissez le personal access token comme variable d’environnement, en remplaçant TOKEN dans les commandes ci-dessous par le personal access token que vous avez enregistré ci-dessus.
- Si vous utilisez le Terminal, utilisez la commande export.
  Shell
```
export GH_PAT="TOKEN"
```
- Si vous utilisez PowerShell, utilisez la commande $env.
  Shell
```
$env:GH_PAT="TOKEN"
```
Utilisez la commande gh gei grant-migrator-role en remplaçant ORGANIZATION par l’organisation pour laquelle vous souhaitez accorder le rôle de migrateur, ACTOR par le nom d’utilisateur ou d’équipe et TYPE par USER ou TEAM.
Shell
```
gh gei grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
```

To see instructions for using the GitHub CLI, use the tool switcher at the top of the page.

Octroi du rôle de migrateur avec l’API GraphQL

Vous pouvez utiliser la mutation GraphQL grantMigratorRole pour attribuer le rôle de migrateur et la mutation revokeMigratorRole pour révoquer le rôle de migrateur.

Vous devez utiliser un personal access token (PAT) qui répond à tous les besoins d’accès. Pour plus d’informations, consultez « Gestion de l’accès pour GitHub Enterprise Importer ».

Mutation `grantMigratorRole`

Cette mutation GraphQL définit le rôle de migrateur.

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

Variable de requête	Description
`organizationId`	`ownerId` (ou ID d’organisation) de votre organisation, issu de la requête `GetOrgInfo`.
`actor`	Équipe ou nom d’utilisateur auquel vous souhaitez attribuer le rôle de migrateur.
`actor_type`	Spécifiez si le migrateur est un `USER` ou une `TEAM`.

Mutation `revokeMigratorRole`

Cette mutation supprime le rôle de migrateur.

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