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"
- Si usas Terminal, utiliza el comando
-
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 porUSER
oTEAM
.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"
- Si usas Terminal, utiliza el comando
-
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 porUSER
oTEAM
.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"
- Si usas Terminal, utiliza el comando
-
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 porUSER
oTEAM
.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 }
}