Criar ou editar uma definição de compilação

Depois que tiver implantado o sistema de compilação, você estará pronto para definir um processo de compilação que compila seu código, executa seus testes e realiza muitas outras funções importantes para a equipe.

1. No From Visual Studio, no Team Explorer, verifique se você está conectado ao projeto da equipe (teclado: Ctrl + 0, C) e, em seguida, abra Compilações (teclado: Ctrl + 0, B).

2. Escolha o link Nova Definição de Compilação ou selecione uma compilação, abra o menu de atalho e escolha Edição de Definição da Compilação.

   Dica

   Se uma mensagem de erro TF225001 for exibida, configure um controlador de compilação.

3. Na guia Geral:

   • Na caixa Nome da definição de compilação, especifique o nome a ser associado à definição de compilação. Consulte Restrições de nomenclatura no Team Foundation.

   • (Opcional) Na caixa Descrição, adicione uma descrição apropriada. Esta descrição fornece informações adicionais para pessoas em sua equipe quando eles estiverem prestes a enfileirar manualmente uma compilação (conforme descrito em Enfileirar uma compilação).

4. Se o processo de compilação ainda não estiver pronto para que a equipe use, em Guia Geral, em Processamento da fila, é possível alterar a configuração padrão Habilitado para:

   • Em pausa permite que as novas compilações sejam enfileiradas por disparadores ou usuários, mas deixa essas compilações em um estado de pausa.

   • Desabilitado impeça que novas compilações sejam enfileiradas por disparadores ou usuários.

5. Na guia Disparador, especifique o evento no qual você deseja que a definição de compilação seja executada. Consulte Especificar disparadores e razões de compilação.

6. Na guia Configurações da Origem:

   • TFVC: na tabela Pastas de trabalho, especifique as pastas de controle de versão que contêm os arquivos exigidos pelo processo de compilação.

     Dica

     Para garantir que o processo de compilação funcione corretamente e melhorar o desempenho, inclua todas as pastas, e apenas essas pastas, que contenham arquivos exigidos pelo processo de compilação.Consulte Trabalhar com espaços de trabalho de compilação.

   • Git: especifique o repositório e as ramificações que contêm os arquivos exigidos pelo processo de compilação.

     Dica

     Na lista de ramificações monitoradas para CI (integração contínua) e as compilações progressivas, é possível usar caracteres curinga.Por exemplo, você pode especificar refs/heads/feature* para monitorar as ramificações refs/heads/featureA e refs/heads/featureB.

7. Na guia Padrões de Compilação, se mais de um controlador de compilação for exibido na lista Controlador de compilação, escolha o controlador de compilação que você deseja que o sistema de compilação use para processar essa definição de compilação.

   Se a coleção do projeto da equipe estiver hospedada no Visual Studio Online e as necessidades da equipe puderem ser atendidas por um único agente de compilação padrão, selecione Controlador de Compilação Hospedado. Consulte Controlador de compilação hospedada.

8. Na guia Padrões de Compilação, escolha uma das seguintes opções Local de preparo para especificar como você deseja que o processo de compilação produza e armazene arquivos de saída como, por exemplo, binários compilados e arquivos de log:

   • Esta compilação não copia arquivos de saída para uma pasta-depósito: escolha essa opção se você não precisar de arquivos de saída.

   • Copiar saída da compilação para a seguinte pasta-depósito: escolha essa opção se você quiser copiar arquivos de saída para uma pasta-depósito em um servidor de compartilhamento de arquivos. Na caixa, digite o caminho do arquivo UNC para a pasta onde você deseja que o sistema de compilação coloque os arquivos de saída. Você deve especificar uma pasta que foi preparada para ser usada como uma pasta-depósito. Consulte Pastas da operação de configuração.

   • Copiar saída de compilação para o servidor: escolha essa opção para copiar a saída compilada para o Team Foundation Server.

9. Na guia Processo, especifique detalhes sobre quais funções essa compilação realiza e como:

   • Para definir uma compilação simples, escolha Mostrar detalhes e, na lista Arquivo do processo de compilação, escolha Modelo Padrão. Consulte Usar o modelo padrão no processo de compilação.

   • Se a equipe tiver definido um modelo personalizado que você deseja usar, escolha Mostrar detalhes e, em seguida, selecione o modelo na lista Arquivo do processo de compilação. Consulte Personalizar seu modelo de processo de compilação.

10. Na guia Política de Retenção, é possível especificar quantas compilações concluídas você deseja manter. É possível modificar dois conjuntos de políticas de retenção na lista Especificar como as compilações devem ser retidas e atender às necessidades da equipe:

    • O grupo Disparado e Manual de políticas limita o que o sistema mantém dessas compilações que foram enfileiradas manualmente ou por um disparador automático.

    • O grupo Particular de políticas limita o que o sistema mantém dessas compilações que foram enfileiradas manualmente no código-fonte em um check-in particular (conforme descrito em Enfileirar uma compilação).

    Para modificar uma política de retenção para compilações concluídas Parado, Falha, Parcialmente Bem-Sucedido, ou Êxito, siga uma ou todas as seguintes etapas:

    • Escolha o valor na coluna Política de Retenção e escolha uma das seguintes opções: Manter Todos, Manter Somente o Mais Recente, Manter os 2 Últimos, Manter os 5 Últimos, Manter os 7 Últimos, Manter os 10 Últimos ou Especificar Contagem a ser Mantida.

    • Escolha o valor na coluna O que Excluir e escolha um valor. Para obter mais informações sobre esses valores, consulte Excluir uma compilação concluída.

11. Quando concluir o trabalho na definição de compilação, no menu Arquivo, escolha Salvar <Nome da Definição de Compilação> (teclado: Ctrl + S).

    A definição de compilação criada é exibida na página Compilações do Team Explorer. Consulte Executar, monitorar e gerenciar compilações.