Definir una compilación con la plantilla de actualización

Artículo
08/10/2011

Puede usar la plantilla de actualización para seguir utilizando las definiciones de compilación heredadas en Visual Studio Team Foundation Server 2010. En concreto, puede usar esta plantilla para ejecutar los siguientes tipos de objetos de compilación:

Definiciones de compilación creadas mediante Visual Studio Team System 2008 Team Foundation Server.
Tipos de compilación creados mediante Visual Studio 2005 Team Foundation Server.

Al actualizar por primera vez a Team Foundation Server 2010, el sistema crea automáticamente una definición de compilación de la plantilla de actualización por cada definición de compilación heredada y cada tipo de compilación que se encuentra en el sistema.

Además, cuando se usa una versión anterior de Visual Studio ALM para crear una definición de compilación o un tipo de compilación en un servidor que está ejecutando Team Foundation Server 2010, el sistema crea automáticamente una definición de compilación de la plantilla de actualización.

Para modificar la mayoría de los aspectos de estos objetos de compilación heredados, debe modificar el archivo TFSBuild.proj. Para obtener más información, vea Propiedades, tareas y destinos de Team Foundation Build. Pero puede cambiar algunos valores del objeto de definición de compilación abriendo el nodo Builds en Team Explorer. Estos valores se explican en este tema.

Permisos necesarios

Para realizar este procedimiento, debe tener establecido el permiso Editar definición de compilación en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.

Para modificar una definición de compilación de la plantilla de actualización

En Team Explorer, expanda el proyecto de equipo en el que desea definir la compilación y, a continuación, expanda el nodo Builds.
Haga clic con el botón secundario en la definición de compilación que desea modificar y, a continuación, haga clic en Editar definición de compilación.
En la pestaña Valores predeterminados de compilación, abra el menú Controlador de compilación y, a continuación, seleccione un controlador de compilación.
Haga clic en la pestaña Proceso.
Asegúrese de que Plantilla de actualización aparece en Plantilla de procesos de compilación.
Expanda el nodo Required.
En Ruta de acceso a la carpeta de configuración, asegúrese de que la ruta de acceso a la carpeta que contiene el archivo TFSBuild.proj está especificada correctamente.
Use la información que aparece más adelante en este tema para completar los campos que proporcionan la funcionalidad que desea incluir en esta definición de compilación.
Después de completar los campos de la pestaña Proceso, modifique los campos de las pestañas Desencadenador, Área de trabajo, Valores predeterminados de compilación y Directiva de retención.

Para obtener más información, vea Crear una definición de compilación básica.

En este tema

Parámetros del proceso de compilación de la plantilla de actualización
Especificar el nivel de detalle del registro
Especificar los agentes de compilación que procesan la compilación
Especificar límites de tiempo del agente de compilación
Especificar parámetros avanzados del proceso de compilación

Parámetros del proceso de compilación de la plantilla de actualización

En este tema se explica cómo se modifica una compilación usando los parámetros de proceso de las compilaciones que se basan en la plantilla de actualización. Esta información debería coincidir con Visual Studio Application Lifecycle Management (ALM) siempre que se cumplan las condiciones siguientes:

Está trabajando en un proyecto de equipo que se creó a partir de una de las dos plantillas de proceso incluidas en Visual Studio ALM: MSF for Agile Software Development o v5.0 o MSF for CMMI Process Improvement v5.0.
Ningún miembro del equipo ha quitado o personalizado la plantilla de actualización.

Especificar el nivel de detalle del registro

Para especificar el nivel de detalle del registro que aparece en la ventana de resultados de compilación, expanda el nodo Basic y, a continuación, seleccione un valor en la lista Nivel de detalle de registro. En la tabla siguiente se enumeran los valores de Nivel de detalle de registro y sus efectos correspondientes.

Valor	Errores de compilación	Advertencias de compilación	Mensajes de Compilación Mensajes	Mensajes de compilación Mensajes	Mensajes de compilación Mensajes	Propiedades de actividades de flujo de trabajo (entradas y salidas)
Minimal	Y	N	N	N	N	N
Normal	Y	Y	Y	N	N	N
Detailed	Y	Y	Y	Y	N	N
Diagnóstico	Y	Y	Y	Y	Y	Y

El valor de Nivel de detalle de registro que especifique afectará también al nivel de detalle de los mensajes que proceden de MSBuild. Para obtener más información, vea Referencia de la línea de comandos de MSBuild.

Para obtener más información sobre los informes de compilación, vea Ver la ventana de resultados de la compilación.

Especificar los agentes de compilación que procesan la compilación

Para especificar qué agentes de compilación se usan para procesar la compilación, expanda el nodo Advanced, expanda el nodo Agent Settings y, a continuación, rellene cualquiera de los siguientes cuadros:

Filtro de nombres: puede filtrar los agentes de compilación que se usan para procesar esta definición de compilación escribiendo el nombre del agente en este campo. También puede especificar un conjunto de nombres usando los caracteres comodín * y ?. Por ejemplo, puede escribir CI* para especificar cualquier agente cuyo nombre comience por los caracteres CI. Algunos de los agentes que coinciden con este criterio son CI, CI1 o CI_Agent2.
Filtro de etiquetas: especifique una o varias etiquetas para asegurarse de que esta compilación la ejecutarán únicamente los agentes de compilación que tengan etiquetas que coincidan. Por ejemplo, puede configurar un agente de compilación en una máquina de compilación diseñada para procesar las compilaciones de protección controlada. Puede aplicar la etiqueta "gated" a este agente de compilación. Por último, puede aplicar la etiqueta "gated" a la definición de compilación para que únicamente pueda procesarla el agente que tenga también esta etiqueta. Para especificar etiquetas, haga clic en el botón de puntos suspensivos (...).

Nota

El grupo de agentes de compilación disponibles para procesar esta compilación viene determinado por el controlador de compilación especificado para esta definición de compilación. Para modificar el controlador de compilación, haga clic en la pestaña Valores predeterminados de compilación, abra el menú Controlador de compilación y, a continuación, seleccione un controlador de compilación en ese menú.

Especificar límites de tiempo del agente de compilación

Para especificar los límites de tiempo, expanda el nodo Advanced, expanda el nodo Agent Settings y, a continuación, especifique los siguientes parámetros.

Si desea...	Establezca este parámetro…	Siguiendo estas pautas...
Especificar el tiempo máximo permitido para que el agente de compilación procese la compilación	Tiempo máximo de ejecución	Escriba un intervalo de tiempo con el formato hh:mm:ss. Por ejemplo, se producirá un error de tiempo de espera en la compilación si especifica un valor de 04:30:15 y el agente de compilación no ha completado su trabajo después de 4 horas, 30 minutos y 15 segundos. Especifique el valor 00:00:00 si desea que el agente de compilación tenga tiempo ilimitado para procesar la compilación.
Especificar el tiempo máximo permitido para asignar la solicitud de compilación a un agente de compilación	Tiempo máximo de espera	Escriba un intervalo de tiempo con el formato hh:mm:ss. Por ejemplo, se producirá un error de tiempo de espera en la compilación si especifica un valor de 01:30:45 y la compilación no se asigna a ningún agente de compilación después de 1 hora, 30 minutos y 45 segundos. Especifique el valor 00:00:00 si desea que el controlador de compilación tenga tiempo ilimitado para encontrar un agente de compilación que procese esta definición de compilación.

Especificar parámetros avanzados del proceso de compilación

Para completar correctamente algunos de los escenarios menos habituales, debe modificar los parámetros del proceso de compilación en el nodo Advanced.

Si desea...	Establezca este parámetro…	Siguiendo estas pautas...
Especificar el subdirectorio en el que se encuentran los archivos binarios tras su compilación	Subdirectorio de binarios	Si no especifica ningún subdirectorio, el sistema usará un subdirectorio denominado Binarios.
Usar la definición del tipo de compilación que existe en el equipo local	No descargar tipo de compilación	Establezca esta marca en True si desea usar la definición del tipo de compilación que existe en el equipo local en lugar de descargar la definición de Team Foundation Server. La ruta de acceso local utilizada es el área de trabajo local para el tipo de generación. Por lo general, este parámetro se establece temporalmente en True para que pueda depurarse el archivo TFSBuild.proj.
Generar archivos de registro de errores y advertencias para proyectos individuales	Archivo de registro por proyecto	Establezca este valor en True si desea generar archivos de registro de errores y advertencias para proyectos concretos el lugar de para combinaciones específicas de plataforma y configuración.
Especificar los argumentos de la línea de comandos que se pasan a MSBuild	Argumentos de MSBuild	Si el proceso de compilación requiere que se pasen argumentos a MSBuild, escríbalos en el parámetro Argumentos de MSBuild. Para obtener más información, vea Referencia de la línea de comandos de MSBuild.
Especificar el valor de bits de la versión de MSBuild que se usa para procesar la compilación	Plataforma MSBuild	Especifique uno de los siguientes valores: Especifique Auto si desea ejecutar MSBuild en el mismo valor de bits de CPU de Servicio de Team Foundation Build que está instalada en el agente de compilación. Especifique X86 para procesar siempre esta compilación con la versión de 32 bits de MSBuild. Dado que Visual Studio 2010 se ejecuta como una aplicación de 32 bits, puede experimentar problemas si la compilación la procesa un agente de compilación que está ejecutando la versión de 64 bits de Servicio de Team Foundation Build. Especificar x86 puede resolver este tipo de problemas. Especifique X64 para procesar siempre esta compilación con la versión de 64 bits de MSBuild. Nota Si especifica este valor, debería asegurarse (usando, por ejemplo, una etiqueta como la que se explicó al comienzo de este tema) de que la compilación la procesa un agente de compilación que está hospedado en una máquina de compilación de 64 bits.De lo contrario, la compilación no se realizará correctamente.
Hacer que MSBuild use y obtenga recursivamente los archivos que están en la Ruta de acceso a la carpeta de configuración	Tipo de recursividad	Especifique uno de los siguientes valores: Un nivel si la carpeta especificada en Ruta de acceso a la carpeta de configuración contiene archivos de MSBuild para procesar. Todos si la carpeta especificada en Ruta de acceso a la carpeta de configuración o los subdirectorios de esa carpeta contienen archivos de MSBuild para procesar.
Especificar el subdirectorio que se usa para asignar el área de trabajo y la compilación	Subdirectorio de orígenes	Establezca este valor en el subdirectorio de orígenes apropiado de los agentes de compilación que usan este equipo de compilación. Si no especifica ningún subdirectorio, el sistema usará un subdirectorio denominado Orígenes.
Especificar el subdirectorio que se usa para almacenar los resultados de las pruebas	Subdirectorio de resultados de pruebas	Establezca este valor en el subdirectorio de resultados de pruebas apropiado para los agentes de compilación que usan este equipo de compilación. Si no especifica ningún subdirectorio, el sistema usará un subdirectorio denominado Resultados de pruebas.