Diagnosticar problemas de compilação

Artigo
02/25/2013

Diagnosticar e corrigir problemas de compilação são uma tarefa comum na programação de software.O team foundation build fornece ferramentas para ajudá-lo a diagnosticar e resolver problemas como:

Compilações que falharam ou parcialmente com êxito
Exceções, erros ou avisos,
Eventos ou resultados inesperados

O que você deseja fazer?

Determinar como uma compilação não estiver sendo executado
Procure informações sobre um problema na janela de resultados de compilação
Resolver problemas ao usar o controlador de compilação hospedado
Parte e exibr logs diagnóstico
- Obter logs diagnóstico quando você estiver usando um controlador de compilação de em- locais
- Obter logs diagnóstico quando você estiver usando o controlador de compilação hospedado
- Exibir os logs diagnóstico
Verifique o sistema de compilação e depurar o processo de compilação
Obter dicas

Permissões exigidas

Você deve ser um membro do grupo administradores do Windows no servidor de compilação, e um membro do grupo administradores de compilação de coleção de Projeto de sua coleção de projeto de equipe.Consulte Team Foundation Permissões do servidor.

Determinar como uma compilação não estiver sendo executado

Se a compilação for na fila seguir mas ainda não estiver sendo executado, certifique-se que o controlador de compilação e pelo menos o de seus agentes de compilação estão disponíveis e ativados.Se seu processo de compilação tem filtros do agente de compilação, certifique-se que um agente de compilação encontrar os critérios está disponível e ativado.Consulte Manage Your Build System, Especificar que processam sua agentes de compilação, e Implantar e configurar agentes de compilação.

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

Se a compilação estiver sendo executado, colado em alguma parte do processo, ou concluído, então você pode obter mais informações sobre problemas em compile a janela de resultados.Escolha Exibir Log para exibir informações mais detalhadas:

Escolha Próximo erro ou Aviso seguinte para ir diretamente a problemas na compilação.
Onde quer que você vê instâncias de um link MSBuild Log File, escolha para obter informações mais detalhadas sobre eventos que ocorreram enquanto a atividade MSBuild compilou seu código e executou outras tarefas.
Você pode copiar a informações e, se desejar, compartilhar com pessoas que podem ajudar a resolver problemas.Selecione passa específicas no log ou abrir um menu de atalho em qualquer lugar dentro do log e então escolha Selecionar Tudo.Você pode abrir um menu de atalho e escolha Copiar para copiar o texto na área de transferência.

Logs diagnóstico de exibição

Se você ainda não tem informações suficientes para diagnosticar o problema, você pode exibir um logs diagnóstico mais detalhados.

Obter logs diagnóstico quando você estiver usando um controlador de compilação de em- locais

Quando você hospeda os em- locais ao controlador, os logs diagnóstico são armazenados em pasta-depósito.Em a janela resultados de compilação, escolha Diagnóstico, e então:

Se a compilação for concluída, escolha Logs do final até a data de data e hora.
Se a compilação for concluída ainda não, escolha Parte logs.

O sistema monta os logs.

Quando os logs estão prontos, escolha Diagnóstico, Até a data de data e hora para O usuário que solicitou o log.

O sistema abre uma pasta de subpropriedades pasta-depósito que contém os logs diagnóstico.

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

Obter logs diagnóstico quando você estiver usando o controlador de compilação hospedado

Quando você usa Controlador de compilação hospedado, recomendamos que você selecionar Saída de compilação de impressão para o servidor para local de teste.Nesse caso, os logs diagnóstico são armazenados em TFS e você pode exibi-lo e baixá-lo de seu web browser.

Em a janela resultados de compilação, escolha Ações, Abrir no Navegador, e então nos resultados de compilação web no navegador, escolha diagnóstico.Você pode então escolha Exibir Logs para abrir um menu de que você pode escolher o log que você deseja exibir, ou para baixar qualquer insere um arquivo .zip.

Exibir os logs diagnóstico

Depois de abrir a pasta-depósito ou download do arquivo .zip, você pode exibir um dos seguintes logs:

O controlador de compilação: ActivityLog
De cada agente de compilação que participou na compilação: **ActivityLog.AgentScope.**Build_Agent_ID
Para cada solução criada pela atividade de MSBuild : Solution_Name

A melhor maneira de exibir esses logs é copie-os para seu computador de dev e abri-los de lá.

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

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

Dica
Tente implantar seu computador de dev como um servidor de compilação para que você possa mais facilmente obter acesso direto ao ambiente no qual o processo de compilação está sendo executado.Consulte Implantar e configurar um servidor de compilação.

Verificar seus componentes do sistema de compilação

Certifique-se de que os servidor, controlador, e agente de compilação estão configuradas corretamente.Consulte Implantar e configurar um servidor de compilação, Implantar e configurar um Build Controller, e Implantar e configurar agentes de compilação.

Fazer logon no servidor de compilação e confirme que está funcionando corretamente.Você também pode exibir dados diagnóstico detalhados no servidor de compilação.Consulte Manage Your Build System.

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

Para diagnosticar problemas causados por atividades de processo de compilação personalizada , ou por exceções de não tratada, tentar depurar o processo de compilação no seu servidor de compilação.

Faça logon no servidor de compilação.
Execução Visual Studio como um administrador.
No Visual Studio, da barra de menus, escolha Ferramentas, Anexar a Processo.
Na caixa de diálogo Anexar a Processo :
1. Mostrar processos de todos os usuários.
2. TFSBuildServiceHost.exe.
3. Escolha Anexar.
A barra de menus escolha Depurar, Exceções.Na caixa de diálogo Exceções , Exceções do common language runtime.Escolha OK.
A barra de menus, escolha Ferramentas, Opções.Na caixa de diálogo Opções , no painel da árvore, Depurando.Na lista de Geral , e desmarque a caixa de seleção Habilitar Apenas Meu Código .Escolha OK.
No Visual Studio, coloque a compilação e certifique-se de que é executado em um controlador de compilação e um servidor de compilação que são hospedados no servidor de compilação em que você ativou o depurador.

Agora você pode depurar exceções que são geradas durante o processo de compilação, e também definir pontos de interrupção e depurar as atividades personalizados do processo de compilação.Consulte Depuração no Visual Studio.

Dicas

Quando você diagnosticar problemas com um processo de compilação, você pode salvar e problemas de seus colegas de equipe pausando o até que você possa reparar o processo:
- Edite a definição de compilação, e na parte inferior do guia de Geral , escolha Em pausa.
- Quando a definição de compilação for pausada, para testar suas correções a compilação processar, selecione compilação na fila, abra o menu de atalho, e escolha Iniciar Agora.
Se você pensar um dos seus componentes do sistema de compilação pode ser a causa de um dos problemas, você pode iniciar, parar, ou reiniciar o servidor de compilação ou ativar ou desativar um controlador ou um agente quando necessário.Consulte Manage Your Build System.
Geralmente, ao tentar corrigir problemas do processo de compilação, você precisa colocar uma compilação com as opções testar repetidamente mais correções.Você pode rapidamente testar de uma nova compilação:
- De a janela resultados de compilação , escolhendo AçõesCompilação do tentar.
- De Página de compilações o team Explorer ou de compilação Explorer selecionando uma compilação concluída, abrindo o menu de atalho, e escolhendo Compilação do tentar.

Partilhar via