Completar los requisitos previos de migración

A medida que pase a la segunda fase de migración a Azure DevOps Services con la herramienta de migración de datos de Azure DevOps, debe completar los requisitos previos para transferir los datos a la nube. Si su organización ya cumple estos requisitos previos, puede omitir esta fase por completo.

Diagrama que resalta la fase Requisitos previos en fases secuenciales.

Actualizar Azure DevOps Server

La Herramienta de Migración de Datos para Azure DevOps admite las dos últimas versiones de Azure DevOps Server en un momento dado. Las versiones incluyen actualizaciones y versiones principales.

Puede tardar hasta 2 o 3 semanas después de que se lance una nueva versión RTW de Azure DevOps Server para que esté disponible la compatibilidad con la migración para esa versión. Tenga en cuenta esta posibilidad cuando decida actualizar poco después de una nueva versión de RTW Azure DevOps Server.

La herramienta de migración de datos no admite la migración desde candidatos de versión de Azure DevOps Server (RC). Si planea migrar la base de datos de recopilación a Azure DevOps Services mediante este servicio, es importante que no actualice la base de datos de producción a una versión rc. Si actualiza, debe esperar y actualizar a la versión de lanzamiento en la web (RTW) cuando esté disponible. O bien, restaure una copia de seguridad de la base de datos a partir de una versión de Azure DevOps Server anterior para migrar. No se puede cambiar a una versión anterior de Azure DevOps, pero debe revertirse mediante una copia de seguridad de la base de datos en esa versión.

La cadencia de lanzamiento normal para las nuevas versiones de Azure DevOps Server es una vez cada tres y cuatro meses. Lo que significa que la compatibilidad con una versión determinada de Azure DevOps Server para la migración a Azure DevOps Services debe durar entre seis y ocho meses. Es importante asegurarse de que su plan contemple esta ventana de soporte técnico para evitar tener que actualizar repentinamente para migrar.

Implementación de Microsoft Entra ID

Asegúrese de que su equipo tenga un tenant de Microsoft Entra ID funcional para la autenticación de los miembros en su organización de Azure DevOps Services. En Azure DevOps Services, la autenticación de usuarios se basa en un inquilino de Microsoft Entra ID; como la autenticación de usuario de Azure DevOps Server se basa en Active Directory. Durante la fase de ejecución de test (vínculo), compruebe un archivo de registro de mapa de identidad para hacer coincidir sus organizaciones de Active Directory locales con las organizaciones de Microsoft Entra ID. El servicio de migración no usa este archivo. Esta acción garantiza la visibilidad del historial individual, la conservación de permisos de seguridad y el acceso a la configuración personal.

Tip

  • Se recomienda usar el mismo inquilino de Microsoft Entra ID que otros servicios de Microsoft Cloud. Si su empresa ya tiene Microsoft Entra ID, omita este paso.
  • Aunque las cuentas de Microsoft (MSA) funcionan para la autenticación de Azure DevOps Services, no se pueden asignar durante la migración de bases de datos de Azure DevOps Server.
  • Si el inquilino de Microsoft Entra tiene habilitada la directiva Restricción de creación de organizaciones, cualquier operación de importación de datos que utilice la herramienta de migración de Azure DevOps fallará a menos que el usuario que realiza la importación sea agregado explícitamente a la lista de permitidos. Para garantizar una importación correcta:
    • Agregue temporalmente el usuario de importación a la lista de permitidos.
    • El usuario agregado a la lista de permitidos debe coincidir con el accountOwner especificado en el archivo import.json usado para la migración.
    • Para más información sobre cómo configurar la lista de permitidos, consulte Restringir la creación de organizaciones.

Sincronización de identidades y grupos con Microsoft Entra ID Connect

Sincronice el on-premises Active Directory con Microsoft Entra ID, por lo que los miembros del equipo pueden usar las mismas credenciales para autenticarse. Además, los administradores de Azure DevOps Services pueden usar los grupos de Active Directory para establecer permisos dentro de la organización.

Para configurar la sincronización, siga estos pasos:

  1. Utilice la tecnología Microsoft Entra ID Connect.
  2. Para configurar Microsoft Entra ID Connect con su entorno local, colabore con su departamento de TI, socio de DevOps, Microsoft Premier Support o Microsoft Consulting Services.

Para obtener más información sobre cómo configurar Microsoft Entra ID Connect, consulte Microsoft Entra Connect Sync.

Además, explore cómo configurar Azure DevOps Services para usar Microsoft Entra ID visitando esta página. Aunque los pasos de ese artículo no se alinean exactamente con la migración de la base de datos de Azure DevOps Server, sirve como información de referencia valiosa. La Herramienta de migración de datos establece el vínculo con el tenant de Microsoft Entra ID al principio del proceso de migración, durante la creación de la organización de Azure DevOps Services.

Note

DirSync era una tecnología predecesora para Microsoft Entra ID Connect. Actualice a Microsoft Entra ID Connect si está utilizando DirSync.

Descargar Azure DevOps Herramienta de migración de datos

La mayor parte del trabajo a lo largo de la migración a Azure DevOps Services se controla mediante la herramienta de migración de datos. La herramienta se usa con los siguientes pasos generales:

  1. Valide una colección de proyectos de equipo.
  2. Genere los archivos usados para personalizar la migración.
  3. Migración en cola de una base de datos de Azure DevOps Server a Azure DevOps Services.

Tener los siguientes elementos:

  • Rol TFSEXECROLE en SQL Server.
  • Permisos para conectarse a las bases de datos de configuración y recopilación de Azure DevOps Server.
  • Vínculo establecido entre la organización de Azure DevOps Services y el tenant de Microsoft Entra ID.

Descarga de la herramienta

  1. Descargue la versión más reciente de la herramienta de migración de datos .
  2. Copie el archivo ZIP en uno de los niveles de aplicación de Azure DevOps Server.
  3. Descomprima el archivo. También puede ejecutar la herramienta desde otro equipo sin Azure DevOps Server instalado, si puede conectarse a la base de datos de configuración de la instancia de Azure DevOps Server. 1. Abra una ventana del símbolo del sistema de comandos en el servidor y vaya al directorio donde se almacena la herramienta de migración de datos.
  4. Revise el contenido de ayuda de la herramienta:
    1. Para ver la ayuda y las instrucciones de nivel superior, ejecute el siguiente comando:
      Migrator /help
    2. Vea el texto de ayuda del comando de validación: Migrator validate /help La primera vez que valide una colección, hágalo de forma sencilla. El comando debe tener la siguiente estructura: Migrator validate /collection:{collection URL} /tenantDomainName:{name} /region:{region}
  5. Reemplace {name} por el nombre del inquilino de Microsoft Entra. Por ejemplo, para ejecutar en DefaultCollection y el inquilino fabrikam, el comando tendría el siguiente aspecto: Migrator validate /collection:[^1^][4] (http://localhost:8080/DefaultCollection) /tenantDomainName:fabrikam.OnMicrosoft.com /region:{region} Si necesita ejecutar la herramienta desde una máquina distinta de la Azure DevOps Server, use el parámetro /connectionString.

Paso siguiente