Implementar y configurar un controlador de compilación

Para usar Team Foundation Build, el equipo debe tener al menos un controlador de compilación para realizar tareas ligeras y distribuir el trabajo del proceso de compilación al conjunto de agentes de compilación, que usa muchos recursos del procesador.

Sugerencia
Si la colección de proyectos de equipo se hospeda en Team Foundation Service, es posible que pueda utilizar el controlador de compilación hospedado en lugar de implementar su propio sistema de compilación.

Cada controlador de compilación se dedica a una colección de proyectos de equipo única.El controlador de compilación procesa algunas tareas ligeras, como, por ejemplo, determinar el nombre de la compilación, crear la etiqueta en el control de versiones, registrar las notas y notificar el estado de la compilación.El controlador de compilación usa la actividad de AgentScope para delegar el trabajo intensivo del procesador, como compilar código o hacer pruebas para los agentes de compilación dentro de su grupo.Estos agentes de compilación se pueden hospedar en el mismo servidor de compilación o en otro servidor de compilación.

Dado que un controlador de compilación normalmente no requiere gran cantidad de tiempo de procesador, en muchos casos puede hospedarlo en el mismo equipo que Team Foundation Server, como se mostró anteriormente, o en un equipo de baja potencia física o virtual.

Sin embargo, un controlador de compilación puede exigir una cantidad importante de memoria en algunas situaciones, por lo que debe proporcionar tanta memoria como sea necesario para asegurarse de que funciona correctamente.O, dependiendo de las necesidades y recursos del equipo, puede que desee ejecutar el controlador de compilación en un equipo diferente al de Team Foundation Server.

Permisos necesarios

Debe ser miembro del grupo Administradores de Windows en el servidor de compilación y del grupo Project Collection Build Administrators en la colección de proyectos de equipo.Vea Permisos de Team Foundation Server.

¿Qué desea hacer?

• Crear o modificar un controlador de compilación

• Permitir que los procesos de compilación saquen partido a los binarios complementarios

• Especificar el número máximo de compilaciones en ejecución simultánea

• Quitar un controlador de compilación

• Usar el controlador de compilación hospedado en una colección de proyectos de equipo hospedada en Team Foundation Service

Crear o modificar un controlador de compilación

Para crear o modificar un controlador de compilación en el servidor de compilación

1. Inicie sesión en el servidor de compilación.

2. Desde Inicio de Windows, ejecute Consola de administración de Team Foundation Server.

3. En el panel del árbol de la consola de administración de Team Foundation, expanda el nombre del servidor y, a continuación, elija el nodo Configuración de compilación .

   [!NOTA]

   Si aparece el mensaje Configurar características instaladas, vea Implementar un servidor de compilación.

4. En la página Configuración de compilación:

   • Si no aparece un controlador, elija Nuevo controlador.

   • Si un controlador ya aparece en la lista:

     

     Elija Propiedades.

   Aparece el cuadro de diálogo Propiedades del controlador de compilación.

Para modificar un controlador de compilación desde Visual Studio

1. En Visual Studio, en Team Explorer:

   1. Si aún no está conectado a un proyecto de equipo en el proyecto de equipo, conéctese al mismo.

   2. Elija Inicio y luego elija Compilaciones.

2. En la página de compilaciones, elija Acciones y, a continuación, Administrar controladores de compilación.

   Aparece el cuadro de diálogo Administrar controladores de compilación.

   

3. Seleccione el controlador de compilación que desee modificar y, a continuación, elija Propiedades.

   Aparece el cuadro de diálogo Propiedades del controlador de compilación.

En los campos Nombre para mostrar y Descripción : escriba un nombre y una descripción que sirvan de ayuda a los miembros del equipo para identificar el controlador de compilación adecuado cuando se definen los procesos de compilación.

Vea las secciones siguientes para obtener más información sobre cómo configurar el controlador de compilación.

Permitir que los procesos de compilación saquen partido a los binarios complementarios

Puede personalizar el proceso de compilación más profundamente si aprovecha:

• Ensamblados que contienen las actividades del flujo de trabajo personalizadas

• Tareas de MSBuild personalizadas

• Marcos de prueba unitaria de terceros en las series de pruebas.

Para habilitar los procesos de compilación para aprovechar estos tipos de código, proteja los binarios en la carpeta (o en cualquiera de las carpetas descendientes) especificadas en el cuadro Ruta de acceso de control de versiones a ensamblados personalizados.Cuando establece o modifica el valor en este cuadro, el servidor de compilación se reinicia automáticamente para cargar los ensamblados.

Sugerencia
Si los resultados de compilación incluyen un mensaje de error TF215097, el proceso de compilación podría incluir una actividad personalizada que no está en esta carpeta ni en ninguna de sus carpetas descendientes.

Para obtener instrucciones acerca de cómo proteger los binarios al control de versiones, vea Aprovechar binarios de terceros que su código no compila.

Especificar el número máximo de compilaciones en ejecución simultánea

En la mayoría de los casos, debería dejar este valor establecido en Usar como predeterminado el número de agentes habilitados.Sin embargo, en algunos casos, puede ser conveniente controlar la profundidad de la cola de compilación.Por ejemplo:

• Observe que demasiadas compilaciones muestran un estado de Activo aún cuando muchas de ellas están paradas mientras esperan a que se les asigne un agente de compilación.Esta situación puede confundir al equipo.Para evitar el problema, seleccione Especifique el máximo y especifique un valor que sea más bajo que el número de agentes de compilación que están agrupados en el controlador de compilación.

• Diseñe una plantilla de compilación personalizada para permitir que las compilaciones aprovechen más de un agente de compilación a la vez, gracias a un conjunto de 12 agentes de compilación en el controlador de compilación.Las compilaciones procesadas por este controlador están basadas en una plantilla de compilación personalizada que delega simultáneamente tres agentes de compilación.Para que los datos de cola de compilación sean más útiles, puede configurar el controlador de compilación con Número máximo de compilaciones en ejecución simultánea establecido en Especifique el máximo, con un valor de 4.

Quitar un controlador de compilación

1. En Visual Studio, abra el cuadro de diálogo Administrar controladores de compilación , como se explica anteriormente en Modificar un controlador de compilación desde Visual Studio.

2. Seleccione y, a continuación, quite cada agente de compilación bajo el controlador de compilación, ya sea mediante Quitar o mediante Propiedades; después use el cuadro de diálogo Propiedades del agente de compilación para asignar el agente de compilación a otro controlador de compilación.

3. Seleccione el controlador de compilación que desee quitar y, a continuación, elija Quitar.

[!NOTA]

También puede usar la Consola de administración de Team Foundation para quitar el controlador de compilación mientras tiene iniciada la sesión en el servidor de compilación.Pero si lo hace, es posible que todavía tenga que utilizar Visual Studio, o iniciar sesión primero en otros servidores de compilación, para quitar cualquier agente de compilación remoto agrupado por el controlador de compilación.

Usar el controlador de compilación hospedado en una colección de proyectos de equipo hospedada en Team Foundation Service

Si la colección de proyectos de equipo se hospeda en Team Foundation Service, es posible que pueda omitir la implementación de su propio controlador de compilación y usar el controlador de compilación hospedado en su lugar.Para usar el Controlador de compilación hospedado, selecciónelo al definir el proceso de compilación.

El controlador de compilación hospedado proporciona un solo agente de compilación temporal estándar.

Para obtener más información acerca de las capacidades del controlador de compilación hospedado, vea Utilizar el controlador de compilación hospedado

Pasos siguientes

• Implementar y configurar los agentes de compilación
  Use un agente de compilación para realizar el trabajo de compilación que usa muchos recursos del procesador.Esto incluye obtener los archivos en el control de versiones, aprovisionar el área de trabajo, compilar el código y ejecutar las pruebas.Puede hospedar uno o más agentes de compilación en un servidor de compilación.

• Configurar carpetas de entrega
  Puede preparar y, a continuación, designar una o más carpetas de entrega para que el sistema de compilación pueda entregar archivos binarios, resultados de pruebas y archivos de registro a su equipo.

• Escalar el sistema de Team Foundation Build
  A medida que el equipo y la base de código aumentan, puede expandir el sistema de compilación de forma incremental con relativa facilidad.

• Administrar el sistema de compilación
  Después de implementar el servidor de compilación, puede administrarlo desde la consola de administración de Team Foundation.Puede administrar el controlador de compilación y los agentes de compilación desde la Consola de administración de Team Foundation o desde Visual Studio.

• Definir el proceso de compilación
  Una vez que el sistema compilado está en contexto, está listo para definir un proceso de compilación con las instrucciones sobre los proyectos de código que se han de compilar, qué acciones desencadenan una compilación, qué pruebas se ejecutan y cualquier otro procedimiento que necesite el equipo.