Exportar los repositorios de origen de GitHub Enterprise Server

1. SSH into tu instancia de servidor de GitHub Enterprise.

   $ ssh -p 122 admin@HOSTNAME

2. Para preparar un repositorio para la exportación, usa el comando ghe-migrator add con la URL del repositorio:

   • Si estás bloqueando el repositorio, agrega el comando --lock. Si estás efectuando una ejecución de prueba, el comando --lock no es necesario.

     $ ghe-migrator add https://hostname/username/reponame --lock

   • Puedes excluir archivos adjuntos agregando --exclude_attachments al comando. Los archivos adjuntos pueden resultar muy grandes y es posible que sobrecarguen tu archivo de migración final de manera innecesaria.

   • Para preparar varios repositorios al mismo tiempo para exportación, crea un archivo de texto que incluya las URL del repositorio en una línea separada, y ejecuta el comando ghe-migrator add con el indicador -i y la ruta a tu archivo de texto.

     $ ghe-migrator add -i PATH/TO/YOUR/REPOSITORY_URLS.txt

3. Cuando se te indique, ingresa tu nombre de usuario Servidor de GitHub Enterprise:

   Ingresa el nombre de usuario autorizado para la migración: admin

4. Cuando se te pida un token de acceso personal, ingresa el token de acceso que creaste en"Preparación de Servidor de GitHub Enterprise la instancia de origen":

   Ingresa el token de acceso personal:  **************

5. Cuando ghe-migrator add haya terminado, imprimirá el "GUID de migración" único que generó para identificar esta exportación, así como una lista de los recursos que se agregaron a la exportación. Utilizarás el GUID de migración que generaste en los pasos posteriores ghe-migrator add yghe-migrator export para indicar a ghe-migrator que continúe operando en la misma exportación.

   > 101 modelos agregados para exportar
   > GUID de migración: example-migration-guid
   > Número de registros en esta migración:
   > usuarios                        |  5
   > organizaciones                |  1
   > repositorios                 |  1
   > equipos                        |  3
   > ramas_protegidas           |  1
   > revisiones_solicitudes_extracción         |  1
   > hitos                   |  1
   > propuestas                       |  3
   > solicitudes_extracción                |  5
   > comentarios_revisión_solicitudes_extracción |  4
   > comentarios_confirmación de cambios              |  2
   > comentarios_propuestas              | 10
   > eventos_propuestas                 | 63
   > lanzamientos                     |  3
   > adjuntos                  |  4
   > proyectos                     |  2

   Cada vez que agregues un repositorio nuevo con un GUID de migración existente, se actualizará la exportación existente. Si ejecutas ghe-migrator add nuevamente sin un GUID de migración, comenzará una nueva exportación y generará un nuevo GUID de migración. No vuelvas a utilizar el GUID de migración generado durante una exportación cuando comiences a preparar tu migración para importar.

6. Si bloqueaste el repositorio de origen, puedes usar el comando ghe-migrator target_url para configurar un mensaje de bloqueo personalizado en la página del repositorio que vincula con la nueva ubicación del repositorio. Pasa la URL del repositorio de origen, la URL del repositorio de destino y el GUID de migración del Paso 5:

   $ ghe-migrator target_url https://hostname/username/reponame https://target_hostname/target_username/target_reponame -g MIGRATION_GUID

7. Usa el comando ghe-migrator add con el indicador -g para agregar más repositorios a la misma exportación. Pasarás la nueva URL del repositorio y el GUID de migración del Paso 5:

   $ ghe-migrator add https://hostname/username/other_reponame -g MIGRATION_GUID --lock

8. Cuando hayas terminado de agregar repositorios, genera el archivo de migración con el comando ghe-migrator export con el indicador -g y el GUID de migración del Paso 5:

   $ ghe-migrator export -g MIGRATION_GUID
   > Archivo guardado en: /data/github/current/tmp/MIGRATION_GUID.tar.gz

   • To specify where migration files should be staged append the command with --staging-path=/full/staging/path. Defaults to /data/user/tmp.

9. Cierra la conexión a tu instancia de servidor de GitHub Enterprise:

   $ exit
   > logout
   > Conexión a hostname cerrada.

10. Copia el archivo de migración a tu computadora con el comando scp. Se te asignará al archivo de almacenamiento un nombre con el GUID de migración:

    $ scp -P 122 admin@hostname:/data/github/current/tmp/MIGRATION_GUID.tar.gz ~/Desktop

11. Para importar los datos de migración archivados a una instancia de Servidor de GitHub Enterprise , consulta "Importando datos de migración a Servidor de GitHub Enterprise".