Migrating data to your enterprise

Applying the imported data on GitHub Enterprise Server

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

Filtros de estado de registro

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.

Completing the import on GitHub Enterprise Server

After your migration is applied to your target instance and you have reviewed the migration, you''ll unlock the repositories and delete them off the source. 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

Unlocking repositories from an organization on 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

Deleting repositories from an organization on 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 GitHub Enterprise Server

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