Compartilhar via


Criar e trabalhar com os agentes de compilação

Para usar Team Foundation Build, sua equipe deve ter pelo menos um build agent. Um agente de compilação faz com que o trabalho de processamento intensivo de compilação, o que inclui a obtenção de arquivos do controle de versão, o provisionamento de espaço de trabalho, compilar o código, a execução de testes e mesclar arquivos de volta para o controle de versão. Cada agente de compilação é dedicado à e controlado por um controlador de compilação única.

Antes de iniciar

  • Você deve saber sobre a função de agentes de compilação play em um sistema de compilação, além das diferentes maneiras de usá-los. For more information, see Noções básicas sobre um sistema de compilação do Team Foundation.

  • Um agente de compilação é hospedado em uma máquina de compilação. Portanto, você deve configurar uma máquina de compilação antes de criar e trabalhar com um agente de compilação. Cada máquina de compilação pode hospedar um ou mais agentes de compilação. For more information, see Configurar uma máquina de compilação.

Neste tópico

  • Permissões necessárias

  • Criar um agente de compilação

  • Modificar um agente de compilação

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

    • Mais informações sobre o trabalho a propriedade de diretório
  • Instalar Software adicional

    • Instalar o Software necessário para compilar o código

    • Instalar o Software necessário para executar outras tarefas

    • A execução de testes com os agentes de compilação

  • Atribuir marcas de formatação a um agente de compilação

  • Remover um agente de compilação

Permissões necessárias

Para executar este procedimento, você deve ser um membro da administradores grupo na máquina de compilação e sua Gerenciar criar recursos permissão deve ser definida Permitir. For more information, see Permissões de Team Foundation Server.

Criar um agente de compilação

Para criar um agente de compilação

  1. Faça logon no computador no qual você deseja criar o agente de compilação.

  2. Clique em Iniciar, clique em Todos os programas, clique em Microsoft Team Foundation Server 2010e em seguida, clique em Console de administração do Team Foundation.

    O Console de administração do Team Foundation aparece.

  3. No painel da árvore, expanda o nome do servidor e clique no Team Foundation Build nó.

    Informações sobre a máquina de compilação aparecem no painel de conteúdo.

    Se a mensagem Criar serviço configurado for … não aparecer, consulte Configurar uma máquina de compilação.

  4. Clique em novo agente.

    O Build Agent Properties caixa de diálogo aparece. Para obter mais informações, consulte Build Agent Properties. neste tópico.

  5. Quando terminar de modificar as propriedades do agente, clique em OK.

  6. Se o Iniciar imediatamente, o link aparece sob o nome do agente de compilação, clique nele.

Modificar um agente de compilação

Você pode modificar a partir de um agente de compilação uma máquina cliente ou diretamente no computador que hospeda o agente de compilação.

Para modificar um agente de compilação de uma máquina cliente

  1. Em Visual Studio, abra o Build menu e clique Gerenciar controladores de construir.

    O Gerenciar controladores de Build caixa de diálogo aparece.

  2. Clique no agente de compilação que você deseja modificar e clique em Propriedades.

    O Build Agent Properties caixa de diálogo aparece.

Para modificar um agente de compilação na máquina de compilação

  1. Faça logon no computador que executa o agente de compilação que você deseja modificar.

  2. Clique em Iniciar, clique em Todos os programas, clique em Microsoft Team Foundation Server 2010e em seguida, clique em Console de administração do Team Foundation.

    O Console de administração do Team Foundation aparece.

  3. No painel da árvore, expanda o nome do servidor e clique no Team Foundation Build nó.

  4. Imediatamente abaixo do nome do agente de compilação que você deseja modificar, clique em Propriedades.

    O Build Agent Properties caixa de diálogo aparece.

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

No Build Agent Properties caixa de diálogo, você pode exibir ou alterar o nome de exibição e a descrição, além de outras propriedades que afetam como as funções do agente de compilação.

Exibir o nome, Descrição

Forneça um nome e uma descrição que pode ajudar a equipe de membros, identificam com facilidade e obtém informações importantes sobre o agente de compilação.

Controller

Especifica o controlador de compilação que você deseja controlar o agente de compilação. O controlador de compilação pode executar na mesma máquina de compilação como o agente de compilação ou em uma máquina de compilação diferente.

Nome do computador

Esta caixa exibe o nome do computador que hospeda o agente de compilação.

Working Directory

Use esta caixa para especificar o caminho para o diretório de trabalho. Para obter mais informações, consulte mais sobre a propriedade de diretório de trabalho.

Criar agente de serviço está habilitado.

Marque esta caixa de seleção para habilitar esse agente de compilação para a função ou desmarque se desejar desativá-lo e impedir que cria sejam atribuídos a ele.

Dica

É uma boa idéia desativar um agente de compilação sempre que você estiver fazendo a manutenção de máquina de compilação.

Mais informações sobre o trabalho a propriedade de diretório

O agente de compilação usa o diretório de trabalho para onde o agente deve ler ou gravar arquivos de operações. Por exemplo, arquivos de origem são copiados para subpastas nessa pasta e binários são criados e armazenados em outras subpastas nessa pasta.

Os Tokens de diretório de trabalho

Embora você possa especificar um caminho literal para o Working Directory propriedade (por exemplo, c:\temp\build\), uma abordagem mais flexível é usar tokens para especificar o caminho. Você pode usar dois tipos de tokens:

  • Variáveis de ambiente: Variáveis de ambiente contém informações sobre o ambiente para o sistema e o usuário que efetuou logon.

    Por exemplo, você configurou Serviço Team Foundation Build para ser executado sob uma conta que é chamada BuildSvcAcct. Especificar o \Builds de $(HomeDrive) como o diretório de trabalho para um agente de compilação em uma máquina de compilação que esteja executando o Windows Server 2008. Como resultado, o agente de compilação geralmente usarão, como o diretório de trabalho, um diretório físico que aproxima qual será o seguinte local: C:\Builds.

    Dica

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

  • Team Foundation Build variáveis: Você pode usar as variáveis a seguir em um d de trabalho do agente de compilaçãoirectory:

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

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

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

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

Exemplo de diretório de trabalho

Por exemplo, você pode ter um agente de compilação é denominado BuildBot3. Você definiu duas construções que são chamadas NightlyBuild e WeeklyBuild em um projeto de equipe que é chamado CoolApp. No Working Directory caixa, especifique o seguinte valor: $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath). Como resultado, o agente de compilação BuildBot3 cria e usa os seguintes dois diretórios de trabalho:

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Certifique-se de Working Directory não é muito longo

O diretório de trabalho que você especificar não deve causar o agente de compilação produzir qualquer caminhos físicos que são mais de 259 caracteres. Caso contrário, suas criações vai falhar e fazer este erro: TF10128: O caminhoPhysicalPath contém mais de 259 caracteres permitidos. Digite ou selecione um caminho mais curto. Este erro pode surpreendê-lo porque você não pode observar os caminhos físicos, o agente de compilação cria normalmente.

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

Subpastas criadas no trabalho diretório

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

Subdiretório

Usado para arquivos de armazenamento …

Sources

Para ler o agente de compilação, como, por exemplo, arquivos de origem. Os arquivos que baixa são especificados em cada definição de compilação espaço de trabalho as configurações.

Binaries

Compilado pelo agente de compilação, como, por exemplo, arquivos de aplicativo compilado.

TestResults

Produzido por testes de agente de compilação é executado.

Instalar Software adicional

Para o agente de compilação realizar determinadas tarefas, talvez você precise instalar software adicional no computador.

Instalar o Software necessário para compilar o código

Para um agente de compilação criar muitos dos projetos mais típicos, nenhum software adicional é necessária. Por exemplo, sem qualquer software adicional instalado, um agente de compilação pode compilar um aplicativo do Visual C# WPF básico.

No entanto, você deve instalar software adicional para compilar a outros tipos de projetos. Por exemplo, você deve instalar Visual Studio para compilar um projeto de instalação.

Para garantir que o agente de compilação pode compilar seus projetos

  1. Instalar qualquer versão e edição do Visual Studio sua equipe usa no computador no qual o agente de compilação estiver em execução.

  2. Instale outros softwares e componentes que são instalados em seu ambiente de desenvolvedor e que são necessárias para criar o seu aplicativo.

Instalar o Software necessário para executar outras tarefas

Para um agente de compilação realizar várias outras tarefas, talvez seja necessário software adicional instalado na máquina de compilação. A tabela a seguir identifica algumas tarefas comuns de agente de compilação e o software que é necessário para executar essas tarefas.

Para o to… do agente de compilação

O software a seguir deve ser instalado sobre o computer… do agente de compilação

Crie páginas ASP.Projetos de aplicativo da Web de NET

Visual Studio 2010

Construir projetos do C++

Visual Studio 2010

A execução de testes com os agentes de compilação

Para um agente de compilação executar testes, talvez você precise configurar o agente de compilação para executar interativamente ou instalar um agente de teste, dependendo do tipo de testes que você deseja executar. For more information, see Como: Configurar e executar agendada testes após a criação do aplicativo.

Atribuir marcas de formatação a um agente de compilação

À medida que aumenta a escala do seu sistema de compilação, você provavelmente precisará definir agentes de compilação especializados. Sempre que um agente de compilação possui recursos especiais ou destina-se um tipo específico de uso, você deve atribuir uma ou mais marcas para esse agente. Dessa forma, quando um membro da equipe cria uma definição de compilação que requer um determinado tipo de agente de compilação, eles poderão especificar a marca em sua definição de compilação.

Você pode aplicar mais de uma marca a um agente de compilação. Por exemplo, você poderia criar um agente de compilação com as marcas x86 e o lançamento para indicar um agente que é configurado para compilar a configuração de liberação de um aplicativo de 32 bits.

Se você executar vários agentes de compilação na mesma máquina de compilação, provavelmente todos eles terão os mesmos recursos. Portanto, você provavelmente desejará aplicar as mesmas marcas para todos os agentes de compilação nessa máquina de compilação.

Use marcas para representar os recursos do agente de compilação

A tabela a seguir oferece exemplos de nomes de marcas e as capacidades de agente de compilação que eles poderiam representar.

Você pode aplicar as seguintes marcas para a construção agent…

Para identificar um agente de compilação pode …

x86

Compilar aplicativos de 32 bits

x64

Compilar aplicativos de 64 bits

IIS

Compile um aplicativo ASP.NET e, em seguida, testar e hospedá-lo no computador de compilação no qual o agente de compilação está sendo executado.

teste de estresse

Um agente de compilação que está sendo executado em um computador de compilação no qual Test Professional 2010 foi configurado para execução de carga e testes de estresse.

Use marcas para balancear a carga do processo de compilação

Você pode usar marcas para equilibrar a carga da compilação, processamento de trabalho que sua equipe deve executar. Por exemplo, você pode ter uma definição de compilação é chamada de Check-in Build valida seus check-ins. (For more information, see Definir uma compilação Gated Check-In para validar as alterações.) A definição de compilação é executada com freqüência e somente uma instância dela pode ser executada ao mesmo tempo. Portanto, você configurar uma máquina de compilação que possui o hardware de alto desempenho (como, por exemplo, um processador multi-core rápida e uma unidade de disco rígido rápida). Em seguida, criar um agente de compilação nessa máquina e atribuí-lo o check-in de marca. Você pode configurar a definição de compilação para ser executado somente em um agente de compilação que possui a marca de seleção.

Você tem outra definição de compilação chamada Fast Track construir, que podem ser usados para processar as compilações de um projeto de alta prioridade que uma equipe está trabalhando. Configure o outro agente de compilação que atenda os requisitos deste projeto especial. Atribuir a ele a marca FastTrack e configurar a definição de compilação para ser executado somente em um agente de compilação que possui essa marca.

Para aplicar uma marca a um agente de compilação em uma máquina cliente

  1. Sobre o Build menu, clique em Gerenciar controladores de construir.

    O Gerenciar controladores de Build caixa de diálogo aparece.

  2. Clique no agente de compilação ao qual você deseja aplicar uma marca e, em seguida, clique em Propriedades.

    O Build Agent Properties caixa de diálogo aparece.

  3. Para aplicar uma ou mais marcas, use um dos seguintes métodos:

    • Selecione uma ou mais marcas na lista.

    • Clique o Adicionar nova marca link. No Adicionar nova marca caixa de diálogo, digite o nome da marca que você deseja aplicar.

Para aplicar uma marca a um agente de compilação na máquina de compilação

  1. Faça logon no computador que executa o agente de compilação que você deseja modificar.

  2. Clique em Iniciar, clique em Todos os programas, clique em Microsoft Team Foundation Server 2010e em seguida, clique em Console de administração do Team Foundation.

    O Console de administração do Team Foundation aparece.

  3. No painel da árvore, expanda o nome do servidor e clique no Team Foundation Build nó.

  4. Imediatamente abaixo do nome do agente de compilação, clique em Propriedades.

    O Build Agent Properties caixa de diálogo aparece.

  5. Para aplicar uma ou mais marcas, use um dos seguintes métodos:

    • Selecione uma ou mais marcas na lista.

    • Clique o Adicionar nova marca link. No Adicionar nova marca caixa de diálogo, digite o nome da marca que você deseja aplicar.

Remover um agente de compilação

Você pode remover um agente de compilação por meio de uma máquina cliente ou diretamente a partir do computador que hospeda o agente de compilação.

Notaremover o agente de compilação oferece não desinstalar Serviço Team Foundation Build da máquina de compilação.

Para remover um agente de compilação por meio de uma máquina cliente

  1. Sobre o Build menu, clique em Gerenciar controladores de construir.

    O Gerenciar controladores de Build caixa de diálogo aparece.

  2. Clique no controlador de compilação ou de um agente de compilação que você deseja remover e clique em Excluir.

Para remover um agente de compilação de sua máquina de compilação

  1. Faça logon no computador que executa o agente de compilação que você deseja modificar.

  2. Clique em Iniciar, clique em Todos os programas, clique em Microsoft Team Foundation Server 2010e em seguida, clique em Console de administração do Team Foundation.

    O Console de administração do Team Foundation aparece.

  3. No painel da árvore, expanda o nome do servidor e clique no Team Foundation Build nó.

  4. Imediatamente abaixo do nome do agente de compilação, clique em Excluir.

Consulte também

Outros recursos

Criar e trabalhar com definições de compilação

Criar e trabalhar com definições de compilação