Compartilhar via

Implantar e configurar agentes de compilação

  • Artigo

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

Compilação de dois servidores

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 o mais eficiente ser encontradas por um único servidor de compilação para hospedar um controlador de compilação que agentes de compilação dos controles 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, elas incluem obter os arquivos de controle de versão, configurar o espaço de trabalho, compilar o código, execute teste, e mesclar arquivos de novo em controle de versão.

Certifique-se que o servidor de compilação que hospeda seus agentes de compilação possui permissões recursos de armazenamento e de processamento coincidir com o tamanho e a complexidade da e os testes na coleção de projeto de equipe.Normalmente, você deve hospedar não mais de um agente de compilação pelo núcleo do processador no servidor de compilação.Você também pode melhorar o desempenho dedicando um único físico disco rígido a diretório de trabalho de cada agente de compilação.

DicaDica

Se sua coleção de projeto de equipe está hospedada Serviço do team foundationno, e as necessidades da equipe podem ser encontradas por um único agente de compilação padrão, você pode usar 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 um membro do grupo administradores de compilação de coleção de O em sua coleção de projeto de equipe.Consulte Team Foundation Permissões do servidor.

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. Fazer logon em o servidor de compilação que você deseja configurar.

  2. Início 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ó de Configuração da compilação .

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

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

  4. Na página de configuração de compilação:

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

    • Para alterar um agente de compilação existente

      Agente de compilação

      escolha Propriedades.

    A caixa de diálogo Compilar propriedades do agente aparece.

Para alterar um agente de compilação do Visual Studio

  1. No Visual Studio, o team Explorer:

    1. Se você não está mais conectado a um projeto de equipe na coleção de projeto de equipe, em seguida se conectar ao projeto de equipe.

    2. Escolha Ícone da home pagePágina Inicial e depois Ícone de compilaçõesCompilações.

  2. Em compilações página, escolha Ações, e então Gerenciar Controladores de Compilação.

    A caixa de diálogo de 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 então escolha Propriedades.

    A caixa de diálogo Compilar propriedades do agente aparece.

Criar caixa de diálogo Propriedades do agente

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

Controlador: Selecione controlador de compilação que você deseja controlar esse agente de compilação.O controlador de compilação pode executar no mesmo servidor de compilação que o agente de compilação ou em um servidor diferente de compilação.

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

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

É uma prática recomendada instalar o no agente de compilação a versão do Visual Studio que sua equipe usa em seu dev faz ao computador.Consulte Instalando o Visual Studio.Você também deve instalar qualquer software e outros componentes que são instalados nos computadores de dev e que são necessários para compilar seu aplicativo.Caso contrário, você pode ter problemas, como parte do seu código projetos a compilação falhar.

Especificar a pasta de trabalho

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

DicaDica

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

Bb399135.collapse_all(pt-br,VS.110).gifUse tokens de pasta de trabalho

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

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

    DicaDica

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

  • Variáveis team foundation build
    Você pode usar as variáveis em um agente de compilação que funciona diretório:

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

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

    • $(BuildDefinitionId): Um inteiro automaticamente gerado que identifica unicamente 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.

Bb399135.collapse_all(pt-br,VS.110).gifExemplo de pasta de trabalho

Por exemplo, você tem um agente de compilação que é chamado BuildBot3.Você definiu dois construtores que são chamadas NightlyBuild e WeeklyBuild em um projeto de equipe que é chamado CoolApp.Na caixa de Diretório de Trabalho , você especifica o valor seguir: $ () SystemDrive \ \ TeamBuilds $ () de BuildAgentName \ BuildDefinitionPath $ ().Como resultado, o agente de compilação BuildBot3 criar e usar os seguintes dois diretórios de trabalho:

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Bb399135.collapse_all(pt-br,VS.110).gifCertifique-se de que o caminho para o diretório de trabalho não é muito longo

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

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

Bb399135.collapse_all(pt-br,VS.110).gifSubdiretórios criados no diretório de trabalho

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

Subdiretório

Usado para armazenar arquivos…

Sources

Ler o agente de compilação, como arquivos de origem.Você especifica os arquivos que baixa 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 do aplicativo compilado.

TestResults

Gerado pelo teste que o agente de compilação foi executado.

Habilitar o agente de compilação para executar um teste

Você pode definir um processo de compilação que executa um ou mais ensaios automatizados.

Observação importanteImportante

Muitos tipos de teste e das operações de teste exigem que você instale no agente de compilação a mesma versão do Visual Studio que sua equipe usa em seu dev faz ao computador.Consulte Instalando o Visual Studio.

O agente de compilação pode executar:

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

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

Você pode atribuir marcas de A caixa de diálogo propriedades do agente de compilação, descrito acima.Você pode então aplicar as marcas a suas definições de compilação.

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

Você pode aplicar a seguir marca…

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

x

Criar aplicativos de 32 bits

x64

Criar aplicativos de 64 bits

bvt

Executar seus testes de BVT, que são executados pelo seu compilação nocturna de BVT.

WindowsStore

Criar e testar um aplicativo da Windows Store.

IIS

Criar um aplicativo Web ASP.NET e em seguida encene-o e hospedar-l no computador no qual o agente de compilação está sendo executado.

interativo

Executar tarefas que exijam um agente de compilação em um servidor que esteja executando em modo interativo.

Você pode aplicar mais de uma marca para um agente de compilação.Por exemplo, você pode criar um agente de compilação com as marcas x e a versão para indicar um agente que esteja configurado para criar 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 terá todos os mesmos recursos.Como consequência, 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 de 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 então escolha Remover.

DicaDica

Você também pode usar o console de administração do team foundation para remover o agente de compilação quando você estiver conectado a compile o servidor.

Próximas etapas