Compartilhar via

Implantar e configurar agentes de compilação

  • Artigo

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.

Dois servidores 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.

Dica

Se a sua coleção de projeto de equipe está hospedada no Visual Studio Online, e as necessidades da equipe podem ser atendidas por um único agente de compilação padrão, você poderá usar o Controlador de compilação hospedado em vez de implantar seu próprio 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

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

      Agente de compilação

      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 Ícone da home page Página Inicial e depois Ícone de compilações 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.

    Caixa de diálogo gerenciar controladores de compilação

  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.

Caixa de diálogo Propriedades do agente de compilação

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.

Dica

Você pode melhorar o desempenho dedicando um único disco rígido físico ao diretório de trabalho de cada agente de compilação.

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.

Subdiretório

Usado para armazenar arquivos…

Sources

Leia o agente de compilação, como arquivos de origem. Você especifica os arquivos que são baixados nas configurações de Espaço de trabalho para cada definição de compilação. Consulte Trabalhar com espaços de trabalho de compilação.

Binaries

Compilado pelo agente de compilação, como arquivos de aplicativos compilados.

TestResults

Gerado por quaisquer testes que o agente de compilação executou.

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.

Importante

Vários tipos de testes e de operações de teste exigem que você instale seu agente de compilação na mesma versão do Visual Studio usada por sua equipe nas máquinas de desenvolvimento.Consulte Instalando o Visual Studio.

O agente de compilação pode executar:

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 a seguinte marca…

Para identificar um agente de compilação que pode…

x86

Compilar aplicativos de 32 bits

x64

Compilar aplicativos de 64 bits

bvt

Execute seus testes de BVT, que são executados por sua compilação noturna de BVT.

WindowsStore

Compilar e testar um aplicativo da Windows Store.

IIS

Compilar um aplicativo Web ASP.NET e, em seguida, encená-lo e hospedá-lo no computador em que o agente de compilação está sendo executado.

interativo

Execute tarefas que exijam um agente em um servidor de compilação que está sendo executado no modo interativo.

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.

Dica

Você também pode usar o console de administração do Team Foundation para remover o agente de compilação quando estiver conectado ao servidor de compilação.

Próximas etapas