Tipos de migraciones
Existen tres tipos de migraciones que se pueden realizar:
- Una migración de una GitHub Enterprise Server instancia a otra existente GitHub Enterprise Server . Puedes migrar cualquier número de repositorios 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 GitHub.com organización, así como acceso de administrador de sitio a la instancia de destino.
- Las ejecuciones de prueba son migraciones que importan datos a una instancia de almacenamiento provisional. Estos pueden ser útiles para ver lo que sucedería si se aplicara una migración a tu instancia de GitHub Enterprise Server. 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:
No se recomienda el uso de ghe-migrator para transferir una GitHub Enterprise Server instancia entre hipervisores. En su lugar, sugerimos bien hacer una copia de seguridad y restaurarla en la nueva ubicación con GitHub Enterprise Server Backup Utilities, o bien crear una réplica en la nueva ubicación y, a continuación, realizar una conmutación por error al dispositivo de réplica. Para más información, consulta Configuración de copias de seguridad en la instancia mediante utilidades de copia de seguridad, Crear una réplica de alta disponibilidad 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. Los elementos que no se muestran en la lista de datos migrados no se pueden migrar, incluidos Git LFS los recursos.
Nota:
Las relaciones de bifurcación no se conservan después de una migración.
| Datos asociados con un repositorio migrado | Notas |
|---|---|
| Usuarios | |
| ** | |
| @mentions | |
| ** de los usuarios se vuelven a escribir para que coincidan con el destino. | |
| Las organizaciones | El nombre y los datos de una organización se migran. |
| Repositorios | Los enlaces a árboles Git, blobs, confirmaciones de cambios y líneas se reescriben para coincidir con el objetivo. Los repositorios internos se migran como repositorios privados. El estado de archivo no está establecido. |
| Wikis | Todos los datos de la wiki se migran. |
| Teams | |
| ** | |
| @mentions | |
| ** de los equipos se vuelven a escribir para que coincidan con el destino. | |
| Hitos | Las marcas de tiempo se conservan. |
| Problemas | Las referencias de incidencias y las marcas de tiempo se conservan. |
| Comentarios de propuestas | Las referencias cruzadas a los comentarios se reescriben para la instancia de destino. |
| Solicitudes de incorporación de cambios | Las referencias cruzadas a las solicitudes de extracción se reescriben para coincidir con el objetivo. Las marcas de tiempo se conservan. |
| Revisiones de solicitudes de extracción | Las revisiones de solicitudes de extracción y los datos asociados se migran. |
| Comentarios sobre revisiones de solicitudes de extracción | Las referencias cruzadas a los comentarios se reescriben para la instancia de destino. Las marcas de tiempo se conservan. Los comentarios de nivel de archivo no se migran. |
| Comentarios sobre confirmación de cambios | Las referencias cruzadas a los comentarios se reescriben para la instancia de destino. Las marcas de tiempo se conservan. |
| Lanzamientos | Todos los datos de las versiones han sido migrados. |
| Medidas adoptadas en las solicitudes de extracción o propuestas | Todas 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 adjuntos | Se 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. |
| webhooks | Solo se migran los webhooks activos. |
| Llaves de implementación de repositorios | Las claves de implementación de los repositorios han sido migradas. |
| Ramas protegidas | La configuración de las ramas protegidas y los datos asociados se migran. |
Acerca de la migración de datos de autenticación externa
Si la ubicación de origen de la migración es un GitHub producto que usa la autenticación LDAP o SAML, ghe-migrator no migra los datos de autenticación externos vinculados a las cuentas de usuario. Para obtener más información sobre las opciones de autenticación, vea GitHub Enterprise Server, vea "Acerca de la autenticación para su empresa" en los GitHub Enterprise Server documentos o en los GitHub Enterprise Cloud documentos.
Si migra a una instancia de destino y, a continuación, configura la autenticación externa, los usuarios deben iniciar sesión en la instancia de destino con una cuenta de usuario que tenga el mismo nombre de usuario o identificador de usuario que la cuenta en la instancia de origen. Los administradores pueden revisar el atributo externo que una instancia utiliza para asignar nombres de las cuentas de usuario del Consola de administración. Para más información, consulta Acceso a la Consola de administración.