Diagnosticar problemas em sua compilação

O diagnóstico e a correção de problemas na compilação são tarefas regulares no desenvolvimento de software. O Team Foundation Build fornece ferramentas para ajudar a depurar e resolver problemas como:

• Compilações com falha ou êxito parcial

• Exceções, erros ou avisos

• Eventos ou resultados inesperados

O que você deseja fazer?

• Determinar por que a compilação não está em execução

• Procure informações sobre um problema na janela de resultados da compilação

• Solicitar e exibir logs de diagnóstico

• Verificar o sistema de compilação e depurar o processo de compilação

• Obter mais dicas

Permissões obrigatórias

Você deve ser um membro do grupo Administradores do Windows no servidor de compilação e um membro do grupo Administradores de Compilação da Coleção do Projeto na coleção de projetos da equipe. Consulte Referência de permissões para o Team Foundation Server.

Determinar por que a compilação não está em execução

Se a compilação for a próxima na fila, mas ainda não estiver sendo executada, verifique se o controlador de compilação e pelo menos um de seus agentes de compilação estão Disponíveis e Habilitados. Se o processo de compilação tiver filtros de agente de compilação, verifique se o agente que atende aos critérios está Disponível ou Habilitado. Consulte Gerenciar seu sistema de compilação, Especificar Quais Agentes de Compilação Processam a Compilação e Implantar e configurar agentes de compilação.

Procure informações sobre um problema na janela de resultados da compilação

Se a compilação estiver em execução, parada em alguma parte do processo ou concluída, você poderá obter mais informações sobre os problemas na janela de resultados da compilação. Escolha Exibir Log para exibir informações mais detalhadas:

• Para ir diretamente aos problemas na compilação, escolha Próximo Erro ou Próximo Aviso.

• Onde quer que você veja instâncias de um link MSBuild Log File, selecione-o para obter informações mais detalhadas sobre eventos ocorridos quando a atividade MSBuild compilou o código e realizou outras tarefas.

• É possível copiar informações e, se quiser, compartilhá-las com pessoas que possam ajudar a resolver os problemas. Selecione passagens específicas no log ou abra um menu de contexto em qualquer lugar do log e, em seguida, escolha Selecionar Tudo. Em seguida, é possível abrir um menu de contexto e escolher Copiar para copiar o texto para a área de transferência.

Exibir logs de diagnóstico

Se ainda não tiver informações suficientes para diagnosticar o problema, você poderá exibir logs de diagnóstico mais detalhados. Na janela de resultados da compilação, escolha Diagnóstico e, em seguida:

• Se a compilação for concluída, escolha Logs finais a partir de date and time.

• Se a compilação ainda não estiver concluída, escolha Solicitar Logs.

  

  O sistema monta os logs.

  Quando os logs estiverem prontos, selecione Diagnóstico, A partir de date and time para User who requested the log.

Se a saída dos estágios da compilação for uma pasta-depósito do caminho UNC, o sistema abrirá uma subpasta da pasta-depósito com os logs de diagnóstico. Depois de abrir a pasta-depósito ou baixar o arquivo .zip, você poderá exibir um dos seguintes logs:

• No controlador de compilação: ActivityLog

• De cada agente de compilação que participou da compilação: **ActivityLog.AgentScope.**Build_Agent_ID

• Para cada solução compilada pela atividade MSBuild: Solution_Name

A melhor maneira de exibir esses logs é copiá-los para o computador de desenvolvimento e abri-los lá.

Dica

Se você estiver usando o Visual Studio 2010, o menu Diagnóstico não será mostrado na janela de resultados da compilação, mas ainda será possível exibir logs de diagnóstico na pasta-depósito quando a compilação é concluída.

Verificar o sistema de compilação e depurar o processo de compilação

Alguns problemas podem ser causados pelo sistema de compilação local.

Dica

Tente implantar o computador de desenvolvimento como um servidor de compilação de forma que seja possível obter acesso direto com mais facilidade ao ambiente no qual o processo de compilação está em execução.Consulte Implantar e configurar um servidor de compilação.

Verificar os componentes do sistema de compilação

Verifique se o servidor, o controlador e o agente de compilação estão configurados corretamente. Consulte Implantar e configurar um servidor de compilação, Implantar e configurar um controlador de compilação e Implantar e configurar agentes de compilação.

Faça logon no servidor de compilação e confirme se ele está funcionando corretamente. Também é possível exibir dados de diagnóstico detalhados no servidor de compilação. Consulte Gerenciar seu sistema de compilação.

Depurar um processo de compilação no servidor de compilação

Para diagnosticar problemas causados pelas atividades do processo de compilação personalizado ou pelas exceções não identificadas, tente depurar o processo de compilação no servidor de compilação.

1. Faça logon no servidor de compilação.

2. Execute o Visual Studio como um administrador.

3. No Visual Studio, na barra de menus, escolha Ferramentas, Anexar ao Processo.

4. Na caixa de diálogo Anexar ao Processo:

   1. Selecione Mostrar processos de todos os usuários.

   2. Selecione TFSBuildServiceHost.exe.

   3. Escolha Anexar.

5. Na barra de menus, escolha Depurar, Exceções. Na caixa de diálogo Exceções, selecione Exceções do Common Language Runtime. Escolha OK.

6. Na barra de menus, escolha Ferramentas, Opções. Na caixa de diálogo Opções, no painel em árvore, selecione Depurando. Na lista Geral, desmarque a caixa de seleção Habilitar Apenas Meu Código. Escolha OK.

7. No Visual Studio, enfileire a compilação e verifique se ela é executada em um controlador de compilação e em um servidor de compilação hospedado no servidor de compilação no qual você habilitou o depurador.

Agora é possível depurar exceções acionadas durante o processo de compilação e também definir pontos de interrupção e depurar as atividades do processo de compilação personalizadas. Consulte Depurando no Visual Studio.

Dicas

• Enquanto estiver diagnosticando problemas com um processo de compilação, você talvez evite problemas para você e seus colegas pausando-o até conseguir reparar o processo:

  • Edite a definição de compilação e, na parte inferior da guia Geral, escolha Em pausa.

  • Para testar as correções no processo de compilação, selecione uma compilação enfileirada, abra o menu de contexto e, em seguida, escolha Iniciar Agora.

• Se achar que um dos componentes do sistema de compilação pode ser a causa de um dos problemas, você poderá iniciar, parar ou reiniciar um servidor de compilação ou habilitar ou desabilitar um controlador ou agente conforme necessário. Consulte Gerenciar seu sistema de compilação.

• Normalmente, ao tentar corrigir problemas do processo de compilação, você precisa enfileirar uma compilação com as mesmas opções repetidamente para testar diversas correções. É possível tentar nova e rapidamente uma compilação:

  • Na janela de resultados da compilação, escolha Ações, Tentar Compilação Novamente.

  • Na página Compilações no Team Explorer ou no Build Explorer, selecionando uma compilação concluída, abrindo o menu de contexto e escolhendo Tentar Compilação Novamente.

• Você está usando o Controlador de Compilação Hospedado? Consulte Usar o Controlador de Compilação Hospedado.