Preparing the GitHub Enterprise Server source instance
-
Verifica que eres un administrador del sitio en el origen GitHub Enterprise Server. La mejor manera de hacerlo es verificar que puedes usar SSH en la instancia.
-
Genera un acceso de token con los alcances
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.
Exporting the GitHub Enterprise Server source repositories
Nota:Cerrar un repositorio previene que los usuarios suban información al mismo o que modifiquen sus recursos como informes de problemas, etiquetas, hitos, wikis, y comentarios. Los nuevos equipos y colaboradores no podrán asociarse con un repositorio cerrado.
Si estás realizando una ejecución de prueba, no necesitas cerrar el repositorio. En el resto de los casos, se recomienda ampliamente. Para obtener más información, consulta "Acerca de las migraciones".
-
SSH en tu instancia de servidor de GitHub Enterprise.
$ ssh -p 122 admin@HOSTNAME
-
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
- Si estás bloqueando el repositorio, agrega el comando
-
Cuando se te indique, ingresa tu nombre de usuario GitHub Enterprise Server:
Ingresa el nombre de usuario autorizado para la migración: admin
-
Cuando se te pida un token de acceso personal, ingresa el token de acceso que creaste en"Preparación de GitHub Enterprise Server la instancia de origen":
Ingresa el token de acceso personal: **************
-
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 posterioresghe-migrator add
yghe-migrator export
para indicar aghe-migrator
que continúe operando 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 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. -
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
-
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
-
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
- 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
.
- Para especificar en donde se deben escalar los archivos de migración de acuerdo con la etapa, anexa el comando con
-
Cierra la conexión a tu instancia de servidor de GitHub Enterprise:
$ exit > logout > Connection to hostname closed.
-
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
-
Para importar los datos de migración archivados a una instancia de GitHub Enterprise Server , consulta "Importando datos de migración a GitHub Enterprise Server".