Compartir a través de

Crear y trabajar con agentes de compilación

  • Artículo

Para usar Team Foundation Build, el equipo debe contar al menos con un agente de compilación. Un agente de compilación hace el trabajo que requiere un uso intensivo del procesador de su compilación, lo que incluye recibir archivos del control de versiones, proporcionar el área de trabajo, compilar el código, realizar pruebas y combinar archivos de nuevo en el control de versiones. Cada agente de compilación se dedica a un controlador de compilación único que le controla.

Antes de empezar

  • Debería aprender sobre el rol que los agentes de compilación cumplen en un sistema de compilación, además de las distintas maneras de utilizarlos. Para obtener más información, vea Descripción de Team Foundation Build System.

  • Un agente de compilación se hospeda en una máquina de compilación. Por consiguiente, debe configurar una máquina de compilación antes de poder crear y trabajar con un agente de compilación. Cada equipo de compilación puede hospedar uno o más agentes de compilación. Para obtener más información, vea Configurar una máquina de compilación.

En este tema

  • Permisos necesarios

  • Crear un agente de compilación

  • Modificar un agente de compilación

  • Cuadro de diálogo Propiedades del agente de compilación

    • Obtener más información sobre la propiedad Working Directory

  • Utilizar el agente de compilación para ejecutar pruebas

  • Instalar software adicional

    • Instalar software obligatorio para compilar código

    • Instalar software obligatorio para realizar otras tareas

  • Asignar etiquetas a un agente de compilación

  • Quitar un agente de compilación

Permisos necesarios

Para realizar este procedimiento, debe ser miembro del grupo Administrators en la máquina de compilación y tener el permiso Administrar recursos de compilación establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.

Crear un agente de compilación

Para crear un agente de compilación

  1. Inicie sesión en la máquina de compilación en la que desea crear el agente de compilación.

  2. Haga clic en Inicio, Todos los programas, Microsoft Team Foundation Server 2010 y, por último, en Consola de administración de Team Foundation.

    Aparece la Consola de administración de Team Foundation.

  3. En el recuadro del árbol, expanda el nombre del servidor y, a continuación, haga clic en el nodo Team Foundation Build.

    Aparece información sobre la máquina de compilación en el recuadro del contenido.

    Si no aparece el mensaje Servicio de compilación configurado para…, vea Configurar una máquina de compilación.

  4. Haga clic en Nuevo agente.

    Aparece el cuadro de diálogo Propiedades de agente de compilación. Para obtener más información, vea Propiedades del agente de compilación más adelante en este tema.

  5. Al terminar de modificar las propiedades del agente, haga clic en Aceptar.

  6. Si el vínculo Iniciar aparece justo debajo del nombre del agente de compilación, haga clic en él.

Modificar un agente de compilación

Puede modificar un agente de compilación en una máquina cliente o directamente en la máquina de compilación que hospeda el agente de compilación.

Para modificar un agente de compilación de una máquina cliente

  1. En Visual Studio, abra el menú Compilar y, a continuación, haga clic en Administrar controladores de compilación.

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

  2. Haga clic en el agente de compilación que desee modificar y, a continuación, haga clic en Propiedades.

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

Para modificar un agente de compilación en la máquina de compilación

  1. Inicie sesión en la máquina de compilación que ejecuta el agente de compilación que desea modificar.

  2. Haga clic en Inicio, Todos los programas, Microsoft Team Foundation Server 2010 y, por último, en Consola de administración de Team Foundation.

    Aparece la Consola de administración de Team Foundation.

  3. En el recuadro del árbol, expanda el nombre del servidor y, a continuación, haga clic en el nodo Team Foundation Build.

  4. Justo debajo del nombre del agente de compilación que desee modificar, haga clic en Propiedades.

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

Cuadro de diálogo Propiedades del agente de compilación

En el cuadro de diálogo Propiedades del agente de compilación, puede ver o cambiar el nombre para mostrar y la descripción, además de otras propiedades que afectan al modo en que funciona el agente de compilación.

Nombre para mostrar, Descripción

Proporcione un nombre y una descripción que puedan ayudar a los miembros del equipo a identificar y obtener información importante sobre el agente de compilación de un modo fácil.

Controlador

Especifique el controlador de compilación que desea que controle este agente de compilación. El controlador de compilación se puede ejecutar en la misma máquina de compilación que este agente de compilación o en una máquina diferente.

Nombre del equipo

Este cuadro muestra el nombre de la máquina de compilación que hospeda este agente de compilación.

Directorio de trabajo

Utilice este cuadro para especificar la ruta de acceso al directorio de trabajo. Para obtener más información, vea Obtener más información sobre la propiedad Working Directory.

El servicio Agente de compilación está habilitado

Active esta casilla para permitir que funcione este agente de compilación o desactívela si desea deshabilitarlo y evitar que se le asignen compilaciones.

SugerenciaSugerencia

Es recomendable deshabilitar un agente de compilación cada vez que esté realizando el mantenimiento en la máquina de compilación.

Obtener más información sobre la propiedad Working Directory

El agente de compilación utiliza el directorio de trabajo para operaciones donde el agente debe 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.

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 flexible 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 sobre el entorno para el sistema y el usuario que ha iniciado sesión.

    Por ejemplo, ha configurado Servicio de Team Foundation Build para ejecutarse en una cuenta que se denomina BuildSvcAcct. Especifica $(HomeDrive)\Builds como el directorio de trabajo para un agente de compilación en una máquina de compilación que está ejecutando Windows Server 2008. En consecuencia, el agente de compilación utilizará normalmente, como directorio de trabajo, un directorio físico que se aproxima a la siguiente ubicación: C:\Builds.

    SugerenciaSugerencia

    Para enumerar las variables de entorno en su máquina 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 de un 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 el directorio de trabajo no sea demasiado largo

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 producirán errores y registrarán este error: TF10128: la ruta de accesorutaDeAccesoFísica contiene más de 259 caracteres. Escriba o seleccione una ruta de acceso más corta. Este error puede sorprenderle porque normalmente no puede observar las rutas de acceso físicas que crea el agente de compilación.

Para resolver este problema, puede especificar un directorio de trabajo que tenga una ruta de acceso física más corta. Por ejemplo, puede especificar el siguiente directorio: $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), que produciría un directorio de trabajo que se aproxima a la siguiente ruta de acceso: 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.

Subdirectorio

Se usa para almacenar archivos...

Sources

Leídos por el agente de compilación, como archivos de origen. Los archivos que descarga se especifican en la configuración del Área de trabajo de cada definición de compilación. Para obtener más información, vea Trabajar con áreas de trabajo de compilación.

Binaries

Compilados por el agente de compilación, como archivos de aplicación compilados.

TestResults

Producidos por las pruebas que ejecuta el agente de compilación.

Utilizar el agente de compilación para ejecutar pruebas

Puede diseñar un proceso de compilación que ejecute una o varias ejecuciones de pruebas automatizadas. Como se muestra en la tabla siguiente, algunas clases de pruebas y operaciones de prueba requieren un agente de compilación que cumpla unos requisitos especiales.

Tipo de prueba

Visual Studio 2010 debe estar instalado en el equipo de compilación

Otros requisitos e información

Cobertura de código

Sí

Ninguna

Pruebas de IU codificadas

Sí

El equipo de compilación debe ejecutarse como un proceso interactivo. Para obtener más información sobre cómo configurar este tipo de equipo de compilación, vea Configurar una máquina de compilación.

Para obtener más información sobre estas clases de pruebas, vea Probar la interfaz de usuario con pruebas de IU automatizadas.

Generación de datos de prueba de base de datos

No

Ninguna

Pruebas unitarias de base de datos

Sí

Ninguna

Pruebas genéricas

No

Ninguna

Para obtener más información, vea Crear una prueba automatizada que ejecuta una aplicación ejecutable mediante pruebas genéricas.

Pruebas de carga

Sí

Ninguna

Para obtener más información, vea Configurar la secuencia de la ejecución de pruebas mediante pruebas por orden.

Pruebas unitarias de MSTest

No

Ninguna

Pruebas por orden

No

Ninguna

Análisis de impacto de las pruebas

No

Ninguna

Pruebas web

Sí

Ninguna

Para obtener más información sobre cómo definir un proceso de compilación que ejecute pruebas, vea Usar el sistema de compilación para trabajar con pruebas.

Instalar software adicional

Para que el agente de compilación realice determinadas tareas, es posible que deba instalar software adicional en la máquina de compilación.

Instalar software obligatorio para compilar código

Para que un agente de compilación compile muchos de los proyectos más habituales, no se requiere ningún software adicional. Por ejemplo, sin ningún software adicional instalado, un agente de compilación puede compilar una aplicación WPF básica de Visual C#.

Sin embargo, debe instalar software adicional para compilar otros tipos de proyectos. Por ejemplo, debe instalar Visual Studio para compilar un proyecto de instalación.

Para asegurarse de que el agente de compilación puede compilar sus proyectos

  1. Instale la versión y la edición de Visual Studio que su equipo utiliza en el equipo de compilación en el que se está ejecutando el agente de compilación.

  2. Instale cualquier otro software y componentes que estén instalados en su entorno del desarrollo y que sean necesarios para compilar una aplicación.

Instalar software obligatorio para realizar otras tareas

Para que un agente de compilación realice otras tareas, es posible que sea necesario instalar software adicional en la máquina de compilación. En la siguiente tabla se identifican algunas tareas de agente de compilación comunes y el software necesario para llevar a cabo estas tareas.

Para que el agente de compilación pueda...

Se debe instalar el siguiente software en el equipo del agente de compilación...

Compilar proyectos de aplicación web ASP.NET

Visual Studio 2010

Compilar proyectos de C++

Visual Studio 2010

Asignar etiquetas a un agente de compilación

Al ir creciendo la magnitud de su sistema de compilación, probablemente necesitará 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 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 la misma máquina 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 esa máquina de compilación.

Usar etiquetas para representar funciones del agente 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 las etiquetas siguientes al agente de compilación.

Para identificar a un agente de compilación que puede...

x86

Compilar aplicaciones de 32 bits

x64

Compilar aplicaciones de 64 bits

IIS

Compilar una aplicación web ASP.NET y, a continuación, organizarlo y hospedarlo en la máquina de compilación en la que se está ejecutando el agente de compilación

prueba, esfuerzo

Agente de compilación que se está ejecutando en una máquina de compilación en la que se ha configurado Test Professional 2010 para ejecutar pruebas de carga y esfuerzo.

Usar etiquetas para equilibrar la carga del proceso de compilación

Puede utilizar etiquetas para equilibrar la carga del trabajo de procesamiento de compilación que debe realizar su equipo. Por ejemplo, puede tener una definición de compilación denominada Compilación de protección que valide las protecciones. (Para obtener más información, vea Definir una compilación de entrada validad para validar los cambios). Esta definición de compilación se lleva a cabo a menudo y solo se puede ejecutar una instancia de ella a la vez. Por consiguiente, configure una máquina de compilación que tenga un hardware con un alto rendimiento (como un procesador rápido de varios núcleos y una unidad de disco duro rápida). A continuación, cree un agente de compilación en esa máquina y asígnele la protección de etiqueta. Configure la definición de compilación para que se ejecute solo en un agente de compilación que tenga la etiqueta de protección.

Tiene otra definición de compilación denominada Compilación de seguimiento rápido, que se utiliza para procesar las compilaciones de un proyecto de alta prioridad en el que trabaja un equipo. Configure otro agente de compilación que cumpla los requisitos de ese proyecto especial. Asígnele la etiqueta FastTrack y, a continuación, configure la definición de compilación para que se ejecute solo en un agente de compilación que tenga esa etiqueta.

Para aplicar una etiqueta a un agente de compilación en una máquina cliente

  1. En el menú Compilación, haga clic en Administrar controladores de compilación.

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

  2. Haga clic en el agente de compilación al que desea aplicar una etiqueta y, a continuación, en Propiedades.

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

  3. Use unos de los métodos siguientes para aplicar una o más etiquetas:

    • Seleccione una o más etiquetas de la lista.

    • Haga clic en el vínculo Agregar nueva etiqueta. En el cuadro de diálogo Agregar nueva etiqueta, escriba el nombre de la etiqueta que desea aplicar.

Para aplicar una etiqueta a un agente de compilación en la máquina de compilación

  1. Inicie sesión en la máquina de compilación que ejecuta el agente de compilación que desea modificar.

  2. Haga clic en Inicio, Todos los programas, Microsoft Team Foundation Server 2010 y, por último, en Consola de administración de Team Foundation.

    Aparece la Consola de administración de Team Foundation.

  3. En el recuadro del árbol, expanda el nombre del servidor y, a continuación, haga clic en el nodo Team Foundation Build.

  4. Justo debajo del nombre del agente de compilación, haga clic en Propiedades.

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

  5. Use unos de los métodos siguientes para aplicar una o más etiquetas:

    • Seleccione una o más etiquetas de la lista.

    • Haga clic en el vínculo Agregar nueva etiqueta. En el cuadro de diálogo Agregar nueva etiqueta, escriba el nombre de la etiqueta que desea aplicar.

Quitar un agente de compilación

Puede quitar un agente de compilación mediante una máquina cliente o directamente en la máquina de compilación que hospeda el agente de compilación.

Nota: Al quitar el agente de compilación, no se desinstala Servicio de Team Foundation Build de la máquina de compilación.

Para quitar un agente de compilación mediante una máquina cliente

  1. En el menú Compilación, haga clic en Administrar controladores de compilación.

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

  2. Haga clic en el controlador de compilación o en el agente de compilación que desea quitar y, a continuación, haga clic en Eliminar.

Para quitar un agente de compilación de la máquina de compilación

  1. Inicie sesión en la máquina de compilación que ejecuta el agente de compilación que desea modificar.

  2. Haga clic en Inicio, Todos los programas, Microsoft Team Foundation Server 2010 y, por último, en Consola de administración de Team Foundation.

    Aparece la Consola de administración de Team Foundation.

  3. En el recuadro del árbol, expanda el nombre del servidor y, a continuación, haga clic en el nodo Team Foundation Build.

  4. Justo debajo del nombre del agente de compilación, haga clic en Eliminar.

Vea también

Otros recursos

Definir el proceso de compilación

Historial de cambios

Fecha

Historial

Motivo

Mayo de 2011

Se ha añadido información sobre cómo ejecutar pruebas.

Mejora de la información.