Nota:
Enterprise Live Migrations está en versión preliminar pública y está sujeto a cambios.
¿Nuestra GitHub Enterprise Server instancia está lista?
ELM está disponible en las versiones de revisión más recientes para GitHub Enterprise Server la versión 3.17 y posteriores. Esta documentación asume que está usando la siguiente versión de parche o una posterior. Es posible que las instrucciones no funcionen en versiones anteriores.
3.21.23.20.43.19.83.18.113.17.17
La GitHub Enterprise Server instancia también debe:
- Use una dirección URL HTTPS . No se admiten direcciones URL HTTP.
- Permitir el tráfico saliente hacia el destino de la migración.
- Tener habilitadas las migraciones en la sección "Migraciones" de management Console.
- Prepárese para cierta carga adicional durante la migración: el archivado del repositorio hace que todos los problemas y las solicitudes de incorporación de cambios del repositorio se extraigan de MySQL y se vuelvan a indexar en Elasticsearch.
¿Cómo será nuestra organización de destino?
Puede migrar repositorios a una organización nueva o existente en GHE.com. ELM crea la organización de destino si aún no existe.
Una migración de plataforma es una buena oportunidad para reconsiderar la organización y la estructura del equipo. Consulte Procedimientos recomendados para organizar el trabajo en su empresa.
¿Qué repositorios migraremos?
ELM admite hasta 10 migraciones simultáneas de repositorio desde una sola GitHub Enterprise Server instancia y 20 migraciones simultáneas por empresa de destino.
Planifique qué repositorios migrará primero con ELM y cuáles podrá migrar más adelante o utilizando una herramienta de migración diferente. Los repositorios que más probablemente se beneficiarán de ELM son:
- Repositorios importantes en los que largos períodos de tiempo de inactividad interrumpirían su negocio
- Monorepos de gran tamaño que son demasiado grandes para otras herramientas de migración
Los repositorios públicos no están disponibles en GHE.comy estos serán rechazados por ELM. Puede cambiar la visibilidad de estos repositorios en GitHub Enterprise Server antes de empezar.
Debe comprobar que los repositorios que elija no contengan activos de versión superiores a 2 GB, ya que este es el límite de ELM.
¿Quién ejecutará la migración?
La persona que ejecuta una ELM migración debe:
- Tener acceso de administrador de sitio a la GitHub Enterprise Server instancia
- Ser propietario de empresa en la empresa GHE.com
Esta persona deberá realizar las siguientes tareas:
- Antes de la migración, cree personal access tokens (classic) en la empresa de origen y destino.
- Durante la migración, supervise el estado de la migración y responda a problemas.
Para migraciones simultáneas ELM desde una GitHub Enterprise Server instancia, la misma persona debe ejecutar todos los elm comandos, con los mismos tokens.
Después de la migración, alguien tendrá que realizar algunas tareas de seguimiento en GHE.com. Cualquier propietario de la organización puede hacerlo.
¿Qué deben saber mis desarrolladores?
Antes de empezar, comunique con los desarrolladores lo siguiente:
- El repositorio se mueve a una nueva ubicación. Los usuarios pueden seguir usando el repositorio de origen durante la migración hasta que el operador comience la transición final a la nueva ubicación. Después de la migración, el repositorio de origen se archivará, por lo que será de solo lectura a menos que un administrador de repositorio lo desarchive.
- Aunque la migración está en curso, los desarrolladores deben evitar empujes forzados en el repositorio, ya que estos interrumpirán el historial de Git de una manera que ELM no pueda resolver.
- Es posible que algunas acciones que realicen los desarrolladores durante el proceso de migración no se reflejen en el repositorio migrado. Para obtener más información, consulte las acciones no admitidas en Datos migrados para migraciones en vivo de GitHub Enterprise Server a GHE.com.
Pasos siguientes
Cuando esté listo para ejecutar una migración, consulte Migración del repositorio con Enterprise Live Migrations.