Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. 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 GitHub Enterprise Server. Podrás revisar los cambios para detectar posibles conflictos antes de aplicar de manera permanente los cambios a tu instancia de destino.

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.

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

    $ 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. 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 registroNombre del filtro
Usuariosusuario
Organizacionesorganization
Repositoriosrepositorio
Equiposequipo
Hitoshito
Tableros de proyectoproject
Problemaspropuesta
Comentarios de propuestascomentario_propuesta
Solicitudes de cambiossolicitud_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á.
mapEl 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 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

  1. 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
  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 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

  1. 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
  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