Compartilhar via


Uma compilação de fila

Depois que você definir os seus processos de compilação criando uma ou mais definições de compilação, você pode começar a colher os benefícios do seu sistema de compilação.A maioria dos processos de compilação são definidos com disparadoresautomático.Se sua definição de compilação tem um acionador manual ou automático, você pode, manualmente, colocar uma compilação em fila sempre que necessário.

Tarefas comuns

Conteúdo suportado

Enfileire uma compilação pública se você deseja compilar a versão mais recente do código fonte no servidor de controle de versão.

Para enfileirar uma compilação pública em um prompt de comando, use o comando TFSBuild start.

Enfileire uma compilação particular se você deseja compilar as alterações que você fez em um check-in particular.Você pode usar uma compilação particular (também conhecida como uma "compilação companheira") para validar alterações no seu código antes de você verificá-lo.

Para enfileirar uma compilação particular provada em um prompt de comando, use o comando TFSBuild start com a opção /shelveset.

Repita uma compilação concluída se você deseja enfileirar uma compilação pública ou particular usando as mesmas opções de uma compilação concluída.

Repetir uma compilação concluída

Compilações Públicas

Independentemente de um acionador automático ser especificado em uma definição de compilação, você pode, manualmente, colocar a compilação na fila.

Permissões Necessárias

Para seguir este procedimento, sua permissão de Enfileirar as compilações deve ser definida como Permitir.Para obter mais informações, consulte Team Foundation Permissões do servidor.

Para enfileirar uma compilação pública do Visual Studio

  1. No Team Explorer:

    1. Se você ainda não estiver conectado ao projeto de equipe no qual deseja trabalhar, conecte-se ao projeto de equipe.

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

    3. Na página Construtores, em baixo de Definições de Compilação favorita ou Todas as Definições de Compilação, abra o menu de atalho para uma definição de compilação, e então clique em Enfileirar Nova Compilação.

    A caixa de diálogo Fila de CompilaçãoTeamProjectName aparece.

  2. Na lista Definição de compilação, a definição de compilação está selecionada e sua descrição é exibida abaixo.Se você deseja colocar na fila uma diferente definição de compilação, você pode selecionar uma da lista.

  3. Na lista O que você deseja compilar?, deixe Últimas fontes selecionada.

  4. (Opcional) Na lista Controlador de compilação, selecione um controlador de compilação que não seja o controlador de compilação padrão.

  5. (Opcional) Na lista Prioridade na fila, selecione um dos seguintes valores: Alto, Acima do Normal, Normal, Abaixo do Normal ou Baixo.

    A caixa Posição exibe a posição estimada da compilação na fila.

  6. (Opcional) a caixa de Pasta-depósito para esta compilação exibe o local onde a saída como binários e arquivos de log são armazenadas quando a compilação for concluída.Se você desejar armazenar as saídas em locais diferentes, digite o caminho para o local nesta caixa.

    Observação importanteImportante

    Se você alterar esse valor, você deve especificar uma pasta que foi preparada para ser usada como uma pasta-depósito.Você não pode modificar esse valor se você especificou a Saída de compilação de impressão para o servidor como o local de teste para a definição de compilação.

    Consulte Pastas da operação de configuração.

  7. (Opcional) Na guia Parâmetros, veja e sobrescreva outras configurações de definição de compilação somente para essa execução.

    Se a definição de compilação é baseada no Modelo Padrão ou no Modelo de atualização, veja Definir um processo de compilação é baseado no modelo padrão ou Usar processos de construção de legado para obter mais informações sobre esses parâmetros.

  8. Escolha Fila.

Compilações Particulares

Você enfileira uma compilação particular se você deseja compilar as alterações que você fez em um check-in particular.Você pode usar uma compilação particular (também conhecida como uma "compilação companheira") para validar alterações no seu código antes de você verificá-lo.Executando uma compilação particular das alterações antes de você faça o check-in, você pode reduzir a possibilidade que serão quebrados todas as compilações que sua equipe realizar regularmente, como a compilação nocturna.

ms181722.collapse_all(pt-br,VS.110).gifComo Compilações Particulares diferem das Compilações Públicas

Os resultados de uma compilação particular concluída diferem de uma compilação pública concluída nas seguintes maneiras:

  • Uma compilação particular é semelhante a uma compilação de check-in restrita em que você está compilando código que inclui alterações em um check-in particular.Entretanto, suas alterações não serão verificadas automaticamente depois que uma compilação particular como é o caso de uma compilação de check-in restrita.

  • Os parâmetros de processo de compilação seguintes são presumidos como Falso e portanto não tem efeito, independentemente da configuração especificada na definição de compilação:

    • Fontes de Rótulo

    • Criar Item de Trabalho em Caso de Fracasso

    • Associar Conjuntos de Alterações e Itens de Trabalho

  • No Gerenciador de compilação, a compilação concluída aparece ao lado do seguinte ícone: ms181722.Icon_BldPrivateBuild(pt-br,VS.110).gif

  • A compilação concluída é chamada usando o formato BuildEm onde Em é um valor inteiro exclusivo.Esse formato difere do das compilações públicas, que você especifica usando o parâmetro Formato do Número de Compilação.

  • Para cada definição de compilação, você especifica uma diretriz de retenção separada (e opcionalmente diferente) para limitar o número de compilações particulares concluídas que são armazenadas no sistema.

ms181722.collapse_all(pt-br,VS.110).gifEnfileirar uma Compilação Particular

Permissões Necessárias

Para seguir este procedimento, sua permissão de Enfileirar as compilações deve ser definida como Permitir.Para obter mais informações, consulte Team Foundation Permissões do servidor.

Para enfileirar uma compilação particular do Visual Studio

  1. No Team Explorer:

    1. Se você ainda não estiver conectado ao projeto de equipe no qual deseja trabalhar, conecte-se ao projeto de equipe.

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

    3. Na página Construtores, em baixo de Definições de Compilação favorita ou Todas as Definições de Compilação, abra o menu de atalho para uma definição de compilação, e então clique em Enfileirar Nova Compilação.

    A caixa de diálogo Fila de CompilaçãoTeamProjectName aparece.

  2. Na lista Definição de compilação, a definição de compilação está selecionada e sua descrição é exibida abaixo.Se você deseja colocar na fila uma diferente definição de compilação, você pode selecionar uma da lista.

  3. Na lista O que você deseja compilar?, selecione Fontes mais recentes com check-in particular.

    A caixa Nome do check-in particular aparece.

  4. Segue uma dessas etapas:

    • Se você já tiver um check-in particular, digite seu nome na caixa Nome do check-in particular, ou clique no botão reticências () para procurar pelo check-in particular.

    • Se você deseja colocar algumas alterações pendentes do seu espaço de trabalho em um check-in particular e então compilar essas alterações, escolha Criar.

  5. (Opcional) Se você deseja verificar as alterações no check-in particular se a compilação for bem-sucedida, selecione a caixa de seleção Verificar as alterações após compilação com êxito.

    Observação importanteImportante

    Se você selecionar esta caixa de seleção, a compilação é executada como uma compilação de check-in restrita em vez de como uma compilação particular.Para obter mais informações sobre check-in restrito, consulte Definir um processo de compilação Gated Check-In para validar as alterações.

  6. (Opcional) Na lista Controlador de compilação, selecione um controlador de compilação que não seja o controlador de compilação padrão.

  7. (Opcional) Na lista Prioridade na fila, selecione um dos seguintes valores: Alto, Acima do Normal, Normal, Abaixo do Normal ou Baixo.

    A caixa Posição exibe a posição estimada da compilação na fila.

  8. (Opcional) siga estas etapas para especificar a pasta onde a saída, como binários, de compilação serão baixadas:

    ObservaçãoObservação

    Ignore a caixa Pasta-depósito para essa compilação porque não tem efeito em uma compilação particular.

    1. Escolha a guia de Parâmetros e em seguida, expanda o grupo Avançado.

    2. Na caixa Localização de Depósito Particular, digite o caminho UNC para a pasta onde você deseja armazenar as saídas quando a compilação for concluída.

      ObservaçãoObservação
      • Se você não especificar esta pasta, a compilação não irá fracassar, mas um aviso aparecerá no log de compilação.

      • Se você alterar esse valor, você deve especificar uma pasta que foi preparada para ser usada como uma pasta-depósito.Para obter mais informações, consulte Pastas da operação de configuração.

  9. (Opcional) Na guia Parâmetros, veja e sobrescreva outras configurações de definição de compilação somente para essa execução.

    Se a definição de compilação é baseada no Modelo Padrão ou no Modelo de atualização, veja Definir um processo de compilação é baseado no modelo padrão ou Usar processos de construção de legado para obter mais informações sobre esses parâmetros.

  10. Escolha Fila.

Repetir uma compilação concluída

Quando você está testando algumas possíveis alterações para um processo de compilação ou experimentando opções, você pode rapidamente enfileirar uma compilação pública ou particular usando as mesmas opções que você especificou quando você enfileirou a compilação que agora está concluída.

Para repetir uma compilação concluída a partir da página de compilações

  • No Team Explorer:

    1. Se você ainda não estiver conectado ao projeto de equipe no qual deseja trabalhar, conecte-se ao projeto de equipe.

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

    3. Na página de Compilações, em baixo de Minhas Compilações, abra o menu de atalho para uma compilação concluída, e então clique em Repetir compilação.