Diagnosticar problemas de compilación

El diagnóstico y corregir de los problemas de compilación es una tarea regular en el desarrollo de software.Team Foundation proporciona herramientas para ayudarle a diagnosticar y resolver problemas como:

• Compilaciones correctas o parcialmente correctas

• Excepciones, errores, advertencias o

• Eventos o resultados inesperados

¿Qué desea hacer?

• Determine por qué una compilación no se está ejecutando

• Busque información sobre un problema en la ventana de resultados de compilación

• Resolver problemas al utilizar el controlador hospedado de compilación

• Solicite y ver los registros de diagnóstico

  • Recopilar registros de diagnóstico cuando se utiliza un controlador local de compilación

  • Recopilar registros de diagnóstico cuando se utiliza el controlador hospedado de compilación

  • Vea los registros de diagnóstico

• Compruebe el sistema de compilación y depurar el proceso de compilación

• Obtenga más sugerencias

Permisos necesarios

Debe ser miembro del grupo Administradores de Windows en el servidor de compilación, y un miembro de la colección de proyectos genera el grupo Administradores en la colección de proyectos de equipo.Vea Permisos de Team Foundation Server.

Determine por qué una compilación no se está ejecutando

Si la compilación es en la cola siguiente pero aún no se está ejecutando, asegúrese de que el controlador de compilación y al menos el de los agentes de compilación están disponibles y habilitado.Si el proceso de compilación ha compilado los filtros del agente, asegúrese de que un agente de compilación que cumpla los criterios está disponible y habilitado.Vea Manage Your Build System, Especificar los agentes de compilación que procesan la compilación, y Implementar y configurar agentes de compilación.

Busque información sobre un problema en la ventana de resultados de compilación

Si la compilación se está ejecutando, bloqueado en alguna parte del proceso, o completada, puede obtener más información sobre los problemas en compile la ventana de resultados.Elija ver registro para mostrar información más detallada:

• Elija Error siguiente o Advertencia siguiente para omitir directamente a problemas en la compilación.

• Siempre que se vea las instancias Archivo de registro de MSBuild se vinculan, elija para obtener información más detallada sobre los eventos que se produjeron cuando la actividad de MSBuild compiló el código y realiza otras tareas.

• Puede copiar la información y, si lo desea, compartirla con las personas que pueden ayudarle a resolver los problemas.Seleccionar los pasos concretos en el registro o abra un menú contextual desde cualquier parte del registro y después elija Seleccionar todo.Puede abrir un menú contextual y elegir copiar para copiar el texto en el portapapeles.

Registros de diagnóstico de vista

Si todavía no tiene bastante información para diagnosticar el problema, puede ver registros de diagnóstico más detallada.

Recopilar registros de diagnóstico cuando se utiliza un controlador local de compilación

Al hospedar un controlador local de la compilación, los registros de diagnóstico almacenan en carpeta de entrega.En ventana de resultados de la compilación, elija diagnósticos y, a continuación:

• Si se completa la compilación, elija Registros finales a partir de fecha y hora.

• Si la compilación no se completa, elija Solicitar registros.

  

  El sistema ensambla los registros.

  Cuando los registros están listos, elija diagnósticos, A partir de fecha y hora para Usuario que solicita el registro.

El sistema abre una sub- carpeta de la carpeta de entrega que contiene los registros de diagnóstico.

[!NOTA]

Si usa Visual Studio 2010, el menú diagnósticos no se muestra en la ventana de resultados de compilación, pero puede ver el diagnóstico iniciado sesión la carpeta de entrega cuando se completa la compilación.

Recopilar registros de diagnóstico cuando se utiliza el controlador hospedado de compilación

Cuando se utiliza Controlador hospedado de compilación, se recomienda seleccionar Copiar la salida de la compilación en el servidor para ubicación provisional.En este caso, los registros de diagnóstico se almacenan en TFS y puede verlo y descargarlo del explorador web.

En ventana de resultados de la compilación, elija Acciones, Abrir en el explorador y, en los resultados de la compilación en el explorador web, elija diagnósticos.Puede elegir Ver registros para abrir un menú de que puede elegir el registro que desea ver, o descargar todo el abre un archivo .zip.

Vea los registros de diagnóstico

Después de abrir la carpeta de entrega o descargue el archivo .zip, puede ver uno de los siguientes registros:

• Controlador de compilación: ActivityLog

• De cada agente que participó en la compilación: **ActivityLog.AgentScope.**Build_Agent_ID

• Para cada solución compilada por la actividad de MSBuild : Solution_Name

La mejor manera de ver estos registros es copiarlos al equipo dev y abrirlos desde allí.

Compruebe el sistema de compilación y depurar el proceso de compilación

Algunos problemas pueden deberse al sistema local de la compilación.

Sugerencia
Intente implementar el equipo dev como servidor de compilación para poder más fácilmente obtener acceso directo al entorno en el que el proceso de compilación se ejecuta.Vea Implementar y configurar un servidor de compilación.

Compruebe los componentes del sistema de compilación

Asegúrese de que el servidor esté configurado, el controlador, y el agente de compilación correctamente.Vea Implementar y configurar un servidor de compilación, Implementar y configurar un controlador de compilación y Implementar y configurar agentes de compilación.

Inicie sesión en el servidor de compilación y confirme que funciona correctamente.También puede ver datos de diagnóstico detallados en el servidor de compilación.Vea Manage Your Build System.

Depurar un proceso de compilación en el servidor de compilación

Para diagnosticar los problemas producidos por las actividades de proceso de compilación personalizado, o por excepciones de no detectada, intente depurar el proceso de compilación en el servidor de compilación.

1. Inicie sesión en el servidor de compilación.

2. Ejecute Visual Studio como administrador.

3. En Visual Studio, la barra de menú, elija herramientas, Asociar al proceso.

4. En el cuadro de diálogo Asociar al proceso:

   1. Seleccione Mostrar los procesos de todos los usuarios.

   2. TFSBuildServiceHost.exe seleccione.

   3. Elija Asociar.

5. En la barra de menús elija debug, Excepciones.En el cuadro de diálogo Excepciones, seleccione Excepciones de Common Language Runtime.Elija Aceptar.

6. En la barra de menús, elija herramientas, opciones.En el cuadro de diálogo opciones, en el panel de árbol, seleccione Depuración.En la lista General, y desactive la casilla Habilitar Solo mi código.Elija Aceptar.

7. En Visual Studio, cola la compilación y asegúrese de que se ejecute en un controlador de compilación y un servidor de compilación hospedados en el servidor de compilación en el que ha habilitado el depurador.

Ahora puede depurar las excepciones que se producen durante el proceso de compilación, y también establece los puntos de interrupción y depurar actividades personalizadas del proceso de compilación.Vea Depurar en Visual Studio.

Sugerencias

• Mientras está diagnosticar los problemas con un proceso de compilación, puede que se guarde y los problemas de los compañeros de equipo pausando él hasta que pueda reparar el proceso:

  • Modifique la definición de compilación y, en la parte inferior de la ficha General, elija En pausa.

  • Cuando se pausa la definición de compilación, para probar las correcciones en el proceso de compilación, seleccione compilación en cola, abra el menú contextual, y elija Iniciar ahora.

• Si piensa uno de los componentes del sistema de compilación podría ser la causa de uno de los problemas, puede iniciar, detener, o reiniciar un servidor de compilación o habilitar o deshabilitar un controlador o agente según sea necesario.Vea Manage Your Build System.

• Con frecuencia, mientras intenta corregir los problemas del proceso de compilación, necesitará la cola una compilación con las mismas opciones de probar repetidamente diferentes correcciones.Puede reintentar rápidamente una compilación:

  • De ventana de resultados de la compilación eligiendo Acciones, Reintentar compilación.

  • De Compilar la página en Team explorer o el Explorador compila seleccionando una compilación completada, abrir el menú contextual, y elija Reintentar compilación.