1. Más información sobre enterprise Live Migrations

servicios de Azure DevOps

Enterprise Live Migrations (ELM) le ayuda a migrar los repositorios de Azure DevOps a GitHub Enterprise Cloud con residencia de datos con una interrupción mínima. ELM sincroniza continuamente los repositorios de origen y de destino, por lo que los equipos pueden seguir trabajando en Azure DevOps Services hasta que esté listo para realizar la transición. Hay dos rutas de migración: cortar completamente a GitHub o usar un modelo híbrido en el que el código fuente se mueve a GitHub mientras los equipos siguen usando Azure Boards y Azure Pipelines.

Note

ELM está actualmente en versión preliminar.

ELM está disponible en dos experiencias: la CLI de Azure DevOps y el portal de Azure DevOps. Use la CLI cuando quiera crear scripts o ejecutar migraciones desde la línea de comandos. Use el portal cuando desee una experiencia guiada para seleccionar repositorios, iniciar migraciones y realizar un seguimiento del progreso.

Note

La compatibilidad con ELM en la Azure DevOps servidor MCP remoto está actualmente en versión preliminar y está habilitada de forma predeterminada. El servidor MCP remoto expone las herramientas de ELM que permiten automatizar las migraciones de repositorios de Azure DevOps a GitHub Enterprise Cloud, incluida la creación de agentes personalizados y aptitudes para las tareas de migración del repositorio. Para conocer los nombres de las herramientas, los requisitos previos y los detalles de configuración, consulte la documentación de Azure DevOps servidor MCP remoto.

Importante

ELM solo admite migraciones de Azure DevOps Services a GitHub Enterprise Cloud con residencia de datos. Si actualmente usa Azure DevOps Server, primero migre a Azure DevOps Services antes de usar ELM.

Capacidades principales

ELM proporciona las siguientes funcionalidades principales:

  • Sincronización continua: ELM sincroniza los cambios de Azure DevOps a GitHub mediante la sincronización incremental y el seguimiento delta, por lo que los equipos pueden seguir trabajando en Azure DevOps hasta la migración. Prevea una breve ventana de solo lectura durante la transición, por lo general de menos de 30 minutos para la mayoría de los repositorios.
  • Migraciones de varios repositorios: ELM admite la migración de hasta 30 repositorios, con hasta 20 repositorios en la fase de sincronización inicial y 10 repositorios adicionales en la fase de sincronización incremental. En la CLI, ejecute el comando de migración para cada repositorio de uno en uno. En la interfaz de usuario, puede seleccionar hasta 20 repositorios inicialmente. Una vez completada la sincronización inicial para esos repositorios, puede iniciar migraciones para hasta 10 repositorios adicionales.
  • Flujo de trabajo de migración de un extremo a otro: ELM realiza un seguimiento de los estados del repositorio a través de la inicialización, sincronización, migración, validación y finalización. Este modelo proporciona visibilidad sobre el progreso de la migración y admite la solución de problemas.
  • Transición programada por el cliente: Elija y programe el tiempo de transición para cambiar el sistema de registro de Azure DevOps a GitHub.
  • Configuración posterior a la migración simplificada: ELM ayuda a reducir el trabajo manual después del cambio al configurar la conexión de Azure Boards y volver a configurar Azure Pipelines para que apunte al repositorio de GitHub migrado. Esto facilita que los equipos sigan usando Azure DevOps para la planificación y las canalizaciones mientras trabajan con GitHub para el código fuente, con menos fricciones en los traspasos y menos tareas posteriores.

Flujo de datos de migración

ELM transfiere los datos del repositorio del origen a GitHub Enterprise Cloud a través de canales cifrados. Migra el contenido, el historial, los metadatos y los permisos del repositorio y, a continuación, usa la sincronización incremental para copiar solo los cambios después de la transferencia inicial. ELM no almacena el contenido del repositorio de clientes fuera del proceso de migración.

Seguridad y control de datos

ELM está diseñado para que el contenido del repositorio permanezca bajo su control y Microsoft conserve solo los datos operativos mínimos necesarios para ejecutar la migración.

Datos en tránsito

Toda la comunicación entre Azure DevOps, el agente linux autohospedado y GitHub Enterprise Cloud usa HTTPS cifrado por TLS. El contenido del repositorio se transfiere a través de protocolos de Git cifrados. ELM no almacena el contenido del repositorio de clientes fuera del proceso de migración activo.

Gestión de PAT

ELM requiere dos GitHub tokens de acceso personal (PAT), cada uno usado para un propósito diferente. Trata ambos como secretos y concede únicamente los ámbitos documentados en los requisitos previos. Establece plazos de caducidad cortos tanto para los PAT como para los demás, y renuévalos o revócalos una vez finalizada la migración. Revoque cualquier PAT inmediatamente si sospecha exposición. Limite quién puede ver o editar la conexión de servicio al operador de migración y a los administradores necesarios.

  • PAT de conexión de servicio: Un administrador de GitHub Enterprise crea este PAT y lo usa para crear la conexión de servicio Azure DevOps para la organización de GitHub de destino. Guarde este PAT solo en la conexión de servicio. No lo suba al control de código fuente, no lo comparta por chat ni lo pegue en registros.
  • PAT de migración personal: La persona que realiza la migración crea este PAT y lo usa para autenticarse en GitHub durante la migración.

¿Qué Microsoft conserva?

ELM almacena solo metadatos operativos sobre la migración: identificadores de repositorio, estado de migración, resultados de validación, mensajes de error y eventos de auditoría. ELM no conserva el contenido del repositorio, los datos de confirmación ni PAT una vez completada la migración.

Auditoría

ELM registra los eventos del ciclo de vida de la migración en el registro de auditoría de Azure DevOps para que los administradores empresariales puedan revisar quién inició, puso en pausa, reanudó, programó la transición final de una migración o la abandonó. Utilice el registro de auditoría para respaldar las revisiones de cumplimiento y reconstruir la cronología de la migración si necesita investigar un problema.

Para ver los eventos de auditoría, vaya a Configuración de la organización>Auditoría y filtre por el área Enterprise Live Migrations.

Ámbito de ELM

¿Qué automatiza ELM?

  • Ejecuta comprobaciones previas a la migración.
  • Sincroniza el código de Git, incluidas las ramas, el historial de cambios y las etiquetas para GitHub.
  • Sincroniza las solicitudes de incorporación de cambios, incluidos los títulos, las descripciones, los comentarios y el historial de usuarios.
  • Crea el repositorio de GitHub de destino.
  • Migra las directivas de rama a los conjuntos de reglas de rama de GitHub.
  • Reconfigura Azure Pipelines para que apunte al nuevo repositorio de GitHub.
  • Crea una conexión con Boards.
  • Cambia de Azure DevOps a GitHub.

Lo que haces manualmente

  • Limpie el repositorio de Azure DevOps antes de la migración (archivos grandes, solicitudes de incorporación de cambios con más de 10 000 archivos, nombres de referencia largos).
  • Cree la organización GitHub de destino.
  • Compruebe el estado del repositorio posterior a la migración (ramas, etiquetas, historial, solicitudes de incorporación de cambios).
  • Compruebe y ajuste los conjuntos de reglas de rama migrados.
  • Actualice las direcciones URL del repositorio de Azure DevOps codificadas de forma rígida en scripts, canalizaciones y herramientas.
  • Configure el acceso de equipo y usuario en GitHub.
  • Migre o retire elementos de trabajo, wikis, canalizaciones y otros datos que no son de repositorio.

Elementos que migra ELM

Datos migrados

ACTUALMENTE, ELM migra los siguientes datos del repositorio de Azure DevOps Services a GitHub Enterprise Cloud con residencia de datos:

  • Origen de Git, incluido el historial de confirmaciones completo
  • Ramas y etiquetas
  • Directivas de rama, migradas como conjuntos de reglas de rama de GitHub
  • Metadatos de solicitud de incorporación de cambios, incluidos títulos, descripciones, ramas de origen y de destino y comentarios
  • Historial de usuarios para solicitudes de incorporación de cambios

Datos que no se migran

ELM no migra los datos siguientes:

  • Elementos de trabajo
  • Definición de canalizaciones
  • Lanzamientos
  • Sitios Wiki
  • Planes de prueba y resultados de pruebas
  • Azure Artifacts
  • Objetos LFS de Git (futuros)

ELM migra las solicitudes de incorporación de cambios activas y fusionadas, además de las que tienen historial de rama disponible. Las solicitudes de incorporación de cambios abandonadas con ramas eliminadas no se migran.

Cómo usa ELM las canalizaciones y qué esperar para el costo

ELM se ejecuta en Azure Pipelines mediante un agente de Linux autohospedado. Durante una migración, ELM usa dos tipos de trabajos:

  • La validación inicial comprueba que el repositorio está listo para migrar. Este trabajo se ejecuta una vez.
  • La sincronización copia el repositorio en GitHub y continúa sincronizando los cambios hasta la transferencia.

El agente linux autohospedado debe mantenerse en línea y estar disponible durante la migración.

Cómo ELM usa su conjunto de agentes

ELM minimiza el impacto en las canalizaciones existentes. Usa solo un agente a la vez, independientemente de cuántos agentes haya en el grupo. Para cada repositorio, ELM pone en cola un trabajo a la vez, no ejecuta trabajos en paralelo y normalmente espera entre 30 y 60 minutos antes de poner en cola el siguiente trabajo para que otros trabajos de canalización puedan continuar.

En la práctica, ELM se comporta como cualquier otra tarea de canalización y comparte capacidad con las compilaciones actuales. No debería acaparar todo el pool ni bloquear trabajo no relacionado.

Qué esperar en cuanto al coste

ELM es libre de usar. Su único coste potencial procede de la capacidad de Azure Pipelines si su organización supera la cantidad de trabajos paralelos incluidos.

Cada trabajo de ELM puede ejecutarse durante un máximo de una hora, pero la facturación de Azure Pipelines se basa en la capacidad de trabajos paralelos, no en el número de agentes ni en los minutos utilizados. Dado que ELM se limita a un trabajo simultáneo, muchos clientes pueden ejecutar migraciones dentro de su capacidad existente sin costo adicional. Si supera la capacidad incluida, es posible que tenga que comprar trabajos paralelos adicionales. Azure Pipelines también incluye minutos gratuitos para proyectos privados, por lo que el costo agregado normalmente se aplica solo después de que se agote el nivel gratuito.

Flujo de trabajo de migración

A grandes rasgos, una migración de ELM sigue estos pasos. Cada paso vincula a instrucciones detalladas.

  1. Obtenga información sobre Enterprise Live Migrations. Revise esta introducción para comprender lo que hace ELM, lo que migra y cómo encaja en el plan de migración. Decida si el equipo planea mover completamente los flujos de trabajo de desarrollo a GitHub o seguir usando Azure DevOps y GitHub juntos en un modelo híbrido. Si elige un modelo híbrido, ELM puede ayudar a reducir la configuración posterior a la migración mediante el cambio de Azure Pipelines al repositorio de GitHub migrado y la creación de la conexión de Azure Boards.
  2. Complete los requisitos previos. Compruebe el acceso, las herramientas y la autenticación y recopile los identificadores que necesita para ejecutar comandos de migración. Para obtener más información, consulte Requisitos previos completos.
  3. Inicie la migración. Autentíquese en Azure DevOps, establezca los valores predeterminados y use la CLI de ELM para iniciar la sincronización inicial. Para obtener más información, consulte Iniciar la migración.
  4. Supervisar la migración Observe la sincronización inicial y las sincronizaciones incrementales de seguimiento. Para obtener más información, consulte Supervisión de la migración.
  5. Migración a GitHub. Programe la transición tan pronto como esté listo. Debe completar la transición en un plazo de 21 días después de iniciar la migración completa (cuando comienza la sincronización inicial). Para obtener más información, consulte la transición a GitHub.
  6. Complete las tareas posteriores a la migración. Confirme que todo funciona una vez completada la migración. Para obtener más información, consulte Completar tareas posteriores a la migración.

Comprobaciones de validación previas a la migración

En la tabla siguiente se enumeran los límites de herramientas actuales comprobados durante la validación y lo que sucede si no se abordan.

Limit Umbral Si no se aborda Acción recomendada
Tamaño de archivo único en el historial > 400 MB Se produce un error en la validación y la migración no se puede iniciar hasta que el archivo se quite o se mueva a Git LFS (futuro). Vuelva a escribir el historial para quitar el archivo o migrarlo a Git LFS (futuro) y vuelva a ejecutar la validación.
Tamaño del paquete de inserción > 2 GB Se produce un error en la validación y la migración no se puede iniciar hasta que se reduzca el tamaño. Reduzca el tamaño del repositorio quitando o dividiendo confirmaciones grandes, migre archivos grandes a Git LFS (futuro) o vuelva a escribir el historial para quitar objetos sobredimensionados.
Longitud del nombre de referencia de rama o etiqueta > 255 bytes Se produce un error en la validación y la migración no se puede iniciar hasta que se cambie el nombre o se eliminen las referencias. Cambie el nombre o elimine la rama o etiqueta incorrecta y vuelva a ejecutar la validación.
Actualización del resultado de la validación Debe iniciarse la migración en un plazo de 24 horas desde una ejecución correcta de validación. Debe volver a ejecutar la validación antes de iniciar una migración completa. Reanude o inicie la migración completa sin demora después de la validación, o vuelva a ejecutar solo la validación.
Ventana de programación de transferencia Debe completar la transición en un plazo de 21 días a partir de iniciar la migración completa (cuando comienza la sincronización inicial). La migración no puede permanecer en el estado de sincronización indefinidamente. Debe completar o cancelar la transferencia dentro de la ventana o reiniciar la migración. Planifique pronto una fecha de transición, mantenga las sincronizaciones sin problemas y coordine las comunicaciones antes de que finalice la ventana.

Roles y responsabilidades clave

Función Descripción Responsibilities
Operador de migración (usuario de ELM) Persona que ejecuta y supervisa la migración en el portal o en el CLI de Azure. Ejecute operaciones de validación y migración en la experiencia seleccionada. Supervise el estado de la migración, solucione y resuelva errores, y programe y ejecute la transición.
Administrador de la colección de proyectos de Azure DevOps (PCA) y Administrador de proyectos (PA) Administrador de nivel de organización y de nivel de proyecto en Azure DevOps Conceda el permiso Enterprise Live Migrations: Administrar migraciones al operador de migración. Cree o administre grupos de agentes. Conceda acceso a grupos de agentes y conexiones de servicio.
Propietario del grupo de agentes Persona que administra agentes de compilación Configure un agente linux autohospedado. Asegúrese de que el grupo de agentes está disponible y accesible. Mantener la salud del agente durante la migración.
Propietario o equipo de desarrollo del repositorio Equipo propietario del repositorio de Azure DevOps Limpie el repositorio antes de la migración (archivos grandes, solicitudes de incorporación de cambios, etc.). Valide el repositorio migrado (ramas, solicitudes de incorporación de cambios, historial). Actualizar canalizaciones, scripts y herramientas después de la migración.
administrador de GitHub Enterprise Administrador de la organización de GitHub de destino - Instale la aplicación ELM desde GitHub Marketplace tanto en la empresa de destino como en la organización.
- Instale Azure Pipelines y Azure Boards cuando sea necesario para volver a conectar las canalizaciones de GitHub al repositorio de Azure Boards.

Paso siguiente