Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Esta versión de GitHub Enterprise se discontinuó el 2020-11-12. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Migrar datos a tu empresa

Después de generar un archivo de migración, puedes importar los datos a tu instancia de destino del Servidor de GitHub Enterprise. Podrás revisar los cambios para detectar posibles conflictos antes de aplicar de manera permanente los cambios a tu instancia de destino.

En este artículo

Aplicar los datos importados en Servidor de GitHub Enterprise

  1. Como administrador de sitio, Entra por SSH en tu instancia destino de Servidor de GitHub Enterprise.

    $ ssh -p 122 admin@HOSTNAME
  2. Con el comando ghe-migrator import, inicia el proceso de importación. Necesitarás:

    • Tu GUID de migración.
    • 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 registroNombre del filtro
Usuariosusuario
Organizacionesorganización
Repositoriosrepositorio
Equiposequipo
Hitoshito
Tableros de proyectoproject
Problemaspropuesta
Comentarios de propuestascomentario_propuesta
Solicitudes de extracciónsolicitud_extracción
Revisiones de solicitudes de extracciónrevisión_solicitud de extracción
Comentarios sobre confirmación de cambioscomentario_confirmación de cambios
Comentarios sobre revisiones de solicitudes de extraccióncomentarios _revisiones_solicitudes de extracción
Lanzamientoslanzamiento
Medidas adoptadas en las solicitudes de extracción o propuestasevento_propuesta
Ramas protegidasrama_protegida

Filtros de estado de registro

Estado de registroDescripción
exportarEl registro se exportará.
importarEl registro se importará.
asignarEl registro se asignará.
rename (renombrar)El registro se renombrará.
fusionarEl registro se fusionará.
exportadoEl registro se exportó con éxito.
importadoEl registro se importó con éxito.
asignadoEl registro se asignó con éxito.
renombradoEl registro se renombró con éxito.
fusionadoEl registro se fusionó con éxito.
exportación_fallidaEl registro no se pudo exportar.
importación_fallidaEl registro no se pudo importar.
asignación_fallidaEl registro no se pudo asignar.
renombrar_fallidoEl registro no se pudo renombrar.
fusión_fallidaEl 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 Servidor de GitHub Enterprise

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

  1. SSH en tu instancia de servidor de GitHub Enterprise.
    $ ssh -p 122 admin@HOSTNAME
  2. 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 la organización de GitHub.com, debes borrar todos los repositorios que migraste anteriormente 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 Servidor de GitHub Enterprise

  1. SSH en tu instancia de servidor de GitHub Enterprise.
    $ ssh -p 122 admin@HOSTNAME
  2. 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