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.
.png "Dos servidores de compilación")
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.
.gif "Sugerencia") 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
Inicie sesión en el servidor de compilación que desea configurar.
Desde Inicio de Windows, ejecute Consola de administración de Team Foundation Server.
Aparece la Consola de administración de Team Foundation.
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
.png "Configurar las características instaladas")
Configurar características instaladas, vea Implementar un servidor de compilación.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
.png "Agente de compilación")
elija Propiedades.
Aparece el cuadro de diálogo Propiedades de agente de compilación.
Para modificar un agente de compilación desde Visual Studio
En Visual Studio, en Team Explorer:
Si aún no está conectado a un proyecto de equipo en el proyecto de equipo, conéctese al mismo.
Elija
.png "Icono de inicio")
Inicio y luego elija .png "Icono de compilaciones")
Compilaciones.
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.
.png "Cuadro de diálogo Administrar controladores de compilación")
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.
.png "Cuadro de diálogo Propiedades del 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. |
.gif "Bb399135.collapse_all(es-es,VS.110).gif")
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.SugerenciaPara 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.
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.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. |
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.
.gif "Nota importante") 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 la etiqueta siguiente… |
Para identificar a un agente de compilación que puede… |
|---|---|
x86 |
Compilar aplicaciones de 32 bits |
x64 |
Compilar aplicaciones de 64 bits |
bvt |
Ejecutar las pruebas de BVT, ejecutadas por la compilación nocturna de BVT. |
WindowsStore |
|
IIS |
Compilar una aplicación web ASP.NET y, a continuación, organizarla y hospedarla en el equipo en el que se está ejecutando el agente de compilación. |
interactivo |
Realizar las tareas que requieren un agente en un servidor de compilación que se ejecuta en modo interactivo. |
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
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.
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.