Aplicar los datos importados en GitHub Enterprise Server
Una vez que hayas preparado tu migración, puedes utilizar los siguientes pasos para completar la migración.
-
Como administrador de sitio, Entra por SSH en tu instancia destino de GitHub Enterprise Server.
$ ssh -p 122 admin@HOSTNAME
-
Con el comando
ghe-migrator import
, inicia el proceso de importación. Necesitarás:- Tu GUID de migración. Para obtener más información, consulta la sección "Cómo prepararte para migrar datos a tu empresa".
- Tu token de acceso personal para autenticación. El token de acceso personal que utilices es solo para autenticación como administrador de sitio, y no requiere ningún alcance específico. Para obtener más información, consulta la sección "Crear un token de acceso personal".
$ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN > Comenzando con GitHub::Migrador > Importación 100 % completa /
- Para especificar en donde se deben escalar los archivos de migración de acuerdo con la etapa, anexa el comando con
--staging-path=/full/staging/path
. La ruta predeterminada es/data/user/tmp
.
Revisar datos de migración
De forma predeterminada, ghe-migrator audit
devuelve todos los registros. También te permite filtrar los registros por:
- Los tipos de registros.
- El estado de los registros.
Los tipos de registro coinciden con los encontrados en los datos migrados.
Filtros de tipo de registro
Tipo de registro | Nombre del filtro |
---|---|
Usuarios | usuario |
Organizaciones | organization |
Repositorios | repositorio |
Equipos | equipo |
Hitos | hito |
Tableros de proyecto | project |
Problemas | propuesta |
Comentarios de propuestas | comentario_propuesta |
Solicitudes de cambios | solicitud_extracción |
Revisiones de solicitudes de extracción | revisión_solicitud de extracción |
Comentarios sobre confirmación de cambios | comentario_confirmación de cambios |
Comentarios sobre revisiones de solicitudes de extracción | comentarios _revisiones_solicitudes de extracción |
Lanzamientos | lanzamiento |
Medidas adoptadas en las solicitudes de extracción o propuestas | evento_propuesta |
Ramas protegidas | rama_protegida |
Filtros de estado de registro
Estado de registro | Descripción |
---|---|
exportar | El registro se exportará. |
importar | El registro se importará. |
map | El registro se asignará. |
rename (renombrar) | El registro se renombrará. |
fusionar | El registro se fusionará. |
exportado | El registro se exportó con éxito. |
importado | El registro se importó con éxito. |
asignado | El registro se asignó con éxito. |
renombrado | El registro se renombró con éxito. |
fusionado | El registro se fusionó con éxito. |
exportación_fallida | El registro no se pudo exportar. |
importación_fallida | El registro no se pudo importar. |
asignación_fallida | El registro no se pudo asignar. |
renombrar_fallido | El registro no se pudo renombrar. |
fusión_fallida | El registro no se pudo fusionar. |
Filtrar registros auditados
Con el comando de auditoría ghe-migrator audit
puedes filtrar en función del tipo de registro mediante el indicador -m
. Del mismo modo, puedes filtrar en el estado de importación mediante el indicador -s
. El comando se ve de la siguiente manera:
$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID
Por ejemplo, para ver cada organización y equipo importados con éxito, debes ingresar:
$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID
> model_name,source_url,target_url,state
> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed
Te recomendamos encarecidamente que hagas una auditoría de todas las importaciones que fallaron. Para ello, ingresa en:
$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID
> model_name,source_url,target_url,state
> user,https://gh.source/octocat,https://gh.target/octocat,failed
> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed
Si tienes alguna duda sobre las importaciones fallidas, comunícate con GitHub Enterprise Support](https://enterprise.githubsupport.com/hc/en-us) o GitHub Premium Support.
Completar la importación en GitHub Enterprise Server
Después de que se aplique tu migración a tu instancia destino y la hayas revisado, desbloquearás los repositorios y los borrarás del origen. Antes de eliminar los datos de origen, se recomienda esperar alrededor de dos semanas para asegurarse de que todo funciona de acuerdo con lo esperado.
Desbloquear repositorios en la instancia de destino
- SSH en tu instancia de GitHub Enterprise Server. Para obtener más información, consulta "Acceder al shell administrativo (SSH)."
$ ssh -p 122 admin@HOSTNAME
- Libera todos los repositorios importados con el comando
ghe-migrator unlock
. Nececitarás tu GUID de Migración:$ ghe-migrator unlock -g MIGRATION_GUID > Unlocked octo-org/octo-project
Desbloquear repositorios en el origen
Desbloquear los repositorios de una organización en GitHub.com
Para desbloquear los repositorios en una organizaciónGitHub.com, debes enviar una solicitud de DELETE
al punto final de desbloqueo de migración. Necesitarás:
- Tu token de acceso para autenticación
- El
id
único de la migración - El nombre del repositorio a desbloquear
curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ -H "Accept: application/vnd.github.wyandotte-preview+json" \ https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock
Borrar los repositorios de una organización en GitHub.com
Después de desbloquear los repositorios de organización de GitHub.com deberás borrar todos los repositorios que migraste previamente utilizando la terminal de borrado de repositorios. Necesitarás tu token de acceso para la autenticación:
curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \
https://api.github.com/repos/orgname/repo_name
Desbloquear repositorios desde una instancia de GitHub Enterprise Server
- SSH en tu instancia de GitHub Enterprise Server. Para obtener más información, consulta "Acceder al shell administrativo (SSH)."
$ ssh -p 122 admin@HOSTNAME
- Libera todos los repositorios importados con el comando
ghe-migrator unlock
. Nececitarás tu GUID de Migración:$ ghe-migrator unlock -g MIGRATION_GUID > Unlocked octo-org/octo-project