Criando uma Definição de Compilação para o Team Foundation Server 2010

Antes de poder compilar seu aplicativo, primeiro você deve criar uma definição de compilação que especifica qual projeto Ant ou Maven compilar e onde as compilações devem ocorrer. Depois de criar uma definição de compilação, você pode por compilações na lista de espera.

Quando você criar definições de compilação para Visual Studio Team Foundation Server 2010,você pode especificar o gatilho que causa a compilação a ser colocada fila automaticamente ou você pode executar essas compilações manualmente. Para obter mais informações, consulte Colocando na fila uma Compilação para o Team Foundation Server 2010 (Team Explorer Everywhere).

Para criar uma definição de compilação para Team Foundation Server 2010, você executa as seguintes tarefas:

• Abrir a caixa de diálogo Definição de Compilação

• Especifique um Nome e Descrição para a Definição de compilação.

• Especifique o Disparador da Compilação

• Especifique as Pastas de Trabalho para Incluir na Compilação

• Especifique as Configurações padrão para a compilação.

• Especifique o local do Arquivo do Projeto

• Especifique Política de retenção para a Compilação.

• Salve a Definição de Compilação

Observação
Você deveria concluir as seções deste processo em ordem. A tarefa é dividida em procedimentos menores para melhorar a legibilidade.

Permissões Necessárias

Para executar este procedimento, você deve ter a permissão de Editar definição de compilação definidas para Permitir. Para obter mais informações, consulte a seguinte página no site da Microsoft: Permissões do Team Foundation Server.

Abrir a caixa de diálogo Definição de Compilação

1. Em Team Explorer, expanda o projeto de equipe que você deseja criar uma definição de compilação.

2. Clique com o botão direito no nó Compilações e clique em Nova Definição de Compilação.

   A caixa de diálogo Definição da Compilação aparece. A guia Geral está ativa.

   Depois, especifique um nome e descrição para sua definição de compilação.

Especifique um Nome e Descrição para a Definição de compilação.

1. Clique na guia Geral.

2. Em Nome da definição de compilação, digite o nome que você deseja dar esta definição de compilação.

   O nome especificado devem ser únicos no projeto de equipe.

3. (Opcional) Em Descrição, forneça uma descrição para esta definição de compilação.

4. (Opcional) Se você deseja desabilitar esta definição de compilação, clique em Desabilitar esta definição de compilação.

   Por exemplo, você pode fazer isto se desejar definir uma compilação automatizada, mas não estar pronto ainda para aquela compilação ser executada automaticamente.

Depois, especifique o gatilho de compilação para definir quando uma compilação deve ser executada.

Especifique o Disparador da Compilação

Você pode especificar um dos cinco tipos de disparadores de compilação com Team Foundation Server 2010:

• Compilação sob demanda (disparo manual)

• Compile continuadamente em cada check-in. Se o agente de compilação não terminou de executar uma compilação anterior, a nova compilação será colocada na fila.

• Cada check-in deve acrescentar uma compilação à fila para ser executado assim que um agente esteja livre.  Isto também pode ser limitado para que um tempo mínimo entre as compilações seja fornecido. Você pode escolher esta opção se sua compilação levar muito tempo e se você tiver um grande números de check-ins que resultariam em um número inaceitável de compilações na fila de compilação.

• Compilações de check-in com Barreira. Quando uma compilação de check-in com barreira for criada, as alterações que você envia são colocadas em um check-in particular e são compiladas automaticamente no seu sistema de compilação. A compilação deve ter êxito para que o processo de check-in a seja concluído.

• Compilações agendadas (diariamente).  Você pode especificar os dias e a hora que a compilação será executada. Você também pode forçar a compilação a sempre executar naquele horário, até mesmo se nenhuma alteração foi executada no período intermediário.

  Observação
  Se você criar a definição de compilação em um computador que está em um fuso horário diferente do computador no qual as compilações executarão, a compilação pode ser executada em um horário inesperado durante um período onde o horário de verão de dois fusos é diferente.

Para criar uma definição de compilação disparada sob demanda

1. Clique na guia Disparador.

2. Clique em Check-ins não disparam uma nova compilação.

3. Clique em OK para salvar a definição de compilação para o servidor.

   Você deveria executar uma compilação de teste para verificar se a sua definição de compilação está funcionando como espera. Para obter mais informações, consulte Colocando na fila uma Compilação para o Team Foundation Server 2010 (Team Explorer Everywhere).

Para criar uma definição de compilação que compila continuamente em cada check-in

1. Clique na guia Disparador.

2. Clique em Compilar cada check-in.

3. Clique em OK para salvar a definição de compilação para o servidor.

   Você deveria executar uma compilação de teste para verificar se a sua definição de compilação está funcionando como espera. Para obter mais informações, consulte Colocando na fila uma Compilação para o Team Foundation Server 2010 (Team Explorer Everywhere).

Para criar uma definição de compilação que compila continuamente enquanto os agentes estiverem disponíveis

1. Clique na guia Disparador.

2. Clique em Accumular check-ins até que a compilação anterior esteja finalizada.

3. (Opcional) Se você deseja restringir mais a frequência de compilações, marque a caixa de seleção Frequencia de compilação igual ou inferior aos outros. Na caixa minutos , especifique o número mínimo de minutos que você deseja transcorrer entre as compilações.

4. Clique em OK para salvar a definição de compilação para o servidor.

   Você deveria executar uma compilação de teste para verificar se a sua definição de compilação está funcionando como espera. Para obter mais informações, consulte Colocando na fila uma Compilação para o Team Foundation Server 2010 (Team Explorer Everywhere).

Para criar uma compilação de check-in com barreira

1. Clique na guia Disparador.

2. Clique em Check-in com Barreira – só aceitará check-ins se as alterações enviadas mesclarem e compilarem com êxito. Para obter mais informações sobre check-ins com barreira, consulte Faça Check-in das Alterações Pendentes que São Controladas por uma Check-in de Compilação com Barreira (Team Explorer Everywhere).

3. Clique em OK para salvar a definição de compilação para o servidor.

   Você deveria executar uma compilação de teste para verificar se a sua definição de compilação está funcionando como espera. Para obter mais informações, consulte Colocando na fila uma Compilação para o Team Foundation Server 2010 (Team Explorer Everywhere).

Para criar uma definição de compilação que compila em uma cronograma especificado

1. Clique na guia Disparador.

2. Clique em Compilar semanalmente durante os próximos dias.

3. Selecione as caixas de seleção que correspondem aos dias que você deseja que a compilação seja executada.

4. Em Colocar a compilação no agente de compilação padrão em, especifique a hora à que você deseja que a compilação seja colocada na fila.

5. (Opcional) Marque a caixa de seleção Compilar mesmo se nada foi mudado desde a última compilação.

6. Clique em OK para salvar a definição de compilação para o servidor.

   Você deveria executar uma compilação de teste para verificar se a sua definição de compilação está funcionando como espera. Para obter mais informações, consulte Colocando na fila uma Compilação para o Team Foundation Server 2010 (Team Explorer Everywhere).

Depois, especifique as pastas de trabalho que você deseja incluir na compilação.

Especifique as Pastas de Trabalho para Incluir na Compilação

Nesta guia, especifique as pastas para incluir na compilação. Cada caminho é mapeado para um local relativo embaixo de um diretório de compilação raiz no agente de compilação, que é referenciado como $ (SourceDir). O agente de compilação será executado em um sistema operacional Windows. Portanto, os caminhos relativos de Pasta Local devem ser fornecidos usando convenções de nomenclatura para diretórios de Windows. Por exemplo, você deve usar a barra invertida (\) como um separador de caminho.

Por padrão, o projeto de equipe inteiro é incluído, mas você pode considerar a inclusão apenas das pastas que são necessárias à sua definição de compilação. Fazendo isto, você pode reduzir o número de arquivos que são baixados do controle de versão para executar a compilação.

1. Clique na guia Espaço de Trabalho.

2. Para alterar as Pastas de trabalho, execute uma das seguintes tarefas:

   • Para copiar outra definição de espaço de trabalho Team Foundation Server clique em Copiar Espaço de Trabalho Existente e então especifique o espaço de trabalho que você deseja copiar.

   • Para adicionar uma pasta de trabalho, clique em Clique aqui para inserir uma nova pasta de trabalho. Especifique uma Pasta de Controle do Código-Fonte e uma Pasta Local para cada pasta de trabalho que você adiciona. Você pode clicar navegue (...) para especificar as pastas.

   • Para excluir uma pasta de trabalho, clique com o botão direito na pasta que você deseja excluir e clique em Excluir.

Depois, especifique as configurações padrão da compilação.

Especifique as Configurações padrão para a compilação.

Você deve especificar um controlador de compilação e um local para colocação onde a saída de compilação será organizada.

1. Clique na guia Padrões de Compilação.

2. Em Controlador de Compilação, especifique o agente de compilação que você deseja usar na definição de compilação.

3. Marque a caixa de seleção Esta compilação copiará arquivos de saída para uma pasta-depósito se ela já não estiver marcada.

4. Em As compilações serão preparadas no seguinte compartilhamento, forneça um caminho válido a um compartilhamento de arquivo Windows (ou um compartilhamento Samba). O servidor de compilação copiará a compilação produzida a este caminho.

   Você deve especificar o caminho no formato da Convenção universal de nomenclatura (UNC), como \\NomeServidor\Compartilhamento.

Depois, especifique o local do arquivo de projeto.

Especifique o local do Arquivo do Projeto

Team Foundation Build usa um script MSBuild que é nomeado TFSBuild.proj para controlar o processo de compilação. Você usa a guia Arquivo do Perfil para procurar por um arquivo TFSBuild.proj existente no controle da versão ou para criar um novo arquivo TFSBuild.proj que você associa com a definição de compilação. Se duas ou mais definições de compilação compartilharem um único arquivo TFSBuild.proj, sua personalização afetará cada definição de compilação.

Você pode especificar uma pasta que contém um arquivo TFSBuild.proj existente ou você pode criar um novo arquivo TFSBuild.proj a partir um arquivo de compilação existente do Ant (Build.xml) ou um Projeto de modelo de objeto do Maven (pom.xml).

Se você deve gerenciar uma definição de compilação de um cliente Visual Studio 2005, você deve armazenar o arquivo de projeto em uma pasta chamada TeamBuildTypes na raiz do projeto de equipe no controle de versão. Se todos os colaboradores da compilação estiverem usando o Visual Studio 2008, Visual Studio 2010, ou o Plug-in do Team Foundation Server para Eclipse, a pasta de compilação pode existir em qualquer lugar dentro do projeto de equipe em controle de versão.

Para especificar um arqui TFSBuild.proj existente

1. Clique na guia Arquivo de Projeto.

2. Clique em Procurar para especificar a pasta de controle de versão que contenha o arquivo de TFSBuild.proj que você deseja usar.

Para criar um arquivo TFSBuild.proj

1. Clique na guia Arquivo de Projeto.

2. Clique em Procurar para especificar a pasta de controle de versão na qual você deseja criar o novo arquivo de TFSBuild.proj.

3. Clique em Create.

   O Assitente de Criação de Configuração de Compilação aparece.

4. Na lista Assistentes, clique em Configuração MSBuild de um Arquivo de Compilação Ant Existente ou Configuração MSBuild de um Arquivo de Compilação Maven POM Existente.

5. Clique em Next.

6. Em Arquivo de Compilação, especifique o arquivo de compilação Ant ou Maven POM no servidor de controle de versão.

7. Clique em Finish.

   Um novo arquivo TFSBuild.proj é criado do arquivo de compilação Ant ou do arquivo POM Maven.

Depois, especifique uma diretiva de retenção de compilação para indicar quanto tempo devem ser mantidas as compilações.

Especifique Política de retenção para a Compilação.

Para cada status de compilações concluídas, você pode especificar um número de compilações daquele tipo que serão retidas automaticamente. Para compilações definidas como Team Foundation Server 2010, você pode especificar uma diretiva de retenção para compilações disparadas e manuais e outra diretiva para compilações particulares.

1. Clique na guia Diretiva de Retenção.

2. Sob Diretiva de Retenção, clique na opção apropriada próximo a cada status de compilação para especificar quantas compilações devem ser mantidas.

   Você pode clicar em Especificar Contagem a Manter e então especificar um número específico de compilações se nenhum dos valores fornecidos satisfazem seus requisitos.

   Observação
   Usuários podem subtituir a diretiva de retenção para uma ou mais compilações em Gerenciador de Compilação especificando o Reter Indefinidamente. Para obter mais informações, consulte Retain a Build Indefinitely.

Salve a Definição de Compilação

• Na caixa de diálogo Definição de Compilação , clique em OK.

  A definição de compilação é salva no servidor.

Você deveria executar uma compilação de teste para verificar se a sua definição de compilação está funcionando como espera. Para obter mais informações, consulte Colocando na fila uma Compilação para o Team Foundation Server 2010 (Team Explorer Everywhere).

Consulte também

Outros recursos

Criando e trabalhando com Definições de Compilação (Team Explorer Everywhere)

Criando uma Definição de Compilação para o Visual Studio 2005 Team Foundation Server

Criando uma Definição de Compilação para o Team System 2008 Team Foundation Server