Implantar e configurar um controlador de compilação

Para usar o Team Foundation Build, sua equipe deve ter pelo menos 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.

Cada controlador de compilação é dedicado a uma única coleção de projetos de equipe. O controlador de compilação executa algumas tarefas leves, como a determinação do nome de compilação, a criação do rótulo no controle de versão, o registro de observações e o relato de status da compilação. O controlador de compilação usa a atividade AgentScope para delegar trabalho intenso do processador, como a compilação de código ou a execução de testes, para os agentes de compilação dentro do pool. Esses agentes de compilação podem ser hospedados no mesmo servidor de compilação ou em um servidor de compilação diferente.

Como um controlador de compilação normalmente não exige tempo de processamento significativo, em muitos casos você pode hospedá-lo no mesmo computador que o Team Foundation Server, como mostrado acima, ou em um computador virtual ou físico de baixa potência.

No entanto, um controlador de compilação pode exigir uma quantidade significativa de memória em determinadas situações. Portanto, você deve fornecer memória suficiente conforme necessário para garantir que ele funcione corretamente. Ou, dependendo das necessidades de sua equipe e dos recursos, talvez você queira executar o controlador de compilação em um computador diferente do seu Team Foundation Server.

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.

O que você deseja fazer?

• Criar ou modificar um controlador de compilação

• Habilitar os processos de compilação para aproveitar binários suplementares

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

• Remover um Controlador de Compilação

• Usar um controlador de compilação com uma coleção de projeto de equipe hospedada no Visual Studio Online

Criar ou modificar um controlador de compilação

Para criar ou modificar um controlador de compilação do servidor de compilação

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

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

3. No painel da árvore do Console de Administração do Team Foundation, expanda o nome do servidor e escolha o nó Configuração da Compilação.

   Dica

   Se a mensagem Configurar recursos instalados aparecer, consulte Implantar um servidor de compilação.

4. Na página Configuração da Compilação:

   • Se um controlador não está listado, escolha Novo controlador.

   • Se um controlador já estiver listado:

     

     Escolha Propriedades.

   A caixa de diálogo Propriedades de Controlador de Compilação aparece.

Para modificar um controlador de compilação 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ções, selecione Ações e Gerenciar Controladores de Compilação.

   A caixa de diálogo Gerenciar Controladores de Compilação aparece.

   

3. Selecione o controlador de compilação que você deseja modificar e escolha Propriedades.

   A caixa de diálogo Propriedades de Controlador de Compilação aparece.

Nos campos Nome para Exibição e Descrição: digite um nome e uma descrição que possa ajudar os membros da equipe a identificar com facilidade o controlador de compilação apropriado quando eles definirem os processos de compilação.

Consulte as seções abaixo para obter detalhes sobre como configurar seu controlador de compilação.

Habilitar os processos de compilação para aproveitar binários suplementares

Você pode habilitar o processo de compilação para aproveitar os binários que carregou para o Team Foundation Server, por exemplo:

• Assemblies que contêm atividades personalizadas de fluxo de trabalho. Consulte Usar e desenvolver atividades do processo de compilação personalizado.

• Estruturas de teste da unidade de terceiros. Consulte Executar testes no processo de compilação.

• Tarefas personalizadas do MSBuild

Para habilitar os processos de compilação para aproveitar esses tipos de código, carregue os binários na pasta (ou em qualquer uma das pastas descendentes) especificada na caixa Caminho de controle de versão para assemblies personalizados. Ao definir ou alterar o valor na caixa, o servidor de compilação reinicializa automaticamente para carregar os assemblies.

Dica

Se os resultados de compilação incluem uma mensagem de erro TF215097, o processo de compilação pode incluir uma atividade personalizada que não está nessa pasta ou em nenhuma das pastas descendentes.

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

Na maioria dos casos, você deve deixar esse valor definido como Usar como padrão o número de agentes habilitados. No entanto, em alguns casos, convém controlar a profundidade da fila de compilação. Por exemplo:

• Você observa que compilações em excesso exibem um status Em Execução mesmo que muitos deles sejam interrompidos ao aguardarem um agente de compilação ser atribuído a eles. Essa situação pode confundir a equipe. Para evitar o problema, marque Especificar o máximo e especifique um valor que seja menor do que o número de agentes de compilação agrupados no controlador de compilação.

• Crie um modelo personalizado de compilação para permitir que as compilações aproveitem mais de um agente de compilação por vez, de um pool de 12 agentes de compilação no controlador de compilação. As compilações processadas por esse controlador de compilação se baseiam em um modelo personalizado de compilação que atualmente delega a três agentes de compilação. Para tornar os dados da fila de compilação mais úteis, configure o controlador de compilação com o Número máximo de compilações simultâneas definido como Especificar o máximo, com um valor de 4.

Remover um Controlador de Compilação

1. No Visual Studio, abra a caixa de diálogo Gerenciar Controladores de Compilação conforme explicado acima em Modificar um controlador de compilação do Visual Studio.

2. Selecione e remova cada agente de compilação sob o controlador de compilação escolhendo Remover ou Propriedades, e usando a caixa de diálogo Propriedades de Agente de Compilação para atribuir o agente de compilação a outro controlador de compilação.

3. Selecione o controlador de compilação que você deseja remover e escolha Remover.

Dica

Você também pode usar o console de administração do Team Foundation para remover o controlador de compilação quando estiver conectado ao servidor de compilação.Mas se você fizer isso, ainda precisará usar o Visual Studio ou fazer logon em outros servidores de compilação primeiro, para remover todos os agentes de compilação remotos agrupados pelo controlador de compilação.

Usar um controlador de compilação com uma coleção de projeto de equipe hospedada no Visual Studio Online

Use o controlador de compilação hospedado: se a coleção de projeto de equipe estiver hospedada no Visual Studio Online, você poderá ignorar a implantação do seu próprio controlador de compilação e utilizar o Controlador de Compilação Hospedado. Para usar o Controlador de Compilação Hospedado, basta selecioná-lo quando você definir o processo de compilação. Consulte Usar o Controlador de Compilação Hospedado.

Use um controlador de compilação local: se o processo de compilação requisitar recursos que não estão entre os recursos do Controlador de Compilação Hospedado, você poderá conectar o seu controlador de compilação local à coleção de projeto de equipe hospedada.

Próximas Etapas

• Implantar e configurar agentes de compilação
  Use um agente de compilação para fazer o trabalho de processamento intensivo da compilação. Isso inclui a obtenção de arquivos do controle de versão, o provisionamento do espaço de trabalho, a 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 sistema de compilação possa fornecer binários, resultados de testes e arquivos de registro para a equipe.

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

• Gerenciar seu sistema de compilação
  Depois de implantar o servidor de compilação, você pode gerenciá-lo do Console de Administração do Team Foundation. É possível gerenciar o controlador de compilação e os agentes de compilação do console de administração do Team Foundation ou do Visual Studio.

• Definir o processo de compilação
  Depois que o sistema de compilação estiver no local, você estará pronto para definir o processo de compilação, que contém instruções sobre quais projetos de código compilar, quais ações disparam uma compilação, quais testes rodam e qualquer outro procedimento exigido pela sua equipe.