Administrar colecciones de proyectos en Azure DevOps Server

Artículo
04/03/2024

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Cuando el Azure DevOps Server hospeda varios proyectos, puede administrarlos de forma más eficaz agrupandolos y asignando los mismos recursos a ellos. Por ejemplo, puede agrupar proyectos que tengan requisitos o objetivos similares, como todos los proyectos que acceden 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. Al instalar Azure DevOps Server, se crea una colección predeterminada para contener todos los proyectos. Al crear una colección, se especifican los recursos lógicos y físicos que los proyectos de esa colección pueden usar. 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 se integran las bases de datos de las colecciones de proyectos con la arquitectura lógica. Al crear un proyecto, especifique la colección que almacenará sus datos.

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

Ver información o configurar el proyecto existente

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

Debe ser miembro del grupo administradores local en el servidor en el que desea abrir la consola, y ya sea miembro del grupo administradores de Azure DevOps Server o de Team Foundation, o bien el permiso Editar Server-Level Información debe establecerse en Permitir.
Inicie sesión en el servidor de capa de aplicación, abra la Consola de administración y abra el nodo Colecciones de proyectos de equipo .

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 colección o Detener recopilación: inicie o detenga una colecció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 se detiene la colección, solo aparece Start Collection . Una colección puede tardar varios minutos en iniciarse o detenerse. Es posible que tenga que elegir Actualizar para mostrar el cambio en estado. Editar configuración: edite la descripción o configuración de la colección. Pertenencia a grupos: agregue o quite usuarios o grupos como miembros de una colección. Para más información, consulte Establecimiento de 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	Vea un registro de actividad o vuelva a ejecutar un trabajo.
Proyectos	Vea los proyectos definidos para una colección y Eliminar un proyecto. Para obtener más información sobre los proyectos, consulte Creación de un proyecto.

Configuración de informes

La página Informes solo aparece cuando ha agregado un servidor de informes a Azure DevOps. Elija esta página para realizar las siguientes tareas:

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 de todos los proyectos existentes y futuros de la colección.

Creación de una colección de proyectos

Antes de crear una colección de proyectos, revise ¿Cuáles son las ventajas y desventajas de crear varias colecciones de proyectos? como se describe más adelante en este artículo.

Si no se ha agregado como administrador, se agregará ahora.

Debe ser miembro del grupo administradores local en el servidor en el que desea abrir la consola, y un miembro del grupo Administradores de Team Foundation o el permiso Editar Server-Level Información debe establecerse en Permitir.
En la consola de administración, abra la página Colecciones de proyectos de equipo y elija Crear colección.
Siga las instrucciones proporcionadas por el Asistente para crear colección de proyectos de equipo .

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

Elija Herencia si desea usar la interfaz de usuario para personalizar el seguimiento del trabajo. 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 del trabajo.

Nota

Para el modelo de proceso XML local, puede usar witadmin para enumerar, importar, exportar y modificar un proceso para un proyecto. En el caso de los modelos de proceso heredados, solo puede usar witadmin para enumerar y exportar la información del proceso. Para obtener información general sobre los modelos de proceso y lo que se admite, consulte Personalización de la experiencia de seguimiento del 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

Especifique el nombre del servidor de capa de datos de Azure DevOps. 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
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 usada 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.

SQL Server Reporting Services

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, consulte Agregar un servidor de informes.
Revise la información del servidor y la carpeta que hospedará 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 de su empresa impidan la creación automática de una carpeta como parte del proceso del asistente, debería usar la opción predeterminada, crear una carpeta.
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.

Proceso de verificación

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

Aparece un indicador de error subrayado 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.

Una vez que se hayan superado todas las comprobaciones de preparación, elija Crear.
Se inicia el proceso de creación de una colección de proyectos.

Una vez finalizado el asistente, elija Cerrar.

Desasociar o eliminar una colección de proyectos

Desasocie una colección de proyectos cuando desee realizar una operación de mantenimiento, como mover o dividir una colección. Teams no puede acceder a proyectos ni código fuente al desasociar la colección.

Elimina una colección cuando ya no necesita 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 y (2) eliminar la base de datos de recopilación.

Desasociar la colección

En la consola de administración, resalte el nombre de la colección que desea eliminar y, a continuación, elija Desasociar colección.
Siga las instrucciones proporcionadas por el Asistente para separar la colección de proyectos de equipo.

(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.
Cuando todas las comprobaciones de preparación se hayan completado correctamente, elija Desasociar.

En la página Supervisar el progreso de desasociación de la colección de proyectos , cuando se hayan completado todos los procesos, elija Siguiente.
(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

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

Resalte el nombre de la base de datos de colecció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.

La colección de proyectos ya no aparece en la lista de colecciones 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 TFSConfig Collection para adjuntar, desasociar, eliminar o clonar una colección de proyectos.

P: ¿Cuáles son las ventajas y desventajas de crear varias colecciones de proyectos?

Si los esfuerzos de desarrollo se beneficiarán de la capacidad de bifurcar y combinar código o 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 para administrar y distribuir bases de datos y recursos. Un grupo de proyectos relacionados comparten informes, elementos de trabajo e instrucciones de proceso, 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.
- Desasocie una colección, realice una copia de seguridad y, a continuación, restáurela en otra implementación de Azure DevOps.
- 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 implementación de Azure DevOps.

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 recopilación?

Un: Cada proyecto pertenece a una colección. Para obtener información sobre cómo administrar una colección, consulte Introducción a la administración de la organización o la colección de proyectos.

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

Un: Un único almacenamiento de datos relacional contiene todos los datos notificables de todos los proyectos definidos en todas las colecciones de proyectos para una implementación de Azure DevOps. Los datos de dicho almacén se procesan y escriben posteriormente en el cubo OLAP. Dado que los datos se recopilan en un único almacenamiento de datos, puede informar 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 implementación de Azure DevOps. 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.