Diagnosticar problemas de la compilación

El diagnóstico y la corrección de problemas de compilación son tareas frecuentes en el desarrollo de software. Team Foundation Build dispone de herramientas que le ayudarán a depurar y a resolver problemas tales como:

• Compilaciones con error o parcialmente correctas

• Excepciones, errores o advertencias

• Eventos o resultados inesperados

¿Qué desea hacer?

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

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

• Solicitar y ver registros de diagnóstico

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

• Obtener más sugerencias

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.

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

Si la compilación es la siguiente de la cola, pero aún no se está ejecutando, asegúrese de que el controlador de compilación y al menos uno de sus agentes de compilación esté disponible y habilitado. Si el proceso de compilación tiene filtros de agente de compilación, asegúrese de que esté disponible y habilitado un agente de compilación que cumpla los criterios. Vea Administrar el sistema de compilación, Especificar los agentes de compilación que procesan la compilación y Implementar y configurar los agentes de compilación.

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

Si la compilación se está ejecutando, está bloqueada en una parte del proceso o se ha completado, puede obtener más información sobre los problemas en la ventana de resultados de la compilación. Elija Ver registro para mostrar información más detallada:

• Para pasar directamente a los problemas de la compilación, elija Error siguiente o Advertencia siguiente.

• Siempre que vea instancias de un vínculo Archivo de registro de MSBuild, elíjalo para obtener información más detallada acerca de los eventos que se produjeron cuando la actividad MSBuild compiló el código y llevó a cabo otras tareas.

• Puede copiar la información y, si lo desea, compartirla con personas que puedan ayudarle a resolver los problemas. Seleccione fragmentos concretos en el registro o abra un menú contextual desde cualquier parte del registro y elija Seleccionar todo. Puede abrir un menú contextual y elegir Copiar para copiar el texto en el Portapapeles.

Ver registros de diagnóstico

Si aún no tiene información suficiente para diagnosticar el problema, puede ver registros de diagnóstico más detallados. En la ventana de resultados de la compilación, elija Diagnósticosy, a continuación:

• Si la compilación está completada, elija Registros finales a partir de date and time.

• Si la compilación no se ha completado aún, elija Solicitar registros.

  

  El sistema ensambla los registros.

  Cuando los registros estén listos, elija Diagnósticos, A partir de date and time para User who requested the log.

Si la compilación organiza los resultados en una carpeta de entrega en una ruta de acceso UNC, el sistema abre una subcarpeta de dicha carpeta que contiene los registros de diagnóstico. Después de abrir la carpeta de entrega o descargar el archivo .zip, verá uno de los registros siguientes:

• Desde el controlador de compilación: ActivityLog

• Desde cada agente de compilación que ha participado en la compilación: **ActivityLog.AgentScope.**Build_Agent_ID

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

La mejor manera de ver estos registros es copiándolos en el equipo de desarrollado y abriéndolos desde allí.

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

Algunos problemas pueden tener su origen en el sistema de compilación local.

Comprobar los componentes del sistema de compilación

Asegúrese de que el servidor, el controlador y el agente de compilación estén configurados correctamente. Vea Implementar y configurar un servidor de compilación, Implementar y configurar un controlador de compilación y Implementar y configurar los 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 Administrar el sistema de compilación.

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

Para diagnosticar problemas ocasionados por las actividades del proceso de compilación personalizado, o por excepciones no detectadas, 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, en la barra de menús, 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. Seleccione TFSBuildServiceHost.exe.

   3. Elija Asociar.

5. En la barra de menús, elija Depurar, 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, desactive la casilla Habilitar Solo mi código. Elija Aceptar.

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

Ahora puede depurar excepciones producidas durante el proceso de compilación y también establecer puntos de interrupción y depurar las actividades de proceso de compilación personalizadas. Vea Depurar en Visual Studio.

Sugerencias

• Mientras diagnostica problemas con el proceso de compilación, se evitará problemas, tanto a usted como a sus compañeros de equipo, si lo detiene hasta que pueda reparar el proceso:

  • Edite la definición de la compilación y, en la parte inferior de la pestaña General, elija En pausa.

  • Para probar las correcciones del proceso de compilación, seleccione una compilación en cola, abra el menú contextual y elija Iniciar ahora.

• Si cree que 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 bien habilitar o deshabilitar un controlador o un agente según sea necesario. Vea Administrar el sistema de compilación.

• Con frecuencia, al intentar corregir problemas de los procesos de compilación, es necesario poner en cola una compilación con las mismas opciones de forma repetida para probar varias correcciones. Puede reintentar rápidamente una compilación:

  • En la ventana de resultados de la compilación: elija Acciones, Reintentar compilación.

  • En la página Compilaciones de Team Explorer o en Build Explorer: seleccione una compilación completada, abra el menú contextual y elija Reintentar compilación.

• ¿Va a usar el controlador de compilación hospedado? Vea Usar el controlador de compilación hospedado.