Skip to main content

Acerca de ghe-migrator

Puedes usar ghe-migrator para transferir datos de una ubicación de origen (una organización de GitHub.com o una instancia de GitHub Enterprise Server) a una instancia de destino GitHub Enterprise Server.

Tipos de migraciones

Existen tres tipos de migraciones que se pueden realizar:

  • Una migración de una instancia de GitHub Enterprise Server a otra instancia de GitHub Enterprise Server existente. Puedes migrar la cantidad de repositorios que desees de cualquier usuario u organización en la instancia. Antes de hacer una migración, debes tener acceso de administrador del sitio en ambas instancias.
  • Una migración de una organización GitHub.com a una instancia GitHub Enterprise Server. Puedes migrar la cantidad de repositorios de la organización que desees. Antes de realizar una migración, debe tener acceso administrativo a la organización GitHub.com, así como acceso de administrador del sitio a la instancia de destino.
  • Las ejecuciones de prueba son migraciones que importan datos a una instancia de almacenamiento provisional. Pueden ser útiles para ver qué sucedería si se aplicara una migración a GitHub.com. Se recomienda encarecidamente realizar una ejecución de prueba en una instancia de almacenamiento provisional antes de importar datos a la instancia de producción.

Nota: El uso de ghe-migrator no se recomienda para transferir una instancia de GitHub Enterprise Server entre hipervisores. En su lugar, se recomienda realizar copias de seguridad y restaurar en la nueva ubicación con GitHub Enterprise Server Backup Utilities, o crear una réplica en la nueva ubicación y, a continuación, conmutar por error al dispositivo de réplica. Para obtener más información, consulta "Configuring backups on your instance", "Creating a high availability replica" y "Iniciar una tolerancia de fallos a tu aparato de réplica".

Datos migrados

Con ghe-migrator, todo gira en torno a un repositorio. La mayoría de los datos asociados con un repositorio se pueden migrar. Por ejemplo, un repositorio dentro de una organización migrará el repositorio y la organización, así como los usuarios, equipos, incidencias y solicitudes de incorporación de cambios asociados con el repositorio.

Los elementos de la tabla a continuación se pueden migrar con un repositorio. No se pueden migrar los elementos que no se muestren en la lista de datos migrados, incluyendo los activos de Git LFS.

Nota: Las relaciones de bifurcación no se conservan después de una migración.

Datos asociados con un repositorio migradoNotas
Usuarios@mentions de los usuarios se vuelven a escribir para que coincidan con el destino.
Las organizacionesEl nombre y los datos de una organización se migran.
RepositoriosLos enlaces a árboles Git, blobs, confirmaciones de cambios y líneas se reescriben para coincidir con el objetivo. El migrador sigue un máximo de tres redirecciones de repositorio. Los repositorios internos se migran como repositorios privados. El estado de archivo se anula.
WikisTodos los datos de la wiki se migran.
Teams@mentions de los equipos se vuelven a escribir para que coincidan con el destino.
HitosLos registros horarios se conservan.
Tableros de proyectoLos tableros de proyectos asociados con el repositorio y con la organización que posee el repositorio se migran.
IssuesLas referencias de propuestas y los registros horarios se conservan.
Comentarios de propuestasLas referencias cruzadas a los comentarios se reescriben para la instancia de destino.
Solicitudes de incorporación de cambiosLas referencias cruzadas a las solicitudes de extracción se reescriben para coincidir con el objetivo. Los registros horarios se conservan.
Revisiones de solicitudes de extracciónLas revisiones de solicitudes de extracción y los datos asociados se migran.
Comentarios sobre revisiones de solicitudes de extracciónLas referencias cruzadas a los comentarios se reescriben para la instancia de destino. Los registros horarios se conservan. Los comentarios de nivel de archivo no se migran.
Comentarios sobre confirmación de cambiosLas referencias cruzadas a los comentarios se reescriben para la instancia de destino. Los registros horarios se conservan.
VersionesTodos los datos de las versiones se migran.
Medidas adoptadas en las solicitudes de extracción o propuestasTodas las modificaciones a las solicitudes de extracción o propuestas, como la asignación de usuarios, el cambio de nombre de título y la modificación de etiquetas se conservan, junto con los registros horarios de cada acción.
Archivos adjuntosSe migran los datos adjuntos de archivos en incidencias y solicitudes de incorporación de cambios. Puedes elegir inhabilitar esta opción como parte de la migración.
webhooksSolo se migran los webhooks activos.
Llaves de implementación de repositoriosLas llaves de implementación de repositorios se migran.
Ramas protegidasLa configuración de las ramas protegidas y los datos asociados se migran.