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

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

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".
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"
```
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

Nota: Las migraciones desde Bitbucket Server con GitHub Enterprise Importer se encuentran actualmente en versión beta privada y están sujetas a cambios. Para solicitar acceso a la versión beta, consulte Unirse a la lista de espera de migraciones de Bitbucket Server.

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".
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"
```
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.

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".
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"
```
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 consulta	Descripción
`organizationId`	Valor `ownerId` (o id. de organización) de la organización, de la consulta `GetOrgInfo`.
`actor`	Equipo o nombre de usuario al que quieres asignar el rol de migración.
`actor_type`	Especifica 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 }
}