Mover una colección de proyectos

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Nota

Azure DevOps Server anteriormente se denominaba Visual Studio Team Foundation Server.

Puede mover una colección de proyectos de una implementación de Azure DevOps Server a otra. Por ejemplo:

  • Tiene más de una implementación de Azure DevOps Server en su organización y quiere mover una colección a otra implementación para adaptarla mejor a sus necesidades empresariales.
  • Quiere mover la colección a una oficina remota que tenga su propia implementación de Azure DevOps Server.
  • Quiere expandir la implementación de Azure DevOps Server agregando otra instancia de SQL Server y quiere distribuir las colecciones existentes entre las instancias.
  • Debe actualizar incrementalmente la implementación desasoyéndo una colección de proyectos individual de una implementación de Azure DevOps Server que ejecuta una versión anterior y, a continuación, moverla a un servidor que ejecute la versión actual de Azure DevOps Server. (Una razón común para esto es que es posible que algunos equipos necesiten migrar a una versión más reciente de Azure DevOps Server, mientras que otros deben permanecer en una versión anterior por motivos de herramientas o proyectos). En este escenario, también debe actualizar cada proyecto dentro de la colección mediante el Asistente para configurar características. Para obtener más información, vea Configurar características después de Azure DevOps Server actualizar. El Asistente para configurar características ha quedado en desuso Azure DevOps Server 2019. Solo puede ejecutar el asistente en TFS 2018 y versiones anteriores. Los proyectos definidos en Azure DevOps Services se actualizan automáticamente con cada actualización del servicio.

Los pasos para mover una colección dependerán de la configuración específica de la implementación que hospedaba la colección y la implementación a la cual debe realizarse el movimiento. Por ejemplo, si mueve una colección a un dominio nuevo, deberá agregar los usuarios del dominio a los grupos adecuados a nivel de la colección y a nivel del proyecto. Del mismo modo, si mueve una colección a una implementación de Azure DevOps Server que usa una aplicación web de SharePoint diferente, deberá mover la base de datos de colección de sitios que admite la recopilación a esa aplicación web de SharePoint o agregar la aplicación web de SharePoint que admite la recopilación a la implementación de Azure DevOps Server al que lo ha movido.

Nota

La integración con productos de Sharepoint ha quedado en desuso para TFS 2018 y versiones posteriores.

Aquí se muestra cómo mover una colección de proyectos completa. Para mover parte de una colección, vea Dividir una colección de proyectos.

Prerrequisitos

Antes de empezar el movimiento, asegúrese de ser administrador en los servidores y en el software utilizados por la implementación de origen del movimiento y la implementación de destino del movimiento. Si no es un administrador, se agrega como uno.

1. Desasoción de la colección

Antes de mover una colección, desasoyéjala primero de la implementación de Azure DevOps Server en la que se está ejecutando. Es muy importante no omitir este paso. Al separar una colección, se detienen todos los trabajos y servicios y, a continuación, se detiene la base de datos de recopilación. Además, el proceso de desasoción copia los datos específicos de la colección de la base de datos de configuración y los guarda como parte de la base de datos de recopilación de proyectos. Estos datos de configuración son lo que permite adjuntar la base de datos de recopilación a una implementación diferente de Azure DevOps Server. Si los datos no están presentes, no puede adjuntar la colección a ninguna implementación de Azure DevOps Server excepto la desde la que se originó.

Nota

Desasociar una colección evita que los usuarios accedan a ningún proyecto de la colección.

  1. Abra la consola de administración de Azure DevOps en el servidor que hospeda la colección que se moverá y, en Project Collections (Colecciones), resalte esa colección.

  2. En la pestaña General, seleccione Desasoyr colección.

    Desasoción de colecciones de proyectos

    En la pestaña General, selecciónelo y, a continuación, desasócielo.

    Se abre el Asistente para Project recopilación de archivos.

  3. (Opcional) En la página Proporcionar un mensaje de mantenimiento para la colección de proyectos, en Mensaje de mantenimiento , proporcione un mensaje para los usuarios que puedan intentar conectarse a los proyectos de esta colección.

  4. Seleccione Next (Siguiente).

  5. En la página Revisar la configuración que se usará para separar la colección de proyectos, revise los detalles.

  6. Para cambiar cualquier configuración, seleccione Anterior. Si parece que son correctos, seleccione Comprobar.

  7. Cuando todas las comprobaciones de preparación se hayan completado correctamente, seleccione Desasoyen.

  8. En la página Supervisar el progreso de desasoción de la colección de proyectos, cuando se hayan completado todos los procesos, seleccione Siguiente.

    El asistente muestra el progreso

  9. (Opcional) En la página Revisar información complementaria de esta colección de proyectos, seleccione o anote la ubicación del archivo de registro.

  10. Seleccione Cerrar.

    La colección de proyectos ya no aparece en la lista de recopilaciones de la consola de administración.

    La consola de administración de TFS no se muestra desasociada.

2. Copia de seguridad de la base de datos de recopilación

Después de desasociar la colección, haga una copia de seguridad de su base de datos para moverla al otro servidor. Para realizar esta tarea, use las herramientas que se proporcionan con SQL Server.

Captura de pantalla del Conectar que muestra lo siguiente seleccionado: FABRIKAM2014 > Tfs_TestProjects > Tareas > copia de seguridad.

Importante

Únicamente puede restaurar una base de datos a la misma versión o a una versión más reciente de SQL Server. No se puede restaurar una base de datos SQL Server a una versión anterior del producto
Si la implementación original usaba las ediciones Enterprise o Datacenter de SQL Server, y desea restaurar bases de datos en un servidor que ejecuta la edición Standard, debe usar un conjunto de copia de seguridad que se realizó con la compresión de SQL Server deshabilitada. A menos que deshabilite la compresión de datos, no podrá restaurar las bases de datos Enterprise o Datacenter Edition en un servidor que ejecute la edición Standard. Para desactivar la compresión, siga los pasos descritos en Deshabilitar SQL Server compresión de datos en Azure DevOps bases de datos.

3. Mover la base de datos de colección

Como parte del traslado de la colección, debe restaurar, copiar o mover la base de datos de recopilación a una instancia de SQL Server configurada para admitir la implementación de Azure DevOps Server a la que va a mover la colección. Puede seleccionar el método que prefiera para mover la base de datos.

Captura de pantalla de la página principal del Asistente para copiar bases de datos.

Para obtener más información acerca de cómo mover una base de datos a otra instancia de SQL Server, vea:

4. Adjuntar la colección

Después de restaurar la base de datos de recopilación, puede adjuntar la colección a la implementación preferida de Azure DevOps Server. Si la implementación a la que se va a mover usa informes, se crearán una carpeta de informes y los informes predeterminados para la colección que va a adjuntar como parte del proceso.

Nota

Aparecerán advertencias al adjuntar la colección si la implementación usa productos de SharePoint y la cuenta de servicio de Azure DevOps Server no es miembro del grupo Administradores de granja de servidores, o si la implementación usa informes y ya ha creado una carpeta y una ruta de acceso de informes idénticas a la carpeta y la ruta de acceso de la implementación anterior. Este es el comportamiento esperado y puede continuar.

  1. Abra la consola de administración Azure DevOps en el servidor que hospeda el nivel de aplicación para la implementación a la que va a mover la colección.

  2. Seleccione Project recopilaciones y, a continuación, seleccione Adjuntar colección.

    Azure DevOps Server Administration Console, Team Project Collections

    Consola de administración de TFS, Team Project Collections

    Se abre el Asistente Project recopilación de archivos.

  3. En la página Seleccionar la base de datos de recopilación de proyectos que se va a adjuntar, en SQL Server Instance, proporcione el nombre del servidor y la instancia que hospeda la base de datos de recopilación, si aún no aparece.

    Asegurarse de que la instancia de SQL Server sea correcta

  4. En la lista Bases de datos , seleccione la base de datos de recopilación que desea adjuntar y, a continuación, seleccione Siguiente.

  5. En la página Escriba la información de la colección de proyectos, proporcione un nombre para la colección en Nombre si aún no hay uno.

  6. (Opcional) En Descripción, proporcione una descripción de la colección.

  7. Seleccione Next (Siguiente).

  8. En la página Revisar configuración que se usará para adjuntar la colección de proyectos, revise la información.

  9. Para cambiar cualquier configuración, seleccione Anterior. Si toda la configuración es correcta, seleccione Comprobar.

  10. Cuando todas las comprobaciones de preparación se hayan completado correctamente, seleccione Asociar.

  11. En la página Supervisar el progreso de asociación de la colección de proyectos, cuando se hayan completado todos los procesos, seleccione Siguiente.

  12. (Opcional) En la página Revisar información complementaria de esta colección de proyectos, seleccione o anote la ubicación del archivo de registro.

  13. Seleccione Cerrar.

    La colección de proyectos aparece en la lista de recopilaciones de la consola de administración. La SharePoint web que admite esta colección en su implementación original aparecerá en la lista de aplicaciones web.

    Detener la recopilación si la configuración no está completa

  14. (Opcional) Modifique o quite la aplicación web de la lista de aplicaciones web. Para obtener más información, vea Modificar o quitar el acceso entre una SharePoint web y TFS.

5. Configuración de la colección de proyectos movidos

Puede omitir este procedimiento si ha movido la recopilación en el mismo dominio e intenta usar la misma aplicación web que anteriormente era compatible con la recopilación, y desea permitir el acceso de los administradores de esa recopilación a esta implementación de Azure DevOps Server.

Después de mover una recopilación, actualice la aplicación web y los grupos de permisos para esa recopilación con la configuración adecuada.

Configuración de la colección movida

  • Abra cada pestaña de la colección de proyectos y, si es necesario, modifique la configuración para reflejar los servicios y las ubicaciones para que coincidan con las ubicaciones de los recursos en el Azure DevOps Server. Es especialmente importante llevar a cabo está acción para SharePoint y los recursos de informes. Si ve errores, asegúrese de que la cuenta tiene los permisos necesarios para los administradores de colecciones de proyectos y de que se han agregado otros administradores de recopilación de proyectos según sea necesario.

    Para obtener información sobre esta tarea, vea Modificar una colección de proyectos y Establecer permisos de administrador para colecciones de proyectos.

6. Configuración de proyectos

Puede omitir este procedimiento si ha movido la colección en el mismo dominio y desea permitir el acceso de los usuarios de los proyectos de esa recopilación a esta implementación de Azure DevOps Server.

Después de configurar administradores para la colección que se ha movido, usted o los administradores deben agregar usuarios y grupos a los proyectos de la colección. En función de la implementación, es posible que también tenga que configurar permisos para esos usuarios en SharePoint Products y Reporting Services.

Adición de usuarios a proyectos

Adición de recursos a proyectos movidos

Preguntas y respuestas

P: Mi implementación Azure DevOps Server usa informes. ¿Cómo puedo mover también informes cuando muevo una colección?

Un: En primer lugar, deberá guardar o exportar los informes que quiera mover desde el servidor de informes que admite la colección en su implementación original. Posteriormente debe cargar cada informe manualmente en el servidor de informes que será compatible con la colección movida, lo cual puede ser un proceso largo. Tenga en consideración si quiere cargar todos los informes o si un subconjunto de informes cubrirá sus necesidades empresariales. No tiene que cargar todos los informes o algún informe, pero únicamente los informes que cargue estarán disponibles tras completarse el proceso de movimiento.

También tendrá que volver a generar el cubo de almacenamiento y analysis services en la implementación original después de mover la colección, por lo que la implementación original no sigue intentando compilar informes para una recopilación que ya no está allí.

Traslado de informes

  1. Exporte o guarde los informes que quiera mover desde el servidor de informes que era compatible con la colección en su implementación original. Para obtener más información, vea Exportar informes y Guardar informes.

  2. Cargue todos los informes que quiera mover a la carpeta adecuada del servidor de informes que sea compatible con la colección en su nuevo entorno en el Administrador de informes.

    Para obtener más información, vea Upload archivos en una carpeta.

  3. En el Administrador de informes, edite cada informe para cambiar el origen de datos al nuevo servidor de informes.

Volver a compilar un almacén de datos y Analysis Services

  1. Abra la consola de administración para Azure DevOps.

  2. En la barra de navegación, seleccione Informes.

  3. En Informes, seleccione Iniciar recompilación.

  4. En el cuadro de diálogo Recompilar el almacenamiento Analysis Services bases de datos, seleccione Aceptar.

    Nota

    Los almacenes finalizarán la recompilación y los datos finalizarán el relleno tras completarse la acción de iniciar la recompilación. Según el tamaño de la implementación y la cantidad de datos, todo el proceso puede tardar varias horas en completarse.

P: ¿Cómo puedo mover una colección que usa Productos de SharePoint?

Un: Para mover una colección de proyectos que usa una aplicación web SharePoint, debe mover tanto la propia colección de proyectos como la colección de sitios de SharePoint que admite la colección de proyectos. La colección de sitios debe moverse a la aplicación web que admitirá la colección de proyectos en la nueva implementación. En concreto, debe hacer una copia de seguridad de la base de datos de colección de sitios y, a continuación, mover la base de datos de colección de sitios. Una vez que lo haya hecho y haya adjuntado la colección de proyectos trasladada a su Azure DevOps Server de destino, deberá reparar la conexión entre ese Azure DevOps Server y su aplicación web de SharePoint para asegurarse de que la colección adjunta se conecta a la colección de sitios movidos. También deberá asegurarse de que la pestaña de SharePoint colección de proyectos apunta a esa base de datos de recopilación de sitios.

Nota

Si va a mover la colección entre implementaciones que usan SharePoint Products, se recomienda encarecidamente que la cuenta de servicio de Azure DevOps Server sea miembro del grupo Administradores de granja en SharePoint Products en ambas implementaciones. De lo contrario, puede experimentar errores al intentar desasociar o adjuntar la colección.
Puede mover una colección de proyectos sin conceder esta pertenencia a la cuenta de servicio para Azure DevOps Server. No obstante, aparecerán errores cuando adjunte la colección y tendrá que realizar pasos adicionales para volver a conectar los proyectos con sus portales. Incluso si sus requisitos operativos normalmente restringen esta pertenencia a la cuenta de servicio, debe considerar la posibilidad de agregar la cuenta de servicio al grupo de Administradores de la granja de servidores mientras dure la operación de movimiento.

  1. Abra la consola de administración de Azure DevOps, seleccione SharePoint Web Applications y, en la lista de aplicaciones web, seleccione la aplicación web que admite la colección que acaba de adjuntar.

    El botón Reparar conexión aparece después de seleccionar una aplicación web en la lista.

  2. Seleccione Reparar conexión y, en el cuadro de diálogo Reparar la conexión a una SharePoint web, seleccione Reparar.

  3. En Project collections, seleccione la colección de proyectos movidos, seleccione la pestaña SharePoint Products (Productos) y modifique la configuración para que apunte a la base de datos de la colección de sitios.

P: ¿Cómo una colección de proyectos de equipo que incluya grupos de implementación o grupos de implementación?

Un: Al mover la recopilación a otra implementación, para cada grupo de implementación del origen que tenga un grupo de implementación en la recopilación desasociada, se aprovisiona automáticamente un nuevo grupo de implementaciones en la instancia de destino. En el caso de Azure DevOps Server 2019 o posterior, el nombre del grupo de implementación aprovisionado automáticamente es el mismo que en la instancia de origen. En versiones anteriores, el nombre del grupo de implementación tiene el formato <project name-deployment-group name> . En caso de conflictos, se anexa un GUID aleatorio al nombre del grupo de implementación.

Una vez completado el traslado:

  • Existe la posibilidad de crear varios grupos de implementación. Puede combinar los grupos duplicados mediante el comando TfsConfig. Por ejemplo: TfsConfig.exe deploymentpool /migrateDeploymentGroups /fromPool:<Source Pool Name> /toPool:<Target Pool Name>
  • Debe volver a configurar los agentes con el nuevo grupo de implementación. Este es un script de reconfiguración del agente de implementación de ejemplo para su referencia.

P: Cómo una colección de proyectos que incluye Lab Management?

Un: Si ha movido la colección a un dominio diferente o piensa usar un System Center Virtual Machine Manager (SCVMM) diferente, debe eliminar las máquinas virtuales, las plantillas, los grupos host de proyecto y los recursos compartidos de biblioteca de proyectos de la base de datos de recopilación antes de iniciar el traslado y volver a crearlas en Microsoft Test Manager después del traslado.

Nota

Lab Management ha quedado en desuso para TFS 2017 y versiones posteriores.

Eliminación de Lab Management recursos antes de mover la colección

  • Para obtener información sobre cómo quitar todos los hosts de grupo, recursos compartidos de biblioteca y entornos de una colección de proyectos especificada, vea comando TFSConfig Lab /Delete con la opción /External.

Configuración Lab Management recursos después de mover la colección

  1. Configure el nivel de aplicación para Azure DevOps.

    Para obtener más información, vea Configurar Lab Management para entornos de SCVMM.

  2. Vuelva a crear las plantillas y las máquinas virtuales maestras en el nuevo SCVMM e importe máquinas virtuales y plantillas en la colección de proyectos.

    Para obtener más información, consulte Creación y almacenamiento de máquinas virtuales yplantillas listas para Lab Management .

  3. Vuelva a crear los entornos para cada proyecto.

    Para más información, consulte Creación de un entorno de SCVMM mediante plantillas y máquinas virtuales almacenadas.

P: Cómo restringir el acceso para seleccionar funciones en un proyecto?

Un: Los usuarios que tienen permisos para acceder a un proyecto dentro de una colección pueden ver otros proyectos dentro de esa colección, incluso si no tienen permisos para modificar elementos de trabajo o realizar otras acciones en ese proyecto. Puede conceder o restringir el acceso para seleccionar características y funciones para crear o modificar artefactos seleccionados, así como impedir que vean proyectos, mediante la creación específica de grupos y la configuración de restricciones en esos grupos.