Implantar e configurar agentes de compilação

Para usar o Team Foundation Build, sua equipe deve ter pelo menos um agente de compilação para executar o trabalho de processamento intensivo do processo de compilação.

Cada agente de compilação é dedicado a e controlado por um único controlador de compilação. Agentes de compilação podem ser hospedados no mesmo servidor de compilação que hospeda o controlador de compilação, mas isto não é necessário e, em alguns casos, as necessidades da equipe podem ser atendidas mais eficientemente por um único servidor de compilação para hospedar um controlador de compilação que controla agentes de compilação em vários servidores de compilação.

O agente de compilação executa as etapas do processo de compilação que estão contidas na atividade de AgentScope . Normalmente, estas etapas incluem obter os arquivos de controle de versão, configurar o espaço de trabalho, compilar o código, executar os testes, e mesclar os arquivos novamente no controle de versão.

Verifique se o servidor de compilação que hospeda seus agentes de compilação tem recursos de armazenamento e de processamento suficientes para corresponder ao tamanho e à complexidade do codebase e dos testes na coleção de projetos de equipe. Normalmente, você não deve hospedar mais de um agente de compilação por núcleo de processador no servidor de compilação. Você também pode melhorar o desempenho dedicando um único disco rígido físico ao diretório de trabalho de cada agente 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?

• Criar ou modificar um agente de compilação

• Instalar o Visual Studio e outro software para habilitar a compilação e outros recursos

• Especifique o diretório de trabalho

• Habilitar seu agente de compilação para executar testes

• Atribuir marcas para representar recursos do agente de compilação ou objetivos

• Implantar um agente de compilação que pode criar e testar um aplicativo da Windows Store

• Remover um agente de compilação

Criar ou modificar um agente de compilação

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

1. Faça 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 do Console de Administração do Team Foundation, expanda o nome do servidor e então escolha o nó Configuração da Compilação.

   Informações sobre o servidor de compilação aparecem no painel de conteúdo.

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

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

   • Para criar um novo agente de compilação, selecione Novo Agente.

   • Para alterar um agente de compilação existente

     

     escolha Propriedades.

   A caixa de diálogo Propriedades do agente de compilação aparece.

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

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

   

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

   A caixa de diálogo Propriedades do agente de compilação aparece.

Nome para exibição, Descrição: Digite um nome e descrição para ajudar membro da equipe a identificar com facilidade o agente de compilação.

Controlador: Selecione o controlador de compilação ee330987(v=vs.120).md com o qual deseja controlar esse agente de compilação. O controlador de compilação pode ser executado no mesmo servidor de compilação deste agente de compilação ou em um servidor de compilação diferente.

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

Instalar o Visual Studio e outro software para habilitar a compilação e outros recursos

Você deve instalar a versão do Visual Studio no agente de compilação, que sua equipe usará nas máquinas de desenvolvimento. Consulte Instalando o Visual Studio. Você também deve instalar qualquer software e outros componentes que são instalados em seus computadores de desenvolvimento e que são necessários para compilar seu aplicativo.

Especifique o diretório de trabalho

Você pode especificar o diretório de trabalho, que o agente de compilação usa para ler ou gravar arquivos. Por exemplo, os arquivos de fonte são copiados em subdiretórios nesta pasta, e os binários são criados e armazenados em outros subdiretórios nessa pasta.

Use os tokens de pasta de trabalho

Embora você possa especificar um caminho literal para a propriedade Diretório de Trabalho (por exemplo, c:\temp\build\), uma abordagem mais simples e mais durável seria usar tokens para especificar o caminho. Você pode usar dois tipos de tokens:

• Variáveis de ambiente
  As variáveis de ambiente contêm informações sobre o ambiente do sistema e o usuário que está conectado. A variável mais comum que você pode usar é SYSTEMDRIVE, mas para algumas situações você também pode usar variáveis como USERNAME ou HOMEPATH.

  Dica

  Para listar as variáveis de ambiente em seu servidor de compilação, abra um prompt de comando e digite set.

• Variáveis do Team Foundation Build
  Você pode usar as seguintes variáveis em um directory de trabalho do agente de compilação:

  • $(BuildAgentId): Um inteiro gerado automaticamente gerado que identifica de maneira exclusiva um agente de compilação em uma coleção de projeto de equipe.

  • $(BuildAgentName): O Nome para exibição do agente de compilação.

  • $(BuildDefinitionId): Um inteiro gerado automaticamente gerado que identifica de maneira exclusiva uma definição de compilação em uma coleção de projeto de equipe.

  • $(BuildDefinitionPath): O nome do projeto de equipe e o nome da definição de compilação, separados por uma barra invertida.

Exemplo de diretório de trabalho

Por exemplo, você tem um agente de compilação chamado BuildBot3. Você definiu duas compilações que são chamadas NightlyBuild e WeeklyBuild em um projeto de equipe que é chamado CoolApp. Na caixa Diretório de Trabalho, especifique o valor seguir: $(UnidadeDoSistema)\TeamBuilds\$(NomeDoAgenteDeCompilação)\$(CaminhoDeDefiniçãoDeCompilação). Como resultado, o agente de compilação BuildBot3 cria e usa os dois diretórios de trabalho a seguir:

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Verificar se o caminho para o diretório de trabalho não é longo demais

O diretório de trabalho que você especifica não deve fazer com que o agente de compilação produza caminhos físicos com mais de 259 caracteres. Caso contrário, suas compilações falharão e registrarão este erro: TF10128: The path PhysicalPath contains more than the allowed 259 characters. Type or select a shorter path.

Para resolver esse problema, especifique uma pasta de trabalho que resulta em um caminho físico mais curto. Por exemplo você pode especificar $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), que resultaria em um diretório de trabalho como: c:\bld\3\2\.

Subdiretórios criados no diretório de trabalho

O agente de compilação cria e funciona nos seguintes subdiretórios nesse caminho.

Habilitar seu agente de compilação para executar testes

Você pode definir um processo de compilação que executa uma ou mais execuções de teste automático.

O agente de compilação pode executar:

• Cobertura de Código

• Testes de IU Codificados (precisa de servidor de compilação em execução no modo interativo. Consulte Executar seu servidor de compilação no modo interativo e Verificando código pela Automação da Interface do Usuário.)

• Geração de dados de teste de banco de dados

• Testes de unidade de banco de dados

• Testes genéricos

• Testes de carga

• Testes de Unidade

• Teste Ordenados

• Testar Análise de Impacto

• Testes na Web

Atribuir marcas para representar recursos do agente de compilação ou objetivos

Conforme a escala de seu sistema de compilação cresce, você talvez precise definir agentes de compilação especializados. Sempre que um agente de compilação tem recursos especiais ou é destinado para um tipo específico de uso, você deve atribuir uma ou mais marcações ao agente. Desta forma, quando um membro da equipe cria uma definição de compilação que requer um determinado tipo de agente de compilação, ele pode especificar a marca em sua definição de compilação.

Você pode atribuir tags na caixa de diálogo Propriedades do agente de compilação, descrita acima. Então, você pode aplicar as marcas para suas definições de compilação.

A tabela a seguir oferece exemplos de nomes de marca e os recursos do agente de compilação que eles podem representar.

Você pode aplicar mais de uma tag a um agente de compilação. Por exemplo, você pode criar um agente de compilação com as tags x86 e versão para indicar um agente que esteja configurado para compilar a configuração da versão de um aplicativo de 32 bits.

Se você executar vários agentes de compilação no mesmo servidor de compilação, provavelmente todos terão os mesmos recursos. Portanto, você provavelmente desejará aplicar as mesmas marcas a todos os agentes de compilação no servidor de compilação.

Remover um agente de compilação

1. No Visual Studio, abra a caixa de diálogo Gerenciar Controladores de Compilação conforme explicado anteriormente em Criar ou modificar um agente de compilação.

2. Selecione o agente de compilação que você deseja remover e escolha Remover.

Próximas etapas

• 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.

• Gerenciar seu sistema de compilação
  Ocasionalmente, você precisará monitorar e gerenciar seu sistema de compilação.

• Use seu sistema de compilação para criar, testar, e implantar seu aplicativo
  Quando seu sistema de compilação estiver pronto, sua equipe estará pronta para criar um processo simples de compilação (por exemplo, uma compilação de integração contínua) e beneficiar-se da compilação e dos testes automatizados do aplicativo.