Skip to main content

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

Para cambiar las plataformas o migrarse de una instancia de pruebas a una productiva, puedes exportar los datos de migración de una instancia de GitHub Enterprise Server si preparas la instancia, bloqueas los repositorios, y generas un archivo de migración.

Preparar la instancia origen de GitHub Enterprise Server

  1. Verifica que eres un administrador del sitio en el origen GitHub Enterprise Server. 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.

Exportar los repositorios origen de GitHub Enterprise Server

Nota: El bloqueo de un repositorio impedirá todos los accesos de escritura al mismo. No puedes asociar equipos o colaboradores nuevos con un repositorio bloqueado.

Si estás llevando a cabo una ejecución de prueba, no necesitas bloquear el repositorio. Al migrar datos de un repositorio que está en uso, GitHub recomienda encarecidamente bloquear el repositorio. Para obtener más información, vea «Acerca de ghe-migrator».

  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 obtener más información, vea «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 ejecución de prueba, --lock no es necesario.

      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 te indique, ingresa tu nombre de usuario GitHub Enterprise Server:

    Enter username authorized for migration:  admin
    
  4. Cuando se te solicite un personal access token, escriba el token de acceso que creaste en "Preparar la instancia de origen de GitHub Enterprise Server":

    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 generado en los pasos ghe-migrator add y ghe-migrator export posteriores para indicar a ghe-migrator que siga funcionando en la misma exportación.

    > 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. Cierra 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. 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
    
  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".