Administración de colecciones de proyectos en Team Foundation Server

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

Nota

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

Cuando el Azure DevOps Server, anteriormente denominado Team Foundation Server (TFS), hospeda varios proyectos, puede administrarlos de forma más eficaz si los agrupa y les asigna los mismos recursos. Por ejemplo, puede agrupar proyectos que tienen requisitos u objetivos similares, como todos los proyectos que tienen acceso a una base de código determinada. A continuación, puede administrar el grupo de proyectos de equipo como un recurso autónomo, con grupos de usuarios, recursos de servidor y programación de mantenimiento propios.

Un grupo de proyectos se denomina colección de proyectos. Cuando se instala Azure DevOps Server, se crea una colección predeterminada que contiene todos los proyectos. Cuando se crea una colección, se especifican los recursos lógicos y físicos que pueden usar los proyectos dentro de esa colección. Todos los artefactos y datos que esos proyectos usan se almacenan en la base de datos única de la colección.

En la ilustración siguiente se muestra cómo las bases de datos de las colecciones de proyectos se integran con la arquitectura lógica. Cuando se crea un proyecto, se especifica la colección que almacenará sus datos.

Ejemplo: posible ubicación de bases de datos de colección

Ver información o configurar un proyecto existente

  1. Si no se ha agregado como administrador de Azure DevOps Server, ahora se agrega.

    Debe ser miembro del grupo de administradores local en el servidor donde desea abrir la consola y ser miembro del grupo de administradores de Azure DevOps Server o Team Foundation, o bien el permiso Editar información de Server-Level debe establecerse en Permitir.

  2. Inicie sesión en el servidor de nivel de aplicación, abra laConsola de administración y abra el nodo Team Project Collections.

    Visualización de colecciones de proyectos

    Visualización de colecciones de proyectos

  3. Resalte el nombre de una colección y revise la información proporcionada por las distintas pestañas. Algunas pestañas solo aparecen si se ha configurado la aplicación correspondiente.

    Puede realizar las siguientes tareas desde la pestaña correspondiente.

    Pestaña Tareas
    General
    • Iniciar recopilación o Detener recopilación:inicie o detenga una recopilación. Los proyectos dejan de estar disponibles cuando se detiene una colección. Normalmente, las colecciones se detienen para realizar operaciones de mantenimiento, como mover o dividir una colección.
    • Si se inicia la colección, solo aparece Detener recopilación. Si la colección se detiene, solo aparece Iniciar * recopilación. Una colección puede tardar varios minutos en iniciarse o detenerse. Es posible que tenga que elegir Actualizar para mostrar el cambio de estado.
    • Editar configuración:edite la descripción o configuración de la colección.
    • Pertenencia agrupos: agregue o quite usuarios o grupos como miembros de una colección. Para más información, consulte Establecer permisos de administrador para colecciones de proyectos.
    • Administrar seguridad:administre los permisos de un grupo de recopilación. Para más información, consulte Referencia de permisos y grupos.
    Estado Ver un registro de actividad o volver a ejecutar un trabajo.
    Proyectos
    Carpeta informes
    • Configurar el servidor de informes para su uso en la colección.
    • Si edita la ubicación de carpeta predeterminada, se producirá un error si escribe la ruta de acceso de una carpeta que no existe en el servidor y no tiene permiso para crear una carpeta en ese servidor. Se debe especificar una carpeta existente si no se tienen permisos para crear carpetas en ese servidor.
    • Para quitar la ubicación predeterminada de las subcarpetas de informe, elija Borrar configuración.
    • Al quitar la configuración, se quita la funcionalidad de informes para todos los proyectos existentes y futuros de la colección.
    • Esta pestaña solo aparece cuando se ha agregado un servidor de informes a Azure DevOps.

    Para TFS-2017 y versiones anteriores, la pestaña sitio de SharePoint proporciona información sobre la integración de SharePoint Products con TFS.

    Pestaña Tareas
    SharePoint sitio
    • Vea, configure o quite la ubicación raíz predeterminada para donde se crean los portales de proyecto. El Asistente para crear Project equipo crea portales de proyecto en esta ubicación.
    • Si la SharePoint aplicación web está vacía, el nivel de aplicación no se ha configurado con ninguna aplicación.
    • Esta pestaña solo aparece cuando se ha configurado el nivel de aplicación con SharePoint Products. Consulte Add SharePoint products to your deployment (Agregar SharePoint productos a la implementación).

Creación de una colección de proyectos

Antes de crear una colección de proyectos, vaya a esta sección para obtener más información sobre las ventajas y desventajas de la creaciónde varias colecciones de proyectos .

  1. Si no se ha agregado como administrador, ahora se agrega.

    Debe ser miembro del grupo de administradores local en el servidor donde desea abrir la consola y un miembro del grupo Administradores de Team Foundation o del permiso Editar información de Server-Level debe establecerse en Permitir.

  2. En la consola de administración, abra la página Team Project Collections y elija Create Collection (Crear colección).

    Captura de pantalla de Azure DevOps Server consola de administración con la opción Crear colección seleccionada.

    Creación de una colección de proyectos

  3. Siga las instrucciones proporcionadas por el Asistente para crear Project recopilación de equipos.

    En Nombre, especifique un nombre único con no más de 64 caracteres (cuanto más corto sea el mejor) y no especifique barras diagonales ni otros caracteres especiales enumerados en Restriccionesde nomenclatura .

    Captura de pantalla del cuadro de diálogo Crear colección Project equipo con la opción Herencia seleccionada.

    Elija Herencia si desea usar la interfaz de usuario para personalizar el seguimiento del trabajo. Tenga en cuenta que esta opción se basa en el servicio Analytics para satisfacer sus necesidades de informes.

    Elija XML si desea usar archivos de definición XML para personalizar el seguimiento de trabajo.

    El asistente admite la configuración de los siguientes recursos. Algunos recursos solo se pueden configurar si el servidor de capa de aplicación que hospeda la colección se ha configurado previamente para admitir la aplicación correspondiente.

Instancia de SQL Server o de capa de datos

  1. Especifique el nombre del Azure DevOps de capa de datos. Si desea usar una instancia con nombre para hospedar la base de datos de esta colección de proyectos, también debe especificar el nombre de la instancia como en el ejemplo siguiente:

    Nombredeservidor \ Instancename

  2. Elija Crear una nueva base de datos para esta colección si desea crear una base de datos para la colección. Esta opción requiere que la cuenta de servicio utilizada por el agente de trabajo en segundo plano de Visual Studio Team Foundation tenga permisos para crear una base de datos en la instancia de SQL Server.

    O bien, elija Usar esta base de datos existente si desea usar una base de datos que ya existe y especifique el nombre de la base de datos. Esta opción requiere que disponga de permisos de escritura y que exista una base de datos en la instancia con nombre de SQL Server.

Aplicación web de SharePoint

  1. SharePoint aplicación web aparece si ha configurado el nivel de aplicación con una SharePoint web; de lo contrario, está deshabilitada. Para configurarlo más adelante, consulte Add SharePoint products to your deployment (Agregar SharePoint productos a la implementación).

  2. Elija Siguiente si desea usar la opción predeterminada para crear una colección de sitios. Elija esta opción a menos que su infraestructura empresarial requiera el uso de una colección de sitios existente. Esta opción creará una colección de sitios de SharePoint y el nombre de la colección se usará como el nombre del subsitio del sitio raíz que se configura en la aplicación web de SharePoint.

    Esta opción requiere que Azure DevOps cuenta de servicio sea miembro del grupo Administradores de granja. Si no es así, no puede crear una colección de sitios.

  3. O bien, para usar una colección de sitios existente que un miembro del grupo Administradores de granja de servidores creó automáticamente, expanda Configuración avanzada , elija Especificar una ruta de acceso a un sitio de SharePoint existente y especifique la ruta de acceso relativa de la colección de sitios que se creó automáticamente.

    Elija Comprobar ruta de acceso y, si la ruta de acceso es correcta, elija Siguiente.

SQL Server Reporting Services

  1. Los informes aparecen si ha configurado el nivel de aplicación para usar SQL Server Reporting Services; de lo contrario, está deshabilitado. Para configurarlo más adelante, vea Agregar un servidor de informes.

  2. Revise la información del servidor y la carpeta que hospedará los informes y elija Siguiente. Esta opción requiere que su cuenta de usuario tenga permisos para crear una carpeta en el servidor que ejecuta Reporting Services.

    A menos que las restricciones de seguridad de la infraestructura empresarial impidan la creación automática de una carpeta como parte del asistente, debe usar la opción predeterminada para crear una carpeta.

  3. Si debe usar una carpeta que un administrador creó automáticamente en el servidor que ejecuta Reporting Services, expanda Configuración avanzada , elija Especificar una ruta de acceso a una carpeta existente y especifique la ruta de acceso relativa de la carpeta que se ha creado automáticamente.

    Elija Comprobar ruta de acceso y, si la ruta de acceso es correcta, elija Siguiente.

Lab Management

Lab Management aparece si ha configurado el nivel de aplicación para usar Lab Management para la colección; de lo contrario, está deshabilitado. Para configurarlo más adelante, vea Configurar Lab Management entornos de SCVMM.

Si no usa el Lab Management, vaya a Proceso de comprobación.

Si usa Lab Management, siga los pasos proporcionados en Para configurar Lab Management para cada colección de proyectos.

Proceso de verificación

  1. En Comprobaciones de preparación, revise el estado de las comprobaciones.

    Aparece un indicador de error subrayado en azul junto a cualquier configuración que contenga un error. Puede elegir el indicador para ver un mensaje detallado del problema. Debe solucionar todos los errores para poder continuar.

    Después de que se superen todas las comprobaciones de preparación, elija Crear.

  2. Se inicia el proceso de creación de una colección de proyectos.

    Captura de pantalla del cuadro de diálogo Crear colección Project equipo que muestra que el proceso de creación se ha hecho correctamente.

    Una vez que finalice el asistente, elija Cerrar.

## Desasoción o eliminación de una colección de proyectos

Desasoje una colección de proyectos cuando desee realizar una operación de mantenimiento, como mover o dividir una colección. Teams no puede tener acceso a proyectos o código fuente al desasocur la colección.

Elimine una colección cuando ya no necesite los datos almacenados en los proyectos definidos en la colección. Los tres pasos para eliminar una colección son (1) desasociar la colección, (2) eliminar la base de datos de la colección y (3) eliminar la colección de sitios de SharePoint que admitía la colección eliminada.

Desasociar la colección

  1. En la consola de administración, resalte el nombre de la colección que desea eliminar y, a continuación, elija Separar colección.

    Desasoción de colecciones de proyectos

    Desasoción de una colección de proyectos

  2. Siga las instrucciones proporcionadas por el Asistente para desasocución de Project recopilación de archivos.

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

  3. Cuando todas las comprobaciones de preparación se hayan completado correctamente, elija Desasoyéctese.

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

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

Eliminación de la base de datos de recopilación

  1. Abra SQL Server Management Studio, conéctese a la instancia del SQL Server Motor de base de datos que hospeda la base de datos de recopilación y expanda la instancia.

    Resalte el nombre de la base de datos de recopilación (de forma predeterminada, TFS _ CollectionName) y, a continuación, elimine la base de datos.

    Para obtener más información, vea Eliminar una base de datos.

Eliminar la base de datos y la colección de sitios de SharePoint

  1. Abra SQL Server Management Studio, conéctese a la instancia del SQL Server Motor de base de datos que hospeda la base de datos de recopilación y expanda la instancia.

    Resalte el nombre de la base de datos de recopilación (de forma predeterminada, TFS _ CollectionName) y, a continuación, elimine la base de datos.

    Para obtener más información, vea Eliminar una base de datos.

  2. Abra Administración central de SharePoint y elimine la colección de sitios que admitía la colección eliminada.

    Para obtener más información, vea Eliminar una colección de sitios en SharePoint 2013.

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

Preguntas y respuestas

P: ¿Existe una herramienta de línea de comandos para administrar colecciones?

Un: Puede usar el comando COLECCIÓN DE TFSConfig para adjuntar, separar, eliminar o clonar una colección de proyectos.

P: ¿Cuáles son las ventajas y desventajas de la creación de varias colecciones de proyectos?

Si sus esfuerzos de desarrollo se beneficiarán de la capacidad de bifurcar y combinar código o si debe consultar el estado de los elementos de trabajo relacionados con el mismo código, debe consolidar los proyectos en la misma colección de proyectos.

R: Ventajas de crear más de una colección

Se pueden separar mejor las necesidades operativas de un código base u otra agrupación de proyectos de las necesidades operativas de otra agrupación. Dado que los datos de cada colección se almacenan en una base de datos propia, es posible administrar independientemente muchos aspectos de cada colección de la implementación. Por ejemplo, se puede detener e iniciar cada colección individualmente. Por consiguiente, puede programar las operaciones del mantenimiento para cada colección en momentos diferentes.

La agrupación de proyectos en más de una colección proporciona las siguientes ventajas:

  • Mayor flexibilidad y escalabilidad en la administración y distribución de bases de datos y recursos. Un grupo de proyectos relacionados comparte informes, elementos de trabajo e instrucciones de procesos, así como una base de código.

    Al crear una base de datos para cada colección, los equipos y los administradores pueden realizar las siguientes tareas:

    • Compilar, bifurcar, combinar y recorrer en iteración un código base autónomo de acuerdo con las necesidades de los proyectos de la colección. Las dependencias de código ajenas a la colección se pueden administrar formalmente.
    • Efectuar una copia de seguridad y restaurar los datos de cada colección por separado de otras colecciones.
    • Almacenar todas las bases de datos de colección en una única instancia de SQL Server o distribuir las bases de datos en una o más instancias.
    • Desasozca una colección, haga una copia de seguridad de ella y, a continuación, restáurela a otra Azure DevOps implementación.
    • Reasignar los recursos para cumplir mejor las demandas de los proyectos conforme aumentan de tamaño con el tiempo.
  • Mayor seguridad operativa. Dado que cada colección tiene su propio conjunto de usuarios y permisos, el aislamiento de los diferentes códigos base se puede realizar en colecciones diferentes. Los administradores pueden agregar usuarios solo a la colección que contiene los proyectos que pertenecen a ese código base en particular.

  • Mayor capacidad para admitir procesos de flujo de trabajo personalizados. Cada colección administra las plantillas de proceso, los tipos de elemento de trabajo, los tipos de vínculo, las listas globales y los campos de elemento de trabajo de forma independiente de otras colecciones. Al separar los proyectos que tienen procesos de flujo de trabajo diferentes en colecciones diferentes, solo se exponen las personalizaciones necesarias para esos proyectos dentro de una colección.

R: Desventajas de crear más de una colección

La principal desventaja de crear más de una colección de proyectos es que aumenta la complejidad de la Azure DevOps implementación.

  • Deberá realizar copias de seguridad y restauraciones de la base de datos de cada colección, y existen otras tareas de administración y mantenimiento que también aumentan en función del número de colecciones que haya. Por ejemplo, debe administrar el conjunto de usuarios y permisos para cada colección de proyectos individualmente.
  • Los equipos no pueden vincular los elementos de trabajo entre las colecciones.
  • Los equipos no pueden crear bifurcaciones de código ni combinar el código entre las colecciones.
  • Los equipos no pueden crear consultas entre las colecciones.

P: ¿Qué recursos se administran en el nivel de colección?

Un: Cada proyecto pertenece a una colección. Además, los siguientes objetos se administran en el nivel de colección:

  • Control de código fuente (TFVC): tipos de archivo y habilitación odeshabilitación de la desprotección asincrónica en las áreas de trabajo del servidor .

  • Seguimiento de elementos de trabajo:procesos y plantillas de proceso,tipos de elementos de trabajo,tipos de vínculo,campos de elemento de trabajo,listas globales y [flujo de trabajo global](/azure/devops/reference/xml/global-workflow-xml-element-reference.

    Todos los campos definidos para todos los proyectos definidos dentro de una colección se administran o configuran para una colección. No puede definir más de 1024 campos de elemento de trabajo en la misma colección de proyectos y no puede establecer más de 1024 campos para que se puedan notificar en todas las colecciones de proyectos de equipo.

  • Dev-Test-Ops:

  • Seguridad: grupos y permisos de nivel de colección.

P: ¿Cómo admiten los informes los datos almacenados para diferentes colecciones de equipos?

Un: Un almacenamiento de datos relacional único contiene todos los datos que se pueden notificar de todos los proyectos definidos en todas las colecciones de proyectos para una Azure DevOps implementación. Los datos de dicho almacén se procesan y escriben posteriormente en el cubo OLAP. Dado que los datos se recopilan en un solo almacenamiento de datos, puede notificar en varias colecciones de proyectos.

Para crear o personalizar informes, debe agregar cuentas de usuario al rol TfsWarehouseDataReader. Los autores de informes necesitan acceso de lectura tanto al almacén de datos relacional como al cubo de Analysis Services. Estas cuentas pueden ver los datos de todos los proyectos de equipo hospedados en todas las colecciones de proyectos de la Azure DevOps implementación. No hay ninguna manera de limitar el acceso a un proyecto o colección.

P: ¿Cómo se escala la implementación con colecciones?

Un: Vea Mover una colección de proyectos o Dividir una colección de proyectos.