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 que hace más uso del procesador al conjunto de agentes de compilación.

Un sistema de una sola máquina (independiente)

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 AgentScope para delegar el trabajo que requiere un uso intensivo del procesador (como compilar código o ejecutar pruebas) a 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 distinto.

Dado que un controlador de compilación no suele requerir gran cantidad de tiempo de procesador, en muchos casos puede hospedarlo en el mismo equipo que Team Foundation Server, como se muestra anteriormente, o en un equipo virtual o físico de bajo consumo.

Sin embargo, un controlador de compilación puede exigir una cantidad de memoria significativa en algunas situaciones, por lo que debe proporcionar memoria suficiente para garantizar un funcionamiento correcto. Como alternativa, en función de las necesidades y recursos del equipo, puede que desee ejecutar el controlador de compilación en un equipo distinto de Team Foundation Server.

Dos servidores de compilación

Permisos necesarios

Debe ser miembro del grupo Administradores de Windows en el servidor de compilación y del grupo Administradores de compilación de la colección de proyectos en la colección de proyectos de equipo. Vea Referencia de permisos para Team Foundation Server.

¿Qué desea hacer?

  • Crear o modificar un controlador de compilación.

  • Permitir que los procesos de compilación aprovechen los binarios complementarios.

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

  • Quitar un controlador de compilación

  • Usar un controlador de compilación con una colección de proyectos de equipo que se hospeda en Visual Studio Online.

Crear o modificar un controlador de compilación.

Para crear o modificar un controlador de compilación del 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.

  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 las características instaladasConfigurar las 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:

      Controlador de compilación

      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 de la colección de proyectos de equipo, conéctese al proyecto de equipo.

    2. Elija Icono de inicio Página principal y, a continuación, elija Icono de compilaciones Compilaciones.

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

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

    Cuadro de diálogo Administrar controladores de compilación

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

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

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 ayuden a los miembros del equipo a identificar fácilmente el controlador de compilación adecuado cuando definan los procesos de compilación.

Consulte 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 aprovechen los binarios complementarios.

Puede habilitar el proceso de compilación para usar los archivos binarios que ha cargado en Team Foundation Server; por ejemplo:

Para habilitar los procesos de compilación de forma que aprovechen estos tipos de código, cargue los archivos 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. Al establecer un valor en este cuadro o modificarlo, el servidor de compilación se reinicia automáticamente para cargar los ensamblados.

Sugerencia

Si los resultados de la compilación incluyen un mensaje de error TF215097, puede que el proceso de compilación incluya una actividad personalizada que no se encuentra en esta carpeta ni en ninguna de sus carpetas descendientes.

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

En la mayoría de los casos, debe dejar este valor establecido en Usar como predeterminado el número de agentes habilitados. Sin embargo, en algunas ocasiones, puede que desee controlar la profundidad de la cola de compilación. Por ejemplo:

  • Se observa que demasiadas compilaciones muestran el estado En ejecución, aun cuando muchas de ellas están paradas en espera de 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 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, a partir de un conjunto de 12 agentes de compilación en el controlador de compilación. Las compilaciones procesadas por este controlador de compilación se basan en una plantilla de compilación personalizada que delega simultáneamente en tres agentes de compilación. Para que los datos de la cola de compilación sean más útiles, puede configurar el controlador de compilación con la opción Número máximo de compilaciones en ejecución simultánea establecida 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 la sección para modificar un controlador de compilación desde Visual Studio.

  2. Seleccione y después quite todos los agentes de compilación bajo el controlador de compilación, ya sea eligiendo Quitar o Propiedades y usando a continuación 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 desea quitar y elija Quitar.

Nota

También puede usar la consola de administración de Team Foundation para quitar el controlador de compilación mientras está conectado al servidor de compilación.Sin embargo, en este caso, puede que también tenga que usar 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 un controlador de compilación con una colección de proyectos de equipo que se hospeda en Visual Studio Online.

Usar el controlador de compilación hospedado: si la colección de proyectos de equipo se hospeda en Visual Studio Online, es posible que pueda omitir la implementación de su propio controlador de compilación y usar en su lugar el controlador de compilación hospedado. Para usar el Controlador de compilación hospedado, solo tiene que seleccionarlo al definir el proceso de compilación. Vea Usar el controlador de compilación hospedado.

Usar un controlador de compilación local: si el proceso de compilación requiere otros recursos aparte de las capacidades del controlador de compilación hospedado, puede conectar el controlador de compilación local a la colección de proyectos de equipo hospedada.

Team Foundation Service, Servidor de compilación local

Pasos siguientes

  • Implementar y configurar agentes de compilación
    Use un agente de compilación para realizar el trabajo de compilación que requiere un uso intensivo del procesador. Este incluye recibir archivos del control de versiones, proporcionar el área de trabajo, compilar el código y realizar 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 al equipo.

  • Escalar el sistema de Team Foundation Build
    A medida que el equipo y la base de código crezcan, puede ampliar 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 implementado el sistema de compilación, estará listo para definir el 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.