Implementar y configurar los agentes de compilación

Para usar Team Foundation Build, el equipo debe tener al menos un agente de compilación para realizar el trabajo de compilación que requiere un uso intensivo del procesador.

Cada agente de compilación está dedicado a un único controlador de compilación, que es quien 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 pueden resolver de forma más eficaz con un solo servidor de compilación que hospeda un controlador de compilación que controla agentes de compilación de varios servidores de compilación.

El agente de compilación ejecuta los pasos del proceso de compilación contenidos en la actividad AgentScope. Normalmente, estos pasos incluyen obtener los archivos del control de versiones, aprovisionar el área de trabajo, compilar el código, ejecutar las pruebas y volver a combinar los archivos en 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 el tamaño y la 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 se puede mejorar el rendimiento si se dedica una sola unidad de disco duro física al directorio de trabajo de cada agente de compilación.

Sugerencia
Si la colección de proyectos de equipo se hospeda en Visual Studio Online y las necesidades del equipo se pueden satisfacer mediante un único 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 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 agente de compilación

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

• Especificar el directorio de trabajo

• Habilitar el agente de compilación para ejecutar pruebas

• Asignar etiquetas para representar capacidades o propósitos 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 del 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.

   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.

   En el panel de contenido aparece información sobre el servidor de compilación.

   Si aparece el mensaje Configurar las 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 del 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 de la colección de proyectos de equipo, conéctese al proyecto de equipo.

   2. Elija Página principal y, a continuación, elija 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.

   

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

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

Nombre para mostrar, Descripción: escriba un nombre y una descripción para que los miembros del equipo puedan 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 capacidades

Debe instalar en el agente de compilación la misma versión de Visual Studio que usa el equipo en los equipos de desarrollo. Vea Instalar Visual Studio. También debe instalar cualquier otro software y componentes que estén instalados en los equipos del desarrollo y que sean necesarios para compilar una aplicación.

Especificar el directorio de trabajo

Puede especificar el directorio de trabajo, 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
Se puede mejorar el rendimiento si se dedica una sola unidad de disco duro física al directorio de trabajo de cada agente de compilación.

Usar tokens de directorio de trabajo

Aunque puede especificar una ruta de acceso literal para la propiedad Directorio de trabajo (por ejemplo, c:\temp\build\), es más fácil y duradero utilizar 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 ver las variables de entorno del 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 pueden producir errores y registrar este error: TF10128: The path PhysicalPath 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, puede especificar $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), que produce 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.

Habilitar 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 Comprobar el código usando la automatización de IU).

• 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 capacidades o propósitos del agente de compilación

A medida que vaya creciendo el 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 desde el cuadro de diálogo Propiedades del agente de compilación, que se ha 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 capacidades. Por tanto, es posible que deba 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 desea quitar y elija Quitar.

Sugerencia
También puede usar la consola de administración de Team Foundation para quitar el agente de compilación mientras está conectado al servidor de compilación.

Pasos siguientes

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

• Use el sistema de compilación para compilar, probar e implementar la aplicación
  Una vez establecido el sistema de compilación, el equipo está preparado para crear un proceso de compilación simple (por ejemplo, una compilación de integración continua) y beneficiarse de la compilación y las pruebas automatizadas de la aplicación.