Gerenciar seu sistema de compilação

Você configurou os servidores de compilação, incluindo os controladores de compilação e os agentes de compilação. Você definiu os processos de compilação para atender às necessidades de sua equipe. Sua equipe agora está executando e gerenciando suas compilações automatizadas para criar e testar seu aplicativo.

Ocasionalmente, você estará em situações em que você precisar monitorar e gerenciar seu sistema de compilação, como quando você estiver diagnosticando problemas ou dimensionamento para fora seu sistema de compilação.

Permissões exigidas

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

O que você deseja fazer?

• Verifique o status, gerencie e modifique seus controladores e agentes do Visual Studio

• Verifique o status, gerencie e modifique seu servidor, controlador e agentes do console de administração

• Iniciar, parar ou reiniciar um servidor de compilação

• Reinicie um controlador ou agente de compilação

• Habilitar ou desabilitar um controlador ou agente

• Especificar o número máximo de compilações em execução simultânea para um controlador

• Registre ou cancele o registro de um servidor de compilação

• Monitorar a integridade do servidor de compilação

• Use registros de eventos para diagnosticar problemas

• Executar as próximas etapas

Verifique o status, gerencie e modifique seus controladores e agentes do Visual Studio

Às vezes você quer verificar o status e gerenciar seus controladores de compilação e agentes de compilação, por exemplo, quando um processo enfileirado de compilação não está sendo enfileirado ou não está progredindo. Você pode fazer tudo isso diretamente do Visual Studio.

1. No Visual Studio, no Team Explorer:

   1. Se você ainda não estiver conectado a um projeto de equipe na coleção de projetos de equipe, conecte-se ao projeto de equipe.

   2. Escolha Página Inicial e depois Compilações.

2. Na página Compilação, selecione Ações, e então Gerenciar Controladores de Compilação.

Próximas Etapas

• Verificar o status de seus controladores e agentes

  • Se o Estado é Disponível e o Status é Habilitado, o componente provavelmente está funcionando corretamente.

  • Se o Estado é Desabilitado, você pode selecionar o componente, escolher as Propriedades e reativar o componente.

  • Se o Status é Offline, o componente está desconectado. Faça logon no servidor de compilação e certifique-se de que ele esteja registrado e que possa se conectar ao Team Foundation Server.

• Exibir, modificar, ativar ou desativar um controlador ou agente
  Selecione-o e escolha Propriedades e depois consulte Implantar e configurar um controlador de compilação ou Implantar e configurar agentes de compilação.

• Remover um controlador ou um agente
  Consulte Remover um controlador de compilação ou Remover um agente de compilação.

• Gerenciar ou resolver problemas com um servidor de compilação, controlador ou agente
  Consulte as seções abaixo para obter mais informações.

Verifique o status, gerencie e modifique seu servidor, controlador e agentes do console de administração

Quando desejar verificar ou gerenciar seus componentes do sistema de compilação, você precisará, às vezes, de recursos adicionais que estão disponíveis quando você faz logon no servidor de compilação.

1. Fazer logon no servidor de compilação que você deseja configurar.

2. No menu Iniciar do Windows, execute o Console de administração do Team Foundation.

   O Console de Administração do Team Foundation é exibido.

3. No painel da árvore, expanda o nome do servidor.

4. Escolha o nó Configuração da Compilação.

Próximas Etapas

• Verificar o status de seus controladores e agentes

  • Se qualquer um dos controladores de compilação ou dos agentes de compilação está processando uma compilação, você pode ver mensagens sobre esse trabalho em andamento em tempo real no Console de administração do Team Foundation.

    

    Para obter mais informações sobre como monitorar um processo de compilação em execução, consulte Executar, monitorar e gerenciar compilações e Diagnosticar problemas em sua compilação.

  • Se um controlador ou um agente estiver vermelho, significa que o componente está desconectado. Verifique se o seu servidor de compilação pode se conectar ao seu Team Foundation Server.

• Trabalhar com o servidor de compilação

  

  • Escolha Reiniciar, Parar ou Iniciar para iniciar, parar ou reiniciar o servidor de compilação.

  • Escolha Propriedades para implantar e configurar um servidor de compilação.

  • Escolha Registrar ou Cancelar registro para registrar ou cancelar o registro de um servidor de compilação.

  • Escolha Eventos… para usar logs de eventos para diagnosticar problemas.

  • Monitore a integridade do servidor de compilação.

• Trabalhar com o controlador de compilação
  

  • Escolha Propriedades e consulte Implantar e configurar um controlador de compilação.

  • Escolha Reiniciar para reiniciar o controlador.

  • Escolha Habilitar ou Desativar para ativar ou desativar o controlador.

• Trabalhar com o agente de compilação
  

  • Escolha Propriedades e consulte Implantar e configurar agentes de compilação.

  • Escolha Reiniciar para reiniciar o agente.

  • Escolha Habilitar ou Desativar para ativar ou desativar o agente.

Iniciar, parar ou reiniciar um servidor de compilação

É uma boa ideia parar o servidor de compilação sempre que você estiver executando manutenção nele. No Console de administração do Team Foundation, escolha Parar para colocar todos os controladores de compilação e agentes de compilação hospedados no servidor de compilação offline. Escolha Iniciar quando você estiver preparado para colocar controladores e agentes de volta no serviço.

Se o servidor de compilação não responder (por exemplo, se um processo de compilação não for inicializado ou não progredir), escolher Reiniciar pode ajudar. Quando você reinicia o servidor de compilação, o processo do Team Foundation Build Service é fechado e reiniciado em um estado semelhante ao estado "atualizado", como se você tivesse reinicializado o computador Se as compilações estiverem sendo processadas atualmente pelo controlador de compilação ou por quaisquer agentes de compilação nesse servidor de compilação, essas compilações serão canceladas.

Reinicie um controlador ou agente de compilação

Quando reiniciar o servidor de compilação for muito disruptivo ou desnecessário, você pode escolher o link Reiniciar do controlador de compilação ou do agente de compilação do Console de administração do Team Foundation. Quando você reinicia um controlador de compilação, ele recarrega os assemblies, e todas as compilações que estão sendo processadas são anuladas. Quando você reinicia um agente de compilação, ele descarta o domínio de aplicativo, recarrega os assemblies, e a compilação que sendo processada é anulada.

Habilitar ou desabilitar um controlador ou agente

Você pode desabilitar um controlador ou um agente para impedir que as compilações sejam atribuídas a ele. Se você desabilitar um controlador ou um agente que esteja processando uma compilação, a compilação concluída antes do componente será desabilitada.

Esse recurso pode ajudar você a ajustar ou modificar temporariamente a forma como o seu sistema de compilação funciona. Por exemplo, você suspeita que um servidor de compilação está executando muitos agentes de compilação porque as compilações estão sendo processadas muito lentamente. Você pode desabilitar alguns agentes de compilação e avaliar como isso afeta o desempenho. Então, você pode reativar um ou mais agentes de compilação posteriormente, se necessário.

Para ativar ou desativar um agente de compilação ou controlador de compilação:

• Na caixa de diálogo dos controladores de compilação de gerenciamento do Visual Studio, selecione o controlador de compilação ou o agente de compilação que você deseja ativar ou desativar e escolha Propriedades. Propriedades do Controlador de Compilação ou a caixa de diálogo Build Agent Properties aparece. Limpe ou selecione O serviço do Controlador de Compilação está habilitado ou a caixa de seleção O serviço do Agente de Compilação está habilitado.

• No Console de administração do Team Foundation, localize o controlador de compilação ou o agente de compilação que você deseja ativar ou desativar e escolha o link Habilitar ou Desabilitar.

Registre ou cancele o registro de um servidor de compilação

No Console de administração do Team Foundation, escolha Cancelar registro se você quiser retirar o servidor de compilação do seu sistema de compilação. Ao selecionar Cancelar registro, será perguntado a você se deseja excluir qualquer controlador de compilação e agente de compilação que esteja executando no servidor de compilação:

• Escolha Não se você deseja desarmar temporariamente o servidor de compilação. Os controladores e agentes neste servidor de compilação não são excluídos de sua coleção de projeto de equipe e aparecem com Status de Offline na caixa de diálogo O Controladores de compilação de gerenciamento do Visual Studio. Mais tarde você pode escolher Registrar e restaurar o controlador de compilação e agentes de compilação.

• Escolha Sim se você deseja excluir todas as definições de configuração desta compilação da coleção de projetos de equipe. Toda informação sobre controladores de compilação e agentes de compilação será excluída.

Se a mensagem Build Service não está registrado aparecer, você poderá escolher Registrar para autorizar o servidor de compilação novamente e ativá-lo para hospedar controladores de compilação e agentes de compilação.

Monitorar a integridade do servidor de compilação

Quando conectado ao servidor de compilação, você pode confirmar que o Serviço Team Foundation Build está sendo executado, obter informações sobre os recursos que estão sendo consumidos, e confirmar a integridade geral do servidor de compilação.

1. Execute o Gerenciador de Tarefas do Windows (Gerenciador de Tarefas em Windows 8).

2. Em Windows 8, se o link Mais Detalhes aparecer, escolha-o.

3. Escolha a guia Processo.

4. Em versões do Windows a não ser Windows 8, certifique-se que Mostrar processos de todos os usuários está selecionado.

5. Em qual versão do Windows seu servidor de compilação está sendo executado?

   • Windows 8: Localize o processo Host do serviço de compilação do Visual Studio Team Foundation. Deve ser localizado na seção Processos em segundo plano ou, se o seu servidor de compilação estiver executando em modo interativo, na seção Aplicativos. Observe a CPU, memória, disco e os recursos de rede que o processo está utilizando.

   • Outra versão do Windows: Localize o processo TFSBuildServiceHost.exe. Observe a CPU e os recursos de memória que o processo está consumindo.

6. Use as outras guias no gerenciador de tarefas para confirmar a integridade geral do servidor de compilação. Por exemplo, é possível escolher o guia Desempenho para confirmar se o computador tem processador adequado e recursos de memória. Então, você pode pode escolher Monitor de Recursos (em Windows 8, Monitor Abrir recurso).

Use registros de eventos para diagnosticar problemas

Use o Visualizador de Eventos para obter informações que podem ajudá-lo a monitorar como seu servidor de compilação está funcionando e a diagnosticar problemas com seu servidor de compilação ou processo de compilação.

Exibir acontecimentos recentes

Inicie verificando os acontecimentos mais recentes. No Console de administração do Team Foundation, escolha Eventos… para abrir o Visualizador de Eventos para exibir as mensagens informativas, de aviso e de erro mais recentes.

Exibir o registro operacional

Para obter informações mais detalhadas durante um período mais longo do tempo, no visualizador de eventos, no painel de árvore, expanda Registros de Aplicativos e Serviços, Microsoft, Team Foundation Server, Serviços de Compilação e, em seguida, clique em Operacional.

Exibir o registro analítico

Na maioria dos casos, não será necessário ler as mensagens internas expostas pelo log analítico. No entanto, esses dados podem ser úteis quando você está trabalhando com o suporte ao cliente para resolver um problema.

Para ativar o registro analítico

1. No Visualizador de Eventos, escolha Exibir, Mostrar Logs Analíticos e de Depuração.

2. No painel da árvore, expanda Logs de Aplicativos e Serviços, Microsoft, Team Foundation Server, Serviços de Compilação de serviços e então escolha Analítico.

3. Enquanto Analítico ainda estiver selecionado, abra o menu de atalho e, em seguida, selecione Habilitar.

Personalizar e exibir os dados

Para salvar os dados em um arquivo permanente que seja fácil de verificação e exibir, no painel de árvore, selecione um dos nós descritos acima, abra o menu de atalho e, em seguida, selecione Salvar Eventos…. Use a caixa de diálogo Salvar como para salvar os dados no formato que atenda às suas necessidades.

Próximas Etapas

• Implantar e trabalhar com um servidor de compilação
  Para usar o Team Foundation Build com um Team Foundation Server local, você deve implantar pelo menos um servidor de compilação. O servidor pode ser implantado em um computador físico ou virtual.

• Implantar e configurar um controlador de compilação
  Use um controlador de compilação para executar tarefas leves e distribuir o trabalho de processamento intensivo do processo de compilação para o pool de agentes de compilação. É possível hospedar um controlador de compilação em um servidor de compilação.

• Implantar e configurar agentes de compilação
  Use um agente de compilação para fazer o trabalho de processamento intensivo da sua compilação, incluindo a obtenção dos arquivos de controle de versão, configuração do espaço de trabalho, compilação do código, e a execução de testes. É possível hospedar um ou mais agentes de compilação em um servidor de compilação.

• Configurar pastas-depósito
  É possível preparar e designar uma ou mais pastas-depósito de modo que o seu sistema de compilação possa fornecer binários, resultados de testes e arquivos de registro para a equipe.

• Dimensionar seu sistema Team Foundation Build
  À medida que sua equipe e base de código aumentam, você pode expandir o seu sistema de compilação incrementalmente, com facilidade relativa.