Implementar y configurar agentes de compilación

Para usar Team Foundation Build, el equipo debe tener al menos un agente de compilación para realizar el trabajo del proceso de compilación, que usa muchos recursos del procesador.

Cada agente de compilación se dedica a un controlador de compilación único y lo controla.Los agentes de compilación se pueden hospedar en el mismo servidor de compilación que hospeda su controlador de compilación, pero no es necesario, y en algunos casos las necesidades del equipo se puede resolver de forma más eficaz por un solo servidor de compilación para hospedar un controlador de compilación que controla los agentes de compilación en varios servidores de compilación.

El agente de compilación ejecuta los pasos del proceso de compilación contenidos en la actividad de AgentScope.Normalmente, estos pasos incluyen obtener los archivos de control de versiones, aprovisionar el área de trabajo, compilar el código, ejecutar las pruebas y combinar archivos de nuevo con el control de versiones.

Asegúrese de que el servidor de compilación que hospeda los agentes de compilación tiene suficientes capacidades de almacenamiento y procesamiento para que coincida con el tamaño y complejidad del código base y las pruebas de la colección de proyectos de equipo.Normalmente, no se debe hospedar más de un agente de compilación por cada núcleo de procesador en el servidor de compilación.También puede mejorar el rendimiento si dedica un solo disco duro físico al directorio de trabajo de cada agente de compilación.

Sugerencia
Si la colección de proyectos de equipo se hospeda en Team Foundation Service y las necesidades del equipo se pueden cumplir por un solo agente de compilación estándar, puede utilizar el controlador de compilación hospedado en lugar de implementar su propio agente de compilación.

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 agente de compilación

• Instalar Visual Studio y otro software para habilitar la compilación y otras funciones

• Especificar el directorio de trabajo

• Habilite el agente de compilación para ejecutar pruebas

• Asignar etiquetas para representar funciones o vistas del agente de compilación

• Implementar un agente de compilación que puede compilar y probar una aplicación de la Tienda Windows

• Quitar un agente de compilación

Crear o modificar un agente de compilación

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

1. Inicie sesión en el servidor de compilación que desea configurar.

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

   Aparece la 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 .

   Aparece el servidor de compilación en el panel de contenido.

   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:

   • Para crear un nuevo agente de compilación, elija Nuevo agente.

   • Para modificar un agente de compilación existente

     

     elija Propiedades.

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

Para modificar un agente 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 agente de compilación que desee modificar y, a continuación, elija Propiedades.

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

Nombre para mostrar, Descripción: escriba un nombre y una descripción para ayudar a los miembros del equipo a identificar fácilmente el agente de compilación.

Controlador: seleccione el controlador de compilación que desea que controle este agente de compilación.El controlador de compilación se puede ejecutar en el mismo servidor de compilación que este agente de compilación o en un servidor diferente.

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

Instalar Visual Studio y otro software para habilitar la compilación y otras funciones

Una práctica recomendada consiste en instalar en el agente de compilación la versión de Visual Studio que el equipo usa en sus equipos de desarrollo.Vea Instalar Visual Studio.Debería también instalar cualquier otro software y componentes que estén instalados en su entorno del desarrollo y que sean necesarios para compilar una aplicación.De lo contrario, podría tener problemas, por ejemplo, que algunos de los proyectos de código no puedan compilarse.

Especificar el directorio de trabajo

Puede especificar el directorio de trabajo, de que el agente de compilación usa para leer o escribir en archivos.Por ejemplo, los archivos de origen se copian en los subdirectorios de esta carpeta y se crean y almacenan binarios en otros subdirectorios de esta carpeta.

Sugerencia
Puede mejorar el rendimiento si dedica un solo disco duro físico al directorio de trabajo de cada agente de compilación.

Usar tokens del directorio de trabajo

Aunque puede especificar una ruta de acceso literal para la propiedad Working Directory (por ejemplo, c:\temp\build\), un enfoque más simple y duradero es utilizar los tokens para especificar la ruta de acceso.Puede utilizar dos tipos de tokens:

• Variables de entorno
  Las variables de entorno contienen información acerca del entorno para el sistema y el usuario que ha iniciado sesión.La variable más típica que puede usar es SYSTEMDRIVE, pero en algunos casos puede usar también variables como USERNAME o HOMEPATH.

  Sugerencia
  Para enumerar las variables de entorno en el servidor de compilación, abra un símbolo del sistema y escriba set.

• Variables de Team Foundation Build
  Puede utilizar las siguientes variables en un directorio de trabajo del agente de compilación:

  • $(BuildAgentId): entero generado automáticamente que identifica de forma exclusiva un agente de compilación dentro de una colección de proyectos de equipo.

  • $(BuildAgentName): Nombre para mostrar del agente de compilación.

  • $(BuildDefinitionId): entero generado automáticamente que identifica de forma exclusiva una definición de compilación dentro de una colección de proyectos de equipo.

  • $(BuildDefinitionPath): nombre del proyecto de equipo y nombre de la definición de compilación, separados por una barra diagonal inversa.

Ejemplo de directorio de trabajo

Por ejemplo, tiene un agente de compilación que se denomina BuildBot3.Ha definido dos compilaciones que se denominan NightlyBuild y WeeklyBuild en un proyecto de equipo que se denomina CoolApp.En el cuadro Directorio de trabajo, especifique el siguiente valor: $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath).En consecuencia, el agente de compilación de BuildBot3 crea y utiliza los dos directorios de trabajo siguientes:

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Asegúrese de que la ruta de acceso al directorio de trabajo no sea demasiado larga

El directorio de trabajo que especifica no debe hacer que el agente de compilación genere rutas de acceso físicas que tengan más de 259 caracteres.De lo contrario, las compilaciones podrían producir errores y registrar este error: TF10128: The pathPhysicalPath contains more than the allowed 259 characters. Type or select a shorter path.

Para resolver este problema, especifique un directorio de trabajo que tenga una ruta de acceso física más corta.Por ejemplo podría especificar $ (HOMEDRIVE) \bld\$(BuildAgentID)\$(BuildDefinitionID), que produciría un directorio de trabajo como: c:\bld\3\2\.

Subdirectorios creados en el directorio de trabajo

El agente de compilación crea y funciona en los siguientes subdirectorios en esta ruta de acceso.

Habilite el agente de compilación para ejecutar pruebas

Puede definir un proceso de compilación que ejecute una o varias series de pruebas automatizadas.

Importante
Muchas clases de pruebas y operaciones de prueba requieren que se instale en el agente de compilación la misma versión de Visual Studio que el equipo usa en los equipos de desarrollo.Vea Instalar Visual Studio.

El agente de compilación puede ejecutar:

• Cobertura de código

• Pruebas de IU codificadas (requiere un servidor de compilación que se está ejecutando en modo interactivo.Vea Ejecutar el servidor de compilación en modo interactivo y Probar la interfaz de usuario con pruebas de IU codificadas).

• Generación de datos de prueba de base de datos

• Pruebas unitarias de base de datos

• Pruebas genéricas

• Pruebas de carga

• Pruebas unitarias

• Pruebas por orden

• Análisis de impacto de las pruebas

• Pruebas web

Asignar etiquetas para representar funciones o vistas del agente de compilación

Al ir creciendo la magnitud de su sistema de compilación, es posible que necesite definir agentes de compilación especializados.Siempre que un agente de compilación tenga capacidades especiales o esté pensado para un tipo de uso concreto, debería asignar una o más etiquetas a ese agente.De esta manera, cuando un miembro del equipo crea una definición de compilación que requiere cierto tipo de agente de compilación, pueden especificar la etiqueta en su definición de compilación.

Puede asignar etiquetas en el cuadro de diálogo Propiedades del agente de compilación, descrito anteriormente.A continuación puede aplicar las etiquetas a las definiciones de compilación.

En la siguiente tabla se proporcionan ejemplos de nombres de etiqueta y las funciones del agente de compilación que podrían representar.

Puede aplicar más de una etiqueta a un agente de compilación.Por ejemplo, puede crear un agente de compilación con las etiquetas x86 y Versión para indicar a un agente que está configurado para compilar la configuración de la versión de una aplicación de 32 bits.

Si ejecuta varios agentes de compilación en el mismo servidor de compilación, probablemente tengan todos las mismas funciones.Por consiguiente, es posible que desee aplicar las mismas etiquetas a todos los agentes de compilación de ese servidor de compilación.

Quitar un agente de compilación

1. En Visual Studio, abra el cuadro de diálogo Administrar controladores de compilación , como se explicó anteriormente en Crear o modificar un agente de compilación.

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

Sugerencia
También puede usar la Consola de administración de Team Foundation para quitar el agente de compilación mientras tiene iniciada la sesión en el servidor de compilación.

Pasos siguientes

• 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
  De vez en cuando, deberá supervisar y administrar el sistema de compilación.

• Use el sistema de compilación para compilar, probar e implementar la aplicación
  Después de que el sistema de compilación esté listo, su equipo está preparado para crear un proceso de compilación simple (por ejemplo, compilación de integración continua) y beneficiarse de la compilación y prueba automatizada de la aplicación.