Concesión del rol de migración para GitHub Enterprise Importer

En este artículo

Para permitir que alguien que no es propietario de la organización ejecute migraciones, puedes conceder el rol de migración a una persona o equipo.

Quién puede usar esta característica

Organization owners can grant the migrator role.

Tool navigation

Acerca del rol de migración

Para quitar la necesidad de que los propietarios de la organización completen las migraciones, en GitHub.com se incluye un rol único para usar GitHub Enterprise Importer. La concesión del rol de migración te permite designar otros equipos o individuos para controlar las migraciones.

Puedes conceder el rol de migración a un usuario individual o a un equipo. Se recomienda encarecidamente asignar el rol de migración a un equipo. Después, puedes personalizar aún más quién puede ejecutar una migración si ajustas la pertenencia al equipo. Para más información sobre cómo cambiar la pertenencia al equipo, consulta "Agregar miembros de la organización a un equipo" o "Eliminar de un equipo a miembros de la organización".

Solo puedes conceder el rol de migración para una organización en GitHub.com. Si vas a migrar un repositorio entre dos organizaciones en GitHub.com, puedes conceder el rol de migración a la misma persona o equipo para las dos organizaciones, pero hacerlo por separado.

Nota: No puedes conceder el rol de migración para cuentas empresariales. Por tanto, solo puedes ejecutar una migración de la organización si eres propietario de la empresa de destino. Pero puedes conceder el rol de migración a ese propietario de empresa para la organización de origen.

Después de conceder el rol de migración, asegúrate de que el responsable de la migración usa una instancia de personal access token que cumpla todos los requisitos para ejecutar migraciones. Para más información sobre esos requisitos, consulta "Administración del acceso para GitHub Enterprise Importer".

A fin de ver instrucciones para usar la API, utiliza el conmutador de herramientas en la parte superior de la página.

Concesión del rol de migración con la ADO2GH extension

  1. En GitHub.com, crea y registra una instancia de personal access token que cumpla todos los requisitos para conceder el rol de migración. Para obtener una lista completa de los requisitos, consulta "Administración del acceso para GitHub Enterprise Importer".

  2. Establece personal access token como una variable de entorno, y reemplaza TOKEN en los comandos siguientes por el valor personal access token que has registrado antes.

    • Si usas Terminal, utiliza el comando export.

      Shell
      export GH_PAT="TOKEN"

    • Si usas PowerShell, utiliza el comando $env.

      Shell
      $env:GH_PAT="TOKEN"

  3. Usa el comando gh ado2gh grant-migrator-role, y reemplaza ORGANIZATION por la organización a la que quieras conceder el rol de migración, ACTOR por el nombre de usuario o equipo, y TYPE por USER o TEAM.

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

Concesión del rol de migración con la BBS2GH extension

  1. En GitHub.com, crea y registra una instancia de personal access token que cumpla todos los requisitos para conceder el rol de migración. Para obtener una lista completa de los requisitos, consulta "Administración del acceso para GitHub Enterprise Importer".

  2. Establece personal access token como una variable de entorno, y reemplaza TOKEN en los comandos siguientes por el valor personal access token que has registrado antes.

    • Si usas Terminal, utiliza el comando export.

      Shell
      export GH_PAT="TOKEN"

    • Si usas PowerShell, utiliza el comando $env.

      Shell
      $env:GH_PAT="TOKEN"

  3. Usa el comando gh bbs2gh grant-migrator-role, y reemplaza ORGANIZATION por la organización a la que quieras conceder el rol de migración, ACTOR por el nombre de usuario o equipo, y TYPE por USER o TEAM.

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

Concesión del rol de migración con la GEI extension

Nota: La datos GitHub CLI no admite la concesión del rol de migración para las organizaciones en GitHub Enterprise Server, por lo que debes ser propietario de la organización de origen para migrar repositorios desde GitHub Enterprise Server.

  1. En GitHub.com, crea y registra una instancia de personal access token que cumpla todos los requisitos para conceder el rol de migración. Para obtener una lista completa de los requisitos, consulta "Administración del acceso para GitHub Enterprise Importer".

  2. Establece personal access token como una variable de entorno, y reemplaza TOKEN en los comandos siguientes por el valor personal access token que has registrado antes.

    • Si usas Terminal, utiliza el comando export.

      Shell
      export GH_PAT="TOKEN"

    • Si usas PowerShell, utiliza el comando $env.

      Shell
      $env:GH_PAT="TOKEN"

  3. Usa el comando gh gei grant-migrator-role, y reemplaza ORGANIZATION por la organización a la que quieras conceder el rol de migración, ACTOR por el nombre de usuario o equipo, y TYPE por USER o TEAM.

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

Para ver instrucciones de uso de la GitHub CLI, usa el conmutador de herramientas en la parte superior de la página.

Concesión del rol de migración con GraphQL API

Puedes usar la mutación grantMigratorRole de GraphQL para asignar el rol de migración y la mutación revokeMigratorRole para revocarlo.

Debes usar una instancia de personal access token (PAT) que cumpla todos los requisitos de acceso. Para obtener más información, vea «Administración del acceso para GitHub Enterprise Importer».

Mutación grantMigratorRole

Esta mutación de GraphQL establece el rol de migración.

mutation grantMigratorRole (
  $organizationId: ID!,
  $actor: String!,
  $actor_type: ActorType!
) {
  grantMigratorRole( input: {
    organizationId: $organizationId,
    actor: $actor,
    actorType: $actor_type
  })
   { success }
}
Variable de consultaDescripción
organizationIdValor ownerId (o id. de organización) de la organización, de la consulta GetOrgInfo.
actorEquipo o nombre de usuario al que quieres asignar el rol de migración.
actor_typeEspecifica si el responsable de la migración es USER o TEAM.

Mutación revokeMigratorRole

Esta mutación elimina el rol de migración.

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