Administrar colecciones de proyectos de equipo

Si Team Foundation Server (TFS) hospeda varios proyectos de equipo, puede administrarlos de forma más eficaz si los agrupa y les asigna los mismos recursos. Por ejemplo, puede agrupar los proyectos que tengan requisitos u objetivos similares, como todos los proyectos de equipo que tengan 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 de equipo se denomina colección de proyectos de equipo. Al instalar TFS, se crea una colección predeterminada para contener todos los proyectos de equipo. Al crear una colección, se especifican los recursos lógicos y físicos que los proyectos de equipo de esa colección pueden utilizar. Todos los artefactos y datos que esos proyectos de equipo usan se almacenan en la base de datos única de la colección.

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

Ver información o configurar las colecciones de proyectos de equipo existentes

1. Si no le agregaron como administrador de TFS, pida que le agreguen ahora.

   Debe ser miembro del grupo local Administradores en el servidor donde desea que se abra la consola; además, debe ser miembro del grupo Administradores de Team Foundation o que el permiso Editar información en el nivel de servidor esté establecido en Permitir.

2. Inicie sesión en el servidor de capa de aplicación de TFS, abra la consola de administración de TFS y abra el nodo Colecciones de proyectos de equipo.

   

   Para obtener información sobre cómo abrir la consola de administración, consulte el tema sobre cómo usar la consola de administración de Team Foundation para configurar y administrar la implementación.

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

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

   Tab	Tareas
   General	Iniciar colección o Detener colección: iniciar o detener una colección. Al detener una colección, los proyectos de equipo dejan de estar disponibles. Normalmente, las colecciones se detienen para realizar operaciones de mantenimiento, como mover o dividir una colección. Si la colección se ha iniciado, solo aparece Detener colección. Si la colección está detenida, solo aparece Iniciar colección. Una colección puede tardar varios minutos en iniciarse o detenerse. Puede que sea necesario elegir Actualizar para que se muestre el cambio de estado. Editar configuración: editar la descripción o la configuración de la colección. Pertenencia a grupos: agregar o quitar usuarios o grupos como miembros de una colección. Para obtener más información, vea Establecer permisos de administrador para colecciones de proyectos de equipo. Administrar la seguridad: administrar los permisos de un grupo de la colecciones. Para obtener más información, vea Referencia de permisos para Team Foundation Server.
   Estado	Ver un registro de actividad o volver a ejecutar un trabajo.
   Proyectos de equipo	Ver los proyectos de equipo definidos para una colección y Eliminar un proyecto de equipo. Para obtener más información sobre proyectos de equipo, consulte Crear un proyecto de equipo.
   Carpeta de 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 para las subcarpetas del informe, elija Borrar configuración. Si quita la configuración, también se quitará la funcionalidad de informes de todos los proyectos de equipo existentes y futuros en la colección. Esta pestaña solo aparece si se ha agregado un servidor de informes en TFS.
   Sitio de SharePoint	Ver, configurar o quitar la ubicación raíz predeterminada donde se crean los portales de proyectos de equipo. El asistente para Crear nuevo proyecto de equipo crea portales del proyecto de equipo en esta ubicación. Si la lista Aplicación web de SharePoint está vacía, la capa de aplicación no se ha configurado con aplicaciones. Esta pestaña solo aparece si se ha configurado la capa de aplicación con Productos de SharePoint. Consulta Agregar productos de SharePoint a implementación.

Crear una colección de proyectos de equipo

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

1. Si no le agregaron como administrador de TFS, pida que le agreguen ahora.

   Debe ser miembro del grupo local Administradores en el servidor donde desea que se abra la consola; además, debe ser miembro del grupo Administradores de Team Foundation o que el permiso Editar información en el nivel de servidor esté establecido en Permitir.

2. En la consola de administración, abra la página Colecciones de proyectos de equipo página y elija Crear colección.

   

3. Siga las instrucciones proporcionadas en el asistente Crear colección de proyectos de equipo.

   En Nombre, especifique un nombre único con no más de 64 caracteres (cuanto menos, mejor) y no incluya barras diagonales ni ningún otro de los caracteres especiales enumerados en Restricciones de nomenclatura en Team Foundation.

   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. En Instancia de SQL Server, especifique el nombre del servidor de la capa de datos de TFS. Si desea usar una instancia con nombre para hospedar la base de datos de esta colección de proyectos de equipo, también debe especificar el nombre de la instancia, como en el siguiente ejemplo:

      NombreDelServidor**\**NombreDeInstancia

   2. Elija Crear 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 para 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 base de datos existente si desea utilizar una base de datos que ya existe y especifique el nombre de la base de datos en el cuadro de texto. 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. Aplicación web de SharePoint aparece si ha configurado la capa de aplicación con una aplicación web de SharePoint; en caso contrario, está deshabilitado. Para configurarlo más adelante, consulte Agregar productos de SharePoint a 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 la cuenta de servicio de TFS sea miembro del grupo Administradores del conjunto de servidores. Si no lo es, 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 del conjunto de servidores creó para usted, 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ó para usted.

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

   SQL Server Reporting Services

   1. Informes aparece si ha configurado la capa de aplicación para usar SQL Server Reporting Services; en caso contrario, está deshabilitado. Para configurarlo más adelante, consulte Agregar un servidor de informes.

   2. Revise la información del servidor y de la carpeta que hospedarán los informes y, a continuación, 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.

   3. Si debe usar una carpeta que un administrador creó 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 creó para usted.

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

   Lab Management

   • Lab Management aparece si ha configurado la capa de aplicación para usar Lab Management para la colección; en caso contrario, está deshabilitado. Para configurarlo más adelante, consulte Configurar Lab Management para entornos de SCVMM.

     Si no usa Lab Management, vaya al Proceso de verificación.

     Si usa Lab Management, siga los pasos proporcionados para configurar Lab Management para cada colección de proyectos de equipo como se describe en Configurar Lab Management para entornos de SCVMM.

   Proceso de verificación

   1. En Comprobaciones de disponibilidad, revise el estado de las comprobaciones.

      Al lado de cualquier configuración que contenga errores, aparecerá un indicador Error subrayado de color azul. Puede elegir el indicador para ver un mensaje detallado del problema. Debe solucionar todos los errores para poder continuar.

      Una vez superadas todas las comprobaciones de disponibilidad, elija Crear.

   2. Se iniciará el proceso de creación de una colección de proyectos de equipo.

      Cuando finalice el asistente, elija Cerrar.

Desasociar o eliminar una colección de proyectos de equipo

Una colección de proyectos de equipo se desasocia cuando se desea realizar una operación de mantenimiento, como mover o dividir una colección. Cuando la colección se desasocia, los equipos no tienen acceso a los proyectos de equipo ni al código fuente.

Una colección se elimina cuando ya no se necesitan los datos almacenados en los proyectos de equipo 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. Desde la consola de administración, resalte el nombre de la colección que desea eliminar y, a continuación, elija Desasociar colección.

   

2. Siga las instrucciones proporcionadas en el asistente Desasociar colección de proyectos de equipo.

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

3. Cuando todas las comprobaciones de disponibilidad se hayan completado correctamente, elija Desasociar.

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

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

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 motor de base de datos de SQL Server que hospeda la base de datos de la colección y expanda la instancia.

   Resalte el nombre de la base de datos de la colección (de forma predeterminada, TFS_NombreDeColección) y, a continuación, elimine la base de datos.

   Para obtener más información, consulte el tema sobre cómo 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, consulte el tema sobre cómo eliminar una colección de sitios de SharePoint 2013.

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

Preguntas y respuestas

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

Si la bifurcación y combinación de código le resultará beneficiosa o si debe consultar el estado de los elementos de trabajo que están relacionados con el mismo código, debería consolidar los proyectos de equipo en la misma colección de proyectos de equipo.

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 de equipo en más de una colección proporciona las siguientes ventajas:

• Mayor flexibilidad y escalabilidad en la administración y distribución de las bases de datos y los recursos. Un grupo de proyectos de equipo relacionados pueden compartir informes, elementos de trabajo y guía de procesos, así como el código base.

  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.

  • Desasociar una colección, efectuar una copia de seguridad de la misma y restaurarla en una implementación diferente de TFS.

  • 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 en distintas colecciones los proyectos de equipo que tienen procesos de flujo de trabajo diferentes, esas personalizaciones solo se exponen a los proyectos de equipo 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 de equipo es que se aumenta la complejidad de la implementación de TFS.

• 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 individualmente el conjunto de usuarios y permisos de cada colección de proyectos de equipo.

• 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é objetos o recursos se administran en el nivel de colección?

R: Cada proyecto de equipo 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 archivos y habilitar/deshabilitar la desprotección asincrónica en áreas de trabajo del servidor.

• Seguimiento de elementos de trabajo: plantillas de proceso, tipos de elemento de trabajo, tipos de vínculo, campos de elemento de trabajo, listas globales y flujo de trabajo global.

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

• Operaciones de prueba de desarrollo: controladores de compilación y recursos de Lab management (grupo host y recurso compartido de biblioteca de SCVMM)

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

P: ¿Cómo se admiten en TFS los informes de datos almacenados para colecciones de equipo diferentes?

R: Un único almacén de datos relacional contiene todos los datos que se pueden incluir en los informes de todos los proyectos de equipo que están definidos en cada una las colecciones de proyectos de una implementación de TFS. Los datos de dicho almacén se procesan y escriben posteriormente en el cubo OLAP. Puesto que los datos se recopilan en un único almacén de datos, puede crear informes sobre varias colecciones de proyectos de equipo.

Para crear o personalizar los 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 datos de todos los proyectos de equipo hospedados en todas las colecciones de proyectos de equipo de la implementación de TFS. No es posible limitar el acceso a un proyecto de equipo o a una colección.

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

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

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

R: Puede usar el comando TFSConfig Collection para adjuntar, desasociar, eliminar o clonar una colección de proyectos de equipo. Consulta Collection (comando) [TFSConfig].