Demonstra Passo a passo: Criando uma definição de compilação no Team Foundation Build

Artigo
08/25/2010

[Observação: Este tópico é pré-versão documentação e está sujeitas a alterações em versões futuras. Tópicos em branco são incluídos sistema autônomo espaços reservados.]

Esta explicação passo a passo mostra como configurar uma definição de compilação para Team Foundation Build. Antes de iniciar esta explicação passo a passo, é importante ter algum conhecimento básico de Team Foundation Build. Para obter mais informações, consulte Compilações de gerenciamento com o Team Foundation Build.

Nesta explicação passo a passo, você depurar o processo de configuração de uma definição de compilação, usando o Criar definição caixa de diálogo.Você também vai estabelecer as permissões necessárias para o agente de compilação e os usuários que executarão as definições de compilação recém-criado.Nesta explicação passo a passo, você irá concluir as seguintes tarefas:

Crie uma nova definição de compilação.
selecionar as soluções para compilação.
selecionar um local de compilação agente e soltar.
selecionar as etapas de criação.
selecionar uma configuração e as plataformas para compilação.
Estabelece permissões sobre o agente de compilação.
Estabelece permissões para usuários especificados que permitirá executar a definição de compilação recém-criado.

Pré-requisitos

Visual Studio Team System Team Foundation Server.
Uma conexão com um Team Foundation Server e at least um projeto da equipe existente. Para obter mais informações, consulte Demonstra Passo a passo: Ingressar em um projeto de equipe e Como: Criar um projeto de equipe.
Um espaço de trabalho no servidor de controle de fonte que contém pelo menos uma solução para compilação.Para obter mais informações, consulte Como: Criar um espaço de trabalho mapeado.

Permissões necessárias

Para concluir esta explicação passo a passo, você deve ter o Administrar uma compilação permissão definido como Permitir.Além disso, a camada aplicativo de serviço conta e o Team Foundation Build conta de serviço deve ter permissões de leitura/gravar para o local de soltar compilação. Para obter mais informações, consulte Team Foundation servidor Permissões.

Para criar uma nova definição de compilação

In Team Explorer, selecionar o projeto para o qual você deseja criar uma nova definição de compilação.
Sobre o Compilação menu, selecionar Nova definição de compilação.

The definição de compilação caixa de diálogo aparece com Geral selecionado.

Dica:

As guias que têm um ícone de aviso ao lado o requerem entrada.
Especifique o nome que você deseja associar a definição de compilação no Criar nome de definição caixa de texto.

O nome digitado deve ser um nome de arquivo exclusivo e válido do Windows.
Adicionar uma descrição apropriada no Descrição caixa de texto.

Essa descrição é exibida no Criar fila "< nome de projeto da equipe >" caixa de diálogo.Para obter mais informações, consulte Como: Fila ou iniciar uma definição de compilação.
clicar no Espaço de trabalho guia.

The Pastas de trabalhoPor padrão, tabela inclui a controle do código-fonte pasta para o projeto da equipe para o qual você está criando as novas definições de compilação.Uma pasta local que reflete o controle do código-fonte hierarquia é criada no agente de compilação.The Pasta local coluna lista a pasta local no agente de compilação.Todos os caminhos de espaço de trabalho no agente de compilação são mapeados em relação à diretório raiz padrão mostrada.
Para copiar um espaço de trabalho existente à lista de pastas de trabalho, clicar no Copiar espaço de trabalho existente botão para inicialização o selecionar um espaço de trabalho caixa de diálogo.

O espaço de trabalho que você selecionar é normalizado para o diretório raiz comum no agente de compilação.

Você também pode clicar em uma célula de tabela vazia no controle do código-fonte Pasta e, em seguida, clique sistema autônomo reticências (…) para navegar até um controle do código-fonte pasta para adicionar sistema autônomo uma pasta de trabalho.A pasta de controle de fonte que você selecionar também é normalizada para o diretório raiz comum no agente de compilação.
clicar no Arquivo de projeto guia.Sobre o Arquivo de projeto painel, você pode procurar um arquivo de projeto TFSBuild.proj existente ou inicialização o Assistente para criação de arquivo de projeto MSBuild para criar um novo arquivo TFSBuild.proj.

Dica:
As guias que têm um ícone de aviso ao lado o requerem entrada.

Para navegar para um arquivo TFSBuild.proj existente, clicar Procurar.Sobre o Procurar pasta caixa de diálogo, selecionar um existente definição de compilação do TeamBuildTypes pasta e, em seguida, clicar OK.

O arquivo TFSBuild.proj agora é compartilhado entre o existente e nova definição de compilação.

Se um arquivo foi encontrado, TFSBuild.proj texto, Arquivo de projeto MSBuild encontrado: TFSBuild.proj , aparece no Arquivo de projeto painel.Se não encontrar um arquivo de projeto, a Arquivo de projeto painel exibe texto de aviso e aconselha a criar um novo MSBuild arquivo de projeto.

Observação importante:
Qualquer alterar feita em um arquivo TFSBuild.proj compartilhado personaliza todas as definições de compilação ao qual o arquivo está associado.Para obter mais informações, consulte Personalização do Team Foundation compilação.

Para criar um novo arquivo de projeto para sua definição de compilação, clicar Criar.

The Assistente para criação de arquivo de projeto MSBuild aparece.

Sobre o selecionar e ordene soluções para compilação, selecionar as soluções para compilação.Para solicitar as soluções de, selecionar uma solução única e use as teclas de seta à direita da lista para alterar sua localização na ordem de compilação.

Cuidado:
Estar ciente de uma solução com dependências no outro ao determinar a ordem na qual são criados.Por exemplo, se solução tem uma dependência da solução, defina Solution1 compilação antes da solução.

Clique em Next.

The Selecionar configurações de compilação página é exibida.
Na grade em Quais configurações você deseja criar, selecionar a configuração desejada e plataformas para incluir em definições de compilação.A configuração da compilação indica a configuração e plataforma, por exemplo, versão e qualquer CPU.

Observação:

Se você estiver criando uma definição de compilação para projetos da Web, selecionar Plataformas mistas.
Clique em Next.

The selecionar as opções de compilação página é exibida.

Observação:
Se você estiver criando uma definição de compilação para projetos da Web, selecionar Plataformas mistas.

Indicate the build options that you want to enable by selecting the Run test **(e.g. executar BVTs, etc..) and Executar análise de códigocaixas de seleção de , conforme apropriado.**Se o Executar teste (por exemplo, executar da teste de verificação pós-compilação, etc..) está selecionada, use sistema autônomo opções de lista suspensa para especificar o Arquivo de metadados de teste and lista de testes para executar conforme apropriado.

Para obter mais informações, consulte Usando listas de teste e Escrevendo código de qualidade.

Observação importante:
Para executar testes, Test Edition deve ser instalado no agente de compilação. Para executar a análise de código, Development Edition deve ser instalado no agente de compilação.

Clique em Finish.

The Arquivo de projeto painel do definição de compilação caixa de diálogo é exibida.O arquivo TFSBuild.proj criado está armazenado em $ < projeto da equipe > \TeamBuild Types\ < compilação Type nome>\TFSBuild.proj em controle do código-fonte.

clicar no Retenção diretiva guia.
1. Sobre o Especificar como devem ser mantidas compilações lista, você pode selecionar a retenção diretiva para falhou, parado, constrói parcialmente bem sucedida e totalmente bem sucedida.
2. selecionar uma política de retenção na lista suspensa.
  
  Se você selecionar <Especificar Contagem para Manter > the Número de compilações caixa de diálogo é exibida.
3. Sobre o Especifique o número de compilações para reter caixa de texto, indicam quantas compilações você deseja manter o resultado de compilação especificada.

clicar no Construir padrões guia.

Sobre o Construir padrões painel que você pode escolher um agente de compilação existente entre o Agente de compilação na lista suspensa.
Se nenhum agente de compilação existe ou você deseja criar um novo, clicar Novo.

The agente de compilação Properties caixa de diálogo é exibida.
Preencha as caixas de texto para nome para exibição, Descrição and Nome do computadore clicar OK.

Para obter mais informações, consulte Como: Criar e gerenciar agentes de compilação.

No Compilações serão ser transferidas para o seguinte compartilhamento (por exemplo, \\servidor\compartilhamento) texto, digite o local UNC (\\servidor\compartilhamento).sistema autônomo binários internos e sistema autônomo arquivos de log estará localizados nesta pasta assim que termina a compilação.

Observação importante:
Antes de concluir esta etapa, você deve primeiro criar uma pasta pública no computador do agente de compilação no qual o TFSService conta tem direitos totais.Para obter mais informações sobre o Team Foundation contas de serviço, consulte Como: Modo de exibição Team Foundation servidor Services.

Observação:
Cada compilação gerada será descartada em um diretório separado.Você precisará garantir que a conta com a compilação computador está configurado tenha acesso de gravar para este local UNC.

clicar no disparar guia.
1. Sobre o disparar painel, selecionar Check-ins não disparam uma nova compilação para criar somente sob demanda.
2. selecionar Criar cada check-in (mais compilações) construam continuamente sempre que uma alterar está check-in para os arquivos que são criados pela sua definição de compilação.
3. selecionar Acumular check-ins até que a compilação anterior seja concluída (menos compilações) para criar sem interrupção se baseia.
  
  Se você marcou o Acumular check-ins até que a compilação anterior seja concluída (menos compilações) caixa de seleção, você pode indicar a freqüência compilações ocorrem, selecionando o Compilação não mais freqüentemente que cada caixa de seleção e inserindo um número no minutos caixa de texto.O intervalo válido para o minutos caixa de texto de é de 0 a 2147483647 (Int32 MaxValue).
4. selecionar compilação cada semana nos seguintes dias criar agendada compilação s.selecionar cada dia em que você deseja compilação usando as caixas de seleção fornecidas para cada dia da semana.Digite o time de compilação no A compilação na padrão criar agente em fila caixa de texto.
  
  Observação:
  
  Compilações programadas não ocorrerá se nenhuma alteração tiver sido verificada desde a compilação anterior.
clicar OK para criar sua definição de compilação depois de preencher as informações necessárias.

A definição de compilação criada é exibida no Compilações pasta Team Explorer.

Observação:
Compilações programadas não ocorrerá se nenhuma alteração tiver sido verificada desde a compilação anterior.

Para ler informações armazenadas no servidor para sua definição de compilação, clicar com o botão direito do mouse no Team Explorer e clique em edição definição de compilação.

The definição de compilação caixa de diálogo é exibida com as informações preenchidas.Você também pode alterar as informações digitadas.Para obter mais informações, consulte Como: edição uma definição de compilação.

Observação importante:
Se sua definição de compilação compartilha um arquivo TFSBuild.proj com outra construção, sua definição de compilação e os arquivos associados não são exibidos no Gerenciador de controle de fonte no localização padrão, a TeamBuildTypes pasta.Somente a definição de compilação original é listada.Você também pode armazenar o arquivo TFSBuild.proj em outro local.

Para estabelecer as permissões de compilação

Entre em contato com o administrador do sistema para o computador de construção selecionado anteriormente para determinar o nome da conta sob a qual o serviço Visual Studio Team Foundation compilação está sendo executado.
De Equipe menu, selecionar Configurações do projeto da equipee, em seguida, selecionar associações de agrupar.

The Grupos projeto caixa de diálogo é exibida.
In Grupos projeto, sob o Os usuários e grupos listando, localizar o agrupar chamado Criação de serviçose clicar Propriedades.

The Equipe Foundation servidor agrupar Properties caixa de diálogo é exibida.
selecionar o Membros guia.

Se a conta obtida na etapa anterior está presente na lista de membros e, em seguida, o computador de construção selecionado pode criar a definição de compilação.Caso contrário, use as seguintes etapas:
No Adicionar membro seção, escolher Windows usuário ou agrupare clicar Adicionar.

The Selecionar usuários ou grupos caixa de diálogo é exibida.

In Selecionar usuários ou grupos diálogo, digite a conta associada o serviço Visual Studio Team Foundation Build no computador de compilação usado para esta definição de compilação.

Observação:
Se essa definição de compilação é construída em vários agentes de compilação, todas sistema autônomo contas de serviço Visual Studio Team Foundation Build precisará ser adicionado sistema autônomo membros do agrupar de 'Construir serviços' neste projeto.