Nota:
Enterprise Live Migrations está en versión preliminar pública y está sujeto a cambios.
Si la migración encuentra un problema, compruebe el estado de la migración con elm migration status --migration-id MIGRATION-ID y revise la información de error.
Estados y acciones recomendadas
| Situación | Meaning | Acción recomendada |
|---|---|---|
| Created | La migración ha sido creada, pero aún no ha comenzado. | Ejecute elm migration start: |
| Queued | La migración está esperando a iniciarse | Wait |
| Exportación | Los datos se exportan desde el origen | Supervisión con elm migration status |
| En procesamiento | Los datos exportados se importan al destino | Supervisión con elm migration status |
| Listo para la transición | La migración inicial se ha completado y la migración está lista para la transición | Cuando esté listo, ejecute elm migration cutover-to-destination |
| Transición | El repositorio de origen está bloqueado y se aplican los cambios restantes al destino. | Monitor; el estado pasará a Completado. |
| Completed | La migración ha finalizado correctamente | Comprobación del repositorio de destino y reclamación de maniquíes |
| Fallido | La migración encontró un error irrecuperable | Investigar el error (consulte a continuación) |
| En pausa | La migración está en pausa | Reanudación de la migración |
| Terminado | Se canceló la migración. | N/A |
| Degradado | El destino no es accesible | Comprobación de la conectividad de red entre el dispositivo de GitHub Enterprise Server y GHE.com (consulte a continuación) |
El estado de la migración es "Fallido"
Una migración entra en el estado Error cuando un error irrecuperable impide que continúe. Esto es distinto de los recursos individuales que no se pueden importar; un fallo en la migración significa que la migración en sí misma no puede proceder.
Para investigar, ejecute elm migration status --migration-id MIGRATION-ID y revise los detalles del error en la respuesta. Cada error incluye un identificador de correlación con el formato (Correlation ID for Support: UUID). Si se comunica con Soporte de GitHub, proporcione este identificador para que el equipo de soporte técnico pueda investigar.
Después de resolver el problema subyacente, elm migration cancel --migration-id MIGRATION-ID anule la migración con errores y comience una nueva migración.
El estado de la migración es "Degradado"
Un estado Degradado significa que el servicio de migración del GitHub Enterprise Server dispositivo no puede llegar a la empresa de destino. La migración continúa en el lado de origen, pero el estado de destino es desconocido.
Compruebe la conectividad de red entre el dispositivo y el GitHub Enterprise Server subdominio de GHE.com, y ejecútelo de nuevo elm migration status --migration-id MIGRATION-ID. La respuesta de estado incluye una marca de tiempo para el último contacto exitoso con el destino, lo que puede ayudar a evaluar cuánto tiempo ha estado ocurriendo el problema de conectividad.
Algunos recursos no se pudieron importar
Los recursos individuales pueden no importarse sin provocar un error en la migración general. Puede ver un recuento de recursos fallidos en la salida de elm migration status --migration-id MIGRATION-ID.
Los recursos con errores solo se muestran después de que se hayan agotado todos los reintentos automáticos, por lo que los errores que vea se confirman como irresolubles sin intervención. Revise los detalles del error en la respuesta de estado: cada recurso fallido en relleno de datos o actualizaciones en tiempo real mostrará "state": "failed".
Si el número y los tipos de recursos con errores son aceptables, puede continuar con la transición. Si no es así, anule la migración, resuelva el problema subyacente y, a continuación, inicie una nueva migración.
El cambio falló y el repositorio de origen está bloqueado.
Si se produce un error durante la transición, el repositorio de origen puede permanecer bloqueado o archivado. Esto impide que los desarrolladores envíen al origen, mientras que el destino todavía podría estar incompleto.
Para desbloquear el repositorio de origen, un administrador de sitio debe desbloquearlo desde .GitHub Enterprise ServerConsola de administración
Una vez desbloqueado el origen, puede volver a intentar la fase de transición mediante elm migration cutover-to-destination --migration-id MIGRATION-ID, o interrumpir la migración con elm migration cancel --migration-id MIGRATION-ID e iniciar una nueva migración cuando esté listo.
La migración debe reiniciarse debido a un empuje forzado
Si alguien fuerza el push en la rama predeterminada del repositorio de origen mientras una migración está en curso, se rompe la sincronización de Git entre el origen y el destino. Las operaciones de "force push" reescriben el historial de commits de una manera que no se puede conciliar incrementalmente.
Si esto sucede, anule la migración con elm migration cancel --migration-id MIGRATION-ID e inicie una nueva migración. Antes de reiniciar, comunique al equipo que no se permiten envíos forzados a la rama predeterminada mientras una migración está activa.
Se rechazó el token de acceso
Si se produce un error de autenticación en la migración, compruebe lo siguiente:
- Los tokens de origen y de destino son personal access tokens (classic). No se admiten tokens específicos.
- Los tokens tienen los ámbitos especificados en Migración del repositorio con Enterprise Live Migrations.
- Si la organización de destino aplica el inicio de sesión único de SAML, el token debe estar habilitado para SSO.
Se rechazó la dirección URL de GHES de origen.
Enterprise Live Migrations requiere que la GitHub Enterprise Server dirección URL use HTTPS. Si la dirección URL está configurada con HTTP, se producirá un error en la validación previa de la migración.