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 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 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 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:
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 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. 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 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 su migración es un producto GitHub que utiliza autenticación LDAP o SAML, ghe-migrator no migra los datos de autenticación externa vinculados a las cuentas de usuario. Para obtener más información sobre las opciones de autenticación, consulta GitHub Enterprise Server, consulta "Acerca de la autenticación para su empresa" en la documentación GitHub Enterprise Server o en la documentación GitHub Enterprise Cloud.
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 utiliza una instancia para asignar los nombres de las cuentas de usuario desde Consola de administración. Para más información, consulta Acceso a la Consola de administración.