Preparar la instancia origen de GitHub Enterprise Server
-
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.
-
Generación de un token de acceso con los ámbitos
repo
yadmin:org
en la instancia de origen GitHub Enterprise Server. -
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
Note
El bloqueo de un repositorio impide todo acceso de escritura a este. 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».
-
SSH en tu instancia de GitHub Enterprise Server 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
ssh -p 122 admin@HOSTNAME
-
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
-
-
Cuando se te indique, ingresa tu nombre de usuario GitHub Enterprise Server:
Enter username authorized for migration: admin
-
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: **************
-
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 pasosghe-migrator add
yghe-migrator export
posteriores para indicar aghe-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. -
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
-
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
.
- Para especificar dónde se deben almacenar provisionalmente los archivos de migración, anexe
-
Cierra la conexión a tu instancia de GitHub Enterprise Server:
$ exit > logout > Connection to HOSTNAME closed.
-
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
-
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".