Exportación de datos de migración desde GitHub Enterprise Server

Preparación de la instancia de GitHub Enterprise Server origen

1. Compruebe que es administrador de sitio en el GitHub Enterprise Server origen. La mejor manera de hacerlo es comprobar que puedes conectarte mediante SSH a la instancia.

2. Generación de un token de acceso con los ámbitos repo y admin:org en la instancia de origen GitHub Enterprise Server .

3. Para minimizar los tiempos de inactividad, haz una lista de repositorios que deseas exportar desde la instancia de origen. Puedes agregar múltiples repositorios a una exportación a la vez usando un archivo de texto que muestra la URL de cada repositorio en una línea separada.

Exportación de los GitHub Enterprise Server repositorios de origen

1. SSH en GitHub.com. Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Reemplace HOSTNAME por el nombre de host de la instancia, o el nombre de host o la dirección IP de un nodo. Para más información, consulta Acceder al shell administrativo (SSH).

   Shell

   ssh -p 122 admin@HOSTNAME
   

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

   • Si estás bloqueando el repositorio, anexa el comando con --lock. Si vas a realizar una prueba de funcionamiento, --lock no es necesaria.

     ghe-migrator add https://HOSTNAME/USERNAME/REPO-NAME --lock
     

   • Puedes excluir los datos adjuntos de archivo anexando --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 a la vez para la exportación, crea un archivo de texto que muestre cada dirección URL del repositorio en una línea y ejecuta el comando ghe-migrator add con la marca -i y la ruta de acceso al archivo de texto.

     ghe-migrator add -i PATH/TO/YOUR/REPOSITORY_URL.txt
     

3. Cuando se le solicite, escriba el GitHub Enterprise Server nombre de usuario:

   Enter username authorized for migration:  admin
   

4. Cuando se le solicite un personal access token, escriba el token de acceso que creó en Preparación de la GitHub Enterprise Server instancia de origen:

   Enter personal access token:  **************
   

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

   > 101 models added to export
   > Migration GUID: EXAMPLE-MIGRATION-GUID
   > Number of records in this migration:
   > users                        |  5
   > organizations                |  1
   > repositories                 |  1
   > teams                        |  3
   > protected_branches           |  1
   > pull_request_reviews         |  1
   > milestones                   |  1
   > issues                       |  3
   > pull_requests                |  5
   > pull_request_review_comments |  4
   > commit_comments              |  2
   > issue_comments               | 10
   > issue_events                 | 63
   > releases                     |  3
   > attachments                  |  4
   > projects                     |  2
   

   Cada vez que agregues un repositorio nuevo con un GUID de migración existente, se actualizará la exportación existente. Si vuelves a ejecutar ghe-migrator add sin un GUID de migración, se iniciará una nueva exportación y se 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 la importación.

6. Para agregar más repositorios a la misma exportación, usa el comando ghe-migrator add con la marca -g. Pasarás la nueva URL del repositorio y el GUID de migración del Paso 5:

   ghe-migrator add https://HOSTNAME/USERNAME/OTHER-REPO-NAME -g MIGRATION-GUID --lock
   

7. Cuando hayas terminado de agregar repositorios, genera el archivo de migración mediante el comando ghe-migrator export con la marca -g y el GUID de migración del paso 5:

   $ ghe-migrator export -g MIGRATION-GUID
   > Archive saved to: /data/github/current/tmp/MIGRATION-GUID.tar.gz
   

   • Para especificar dónde se deben almacenar provisionalmente los archivos de migración, anexe --staging-path=/full/staging/path al comando. Tiene como valor predeterminado /data/user/tmp.

8. Cierre la conexión a GitHub.com:

   $ exit
   > logout
   > Connection to HOSTNAME closed.
   

9. Copia el archivo de migración en el equipo mediante el comando scp. El archivo se nombrará con el GUID de migración.

   scp -P 122 admin@HOSTNAME:/data/github/current/tmp/MIGRATION-GUID.tar.gz ~/Desktop
   

10. A fin de preparar los datos de migración archivados para la importación en una instancia de GitHub Enterprise Server, consulta Migración de datos a GitHub Enterprise Server.