Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

Cette version de GitHub Enterprise a été abandonnée le 2023-03-15. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Octroi du rôle de migrateur pour GitHub Enterprise Importer

Pour permettre à une personne qui n’est pas propriétaire d’organisation d’exécuter des migrations, vous pouvez lui accorder (ou à une équipe) le rôle de migrateur.

Qui peut utiliser cette fonctionnalité

Organization owners can grant the migrator role.

À 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

  1. 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 ».

  2. 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"
  3. 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.

  1. 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 ».

  2. 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"
  3. 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.

  1. 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 ».

  2. 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"
  3. 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êteDescription
organizationIdownerId (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_typeSpé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 }
}