Configurar e pagar por trabalhos paralelos

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Este artigo descreve o modelo de licenciamento do Azure Pipelines no Team Foundation Server 2018 (TFS 2018) ou mais recente. Não cobramos você pelo Team Foundation Build (TFBuild), desde que você tenha uma CAL (Licença de Acesso para Cliente) do TFS.

Um trabalho paralelo do TFS oferece a capacidade de executar uma única versão de cada vez em uma coleção de projetos. Você pode manter centenas ou até milhares de trabalhos de lançamento na sua coleção. Mas, para executar mais de uma versão de cada vez, você precisa de mais trabalhos paralelos.

Um trabalho paralelo gratuito é incluído em cada coleção em um Team Foundation Server. Cada assinante do Visual Studio Enterprise em um Team Foundation Server contribui com mais um trabalho paralelo.

Você pode comprar mais trabalhos privados no Visual Studio Marketplace. Há um limite máximo de 25 trabalhos paralelos para agentes hospedados pela Microsoft.

Importante

A partir do Azure DevOps Server 2019, você não precisa pagar os trabalhos simultâneos auto-hospedados em versões. Você só é limitado pelo número de agentes que tem.

Saiba como estimar quantos trabalhos paralelos você precisa e comprar mais trabalhos paralelos para sua organização.

Observação

Desabilitamos temporariamente a concessão gratuita de trabalhos paralelos para projetos públicos e para determinados projetos particulares em novas organizações. No entanto, você pode solicitar essa concessão enviando uma solicitação. As organizações e os projetos existentes não são afetados. Observe que ele leva 2 a 3 dias úteis para responder às suas solicitações de camada gratuita.

O que é um trabalho paralelo?

Ao definir um pipeline, é possível defini-lo como uma coleção de trabalhos. Quando um pipeline é executado, é possível executar vários trabalhos como parte desse pipeline. Cada trabalho em execução consome um trabalho paralelo que é executado em um agente. Quando não houver trabalhos paralelos suficientes disponíveis para a sua organização, os trabalhos serão colocados em fila e executados um após o outro.

No Azure Pipelines, você pode executar trabalhos paralelos na infraestrutura hospedada pela Microsoft ou na sua própria infraestrutura (auto-hospedada). Cada trabalho paralelo permite que você execute um único trabalho de cada vez na sua organização. Você não precisará pagar por trabalhos paralelos, se estiver usando um servidor local. O conceito de trabalhos paralelos só se aplica ao Azure DevOps Services.

Trabalhos paralelos hospedados pela Microsoft versus auto-hospedados

Se você quiser executar seus trabalhos em computadores gerenciados pela Microsoft, use trabalhos paralelos hospedados pela Microsoft. Seus trabalhos serão executados em agentes hospedados pela Microsoft.

Se você quiser que o Azure Pipelines orquestre seus builds e versões, mas use os próprios computadores para executá-los, use trabalhos paralelos auto-hospedados. Para trabalhos paralelos auto-hospedados, você começará implantando nossos agentes auto-hospedados nos seus computadores. Você pode registrar qualquer número desses agentes auto-hospedados em sua organização.

Quanto custam os trabalhos paralelos?

Fornecemos uma camada gratuita de serviço por padrão em todas as organizações para trabalhos paralelos hospedados e auto-hospedados. Os trabalhos paralelos são comprados no nível da organização e são compartilhados por todos os projetos em uma organização.

Para trabalhos paralelos hospedados pela Microsoft, você pode obter até 10 trabalhos paralelos hospedados pela Microsoft gratuitos, que podem ser executados por até 360 minutos (6 horas) de cada vez para projetos públicos. Ao criar uma nova organização do Azure DevOps, você não recebe essa concessão gratuita por padrão.

Para projetos privados, você pode obter um trabalho gratuito que pode ser executado por até 60 minutos de cada vez. Ao criar uma nova organização do Azure DevOps, você nem sempre receberá essa concessão gratuita por padrão.

Para solicitar a concessão gratuita para projetos públicos ou privados, envie uma solicitação.

Observação

Leva de dois a três dias úteis para responder à sua solicitação de camada gratuita.

Não há limite de tempo para trabalhos paralelos para projetos públicos e há um limite de tempo de 30 horas por mês para projetos privados.

Número de trabalhos paralelos Limite de tempo
Projeto público Até 10 trabalhos paralelos gratuitos hospedados pela Microsoft que podem ser executados por até 360 minutos (6 horas) de cada vez Não há limite de tempo geral por mês
Projeto privado Um trabalho gratuito que pode ser executado por até 60 minutos de cada vez 1.800 minutos (30 horas) por mês

Quando a camada gratuita não for mais suficiente, você poderá pagar por capacidade adicional por trabalho paralelo. Para saber o custo de preços por trabalho paralelo, confira a página de preços do Azure DevOps. Trabalhos paralelos pagos removem o limite de tempo mensal e permitem que você execute cada trabalho por até 360 minutos (6 horas).

Compre trabalhos paralelos hospedados pela Microsoft.

Novas organizações têm um limite máximo de 25 trabalhos paralelos para agentes hospedados pela Microsoft. Entre em contato com o suporte para solicitar um aumento de limite, sujeito à capacidade na região da sua organização.

Quando você compra seu primeiro trabalho paralelo hospedado pela Microsoft, o número de trabalhos paralelos que você tem na organização ainda é um. Para executar dois trabalhos simultaneamente, você precisará comprar dois trabalhos paralelos se estiver na camada gratuita no momento. A primeira compra remove apenas os limites de tempo do primeiro trabalho.

Dica

Se o pipeline exceder o tempo limite máximo do trabalho, tente dividir o pipeline em vários trabalhos. Para obter mais informações sobre trabalhos, confira Especificar trabalhos no seu pipeline.

De quantos trabalhos paralelos preciso?

Como o número de builds e versões enfileirados excede o número de trabalhos paralelos que você tem, suas filas de build e versão aumentarão mais. Quando você descobre que os atrasos de fila são muito longos, você pode comprar trabalhos paralelos adicionais conforme necessário. Há vários métodos que você pode usar para marcar seus limites de trabalho paralelos e o histórico de trabalhos.

Exibir o histórico de trabalhos usando o relatório de consumo de pool

Você pode usar o relatório de consumo de pool, disponível na guia Análise do seu pool de agentes, para ver um gráfico de trabalhos em execução e na fila grafados com seus trabalhos paralelos nos últimos 30 dias. Se você tiver uma lista de pendências de trabalhos na fila e seus trabalhos em execução estiverem no limite de simultaneidade, convém comprar mais trabalhos paralelos. Para obter mais informações, confira Relatório de consumo de pool.

Grafo histórico do pool de agentes hospedado pela Microsoft

Verificar a configuração de trabalhos paralelos diretamente

Descubra de quantos trabalhos paralelos você precisa primeiro vendo quantos trabalhos paralelos sua organização usa atualmente:

  1. Navegue até Configurações da organização>Pipelines>Trabalhos paralelos.

    Localização das configurações de trabalhos paralelos na organização.

    Exemplo de URL: https://{your_organization}/_admin/_buildQueue?_a=resourceLimits

  2. Veja o número máximo de trabalhos paralelos disponíveis em sua organização.

  3. Selecione Exibir trabalhos em andamento para exibir todos os builds e versões que estão consumindo ativamente um trabalho paralelo disponível ou que estão na fila aguardando um trabalho paralelo estar disponível.

Estimar custos

Uma regra prática simples é: estime que você precisará de um trabalho paralelo para cada quatro a cinco usuários em sua organização.

Nos seguintes cenários, você pode precisar de vários trabalhos paralelos:

  • Se você tiver várias equipes e se cada uma delas exigir CI, provavelmente você precisará de um trabalho paralelo para cada equipe.
  • Se o gatilho de CI se aplicar a vários branches, provavelmente você precisará de um trabalho paralelo para cada branch ativo.
  • Se você desenvolver vários aplicativos usando uma organização ou servidor, provavelmente você precisará de trabalhos paralelos adicionais, um para implantar cada aplicativo ao mesmo tempo.

Como comprar mais trabalhos paralelos?

Para comprar mais trabalhos paralelos:

Comprar trabalhos paralelos

Compre mais trabalhos paralelos nas configurações da sua organização:

  1. Entrar em sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione ícone de engrenagemConfigurações da organização.

    Abrir Configurações da organização

  3. Selecione Trabalhos paralelos em Pipelines e, em seguida, Alterar para trabalhos hospedados pela Microsoft ou Alterar para trabalhos auto-hospedados.

    gerenciar imagem de trabalhos paralelos

  4. Insira o valor desejado e, em seguida, Salvar.

  5. Pode levar até 30 minutos para que seus trabalhos paralelos adicionais fiquem disponíveis para uso.

Para saber o custo de preços por trabalho paralelo, confira a página de preços do Azure DevOps.

Como alterar a quantidade de trabalhos paralelos para minha organização?

  1. Entrar em sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione ícone de engrenagemConfigurações da organização.

    Abrir Configurações da organização

  3. Selecione Trabalhos paralelos em Pipelines e, em seguida, Alterar trabalhos paralelos, Alterar para trabalhos hospedados pela Microsoft ou Alterar para trabalhos auto-hospedados.

    imagem do gerenciamento de trabalhos paralelos

  4. Insira uma quantidade menor ou maior de trabalhos hospedados pela Microsoft ou auto-hospedados e selecione Salvar.

Importante

Não há suporte para o controlador de build XAML hospedado. Se você tiver uma organização na qual precisa executar builds XAML, configure um servidor de build local e alterne para um controlador de build local. Para obter mais informações sobre o modelo XAML hospedado, confira Introdução ao XAML.

  1. Pode levar até 30 minutos para que o novo número de trabalhos paralelos se torne ativo.

Como um trabalho paralelo é consumido no DevOps Services?

Considere uma organização que tenha apenas um trabalho paralelo hospedado pela Microsoft. Esse trabalho permite que os usuários nessa organização executem coletivamente apenas um trabalho de cada vez. Quando trabalhos adicionais são disparados, eles são colocados na fila e aguardam a finalização do trabalho anterior.

Se você usar pipelines de versão ou YAML, uma execução consumirá um trabalho paralelo somente quando ele estiver sendo implantado ativamente em uma fase. Enquanto a versão está aguardando uma aprovação ou intervenção manual, ela não consumirá um trabalho paralelo.

Ao executar um trabalho de servidor ou implantar em um grupo de implantação usando pipelines de lançamento, você não consome trabalhos paralelos.

Exemplo simples de trabalhos paralelos

  1. O build 102 de CI do FabrikamFiber (ramificação principal) começa primeiro.
  2. A implantação do FabrikamFiber versão 11 é disparada pela conclusão do Build 102 de CI do FabrikamFiber.
  3. O build 101 de CI do FabrikamFiber (ramificação de recursos) é disparado. O build ainda não pode começar porque a implantação da versão 11 está ativa. Portanto, o build permanece na fila.
  4. A versão 11 aguarda aprovações. O build 101 de CI do Fabrikam é iniciado porque uma versão que está aguardando aprovações não consome um trabalho paralelo.
  5. A versão 11 foi aprovada. Ele será retomado somente após a conclusão do build 101 de CI do Fabrikam.

Como um trabalho paralelo é consumido?

Por exemplo, uma coleção em um Team Foundation Server tem um trabalho paralelo. Isso permite que os usuários dessa coleção executem apenas uma versão de cada vez. Quando versões adicionais são disparadas, elas são enfileiradas e aguardarão até que a anterior seja concluída.

Uma versão exige um trabalho paralelo somente quando ele está sendo implantado ativamente em uma fase. Aguardar uma aprovação não consome um trabalho paralelo. No entanto, aguardar uma intervenção manual no meio de uma implantação consome um trabalho paralelo.

Exemplo simples de trabalhos paralelos

  1. A Versão 10 da FabrikamFiber é a primeira a ser implantada.
  2. A implantação da FabrikamFiber Versão 11 começa após a conclusão da implantação da Versão 10.
  3. A versão 12 fica na fila até que a implantação da Versão 11 esteja ativa.
  4. A versão 11 aguarda uma aprovação. A implantação da versão 12 é iniciada porque uma versão aguardando aprovações não consome um trabalho paralelo.
  5. Embora a Versão 11 seja aprovada, ela será retomada somente após a conclusão da implantação da Versão 12.
  6. A versão 11 aguarda intervenção manual. A versão 13 não pode ser iniciada, pois o estado de intervenção manual consome um trabalho paralelo.

A intervenção manual não consome um trabalho no TFS 2017.1 e mais recente.

Processamento paralelo em uma única versão

O processamento paralelo em uma única versão não exige trabalhos paralelos adicionais. Desde que você tenha agentes suficientes, você pode implantar em várias fases em uma versão ao mesmo tempo.

Por exemplo, suponha que sua coleção tenha três trabalhos paralelos. Você pode ter mais de três agentes em execução ao mesmo tempo para executar operações paralelas nas versões. Por exemplo, observe abaixo que quatro ou cinco agentes estão executando ativamente trabalhos de três trabalhos paralelos.

Exemplo de trabalhos paralelos com agentes adicionais

Trabalhos paralelos em uma organização

Por exemplo, esta é uma organização que tem vários Team Foundation Servers. Dois de seus usuários têm assinaturas do Visual Studio Enterprise que podem ser usadas ao mesmo tempo em todos os servidores locais e em cada coleção, desde que o cliente as adicione como usuários aos dois servidores, conforme explicado abaixo.

Exemplo de trabalhos paralelos em uma organização

Determinar o número de trabalhos paralelos necessários

Você pode começar verificando se suas equipes podem manter as atividades com os trabalhos paralelos que você tem por padrão. Como o número de versões enfileiradas excede o número de trabalhos paralelos que você tem, suas filas de versão aumentarão mais. Quando você descobre que os atrasos de fila são muito longos, você pode comprar trabalhos paralelos adicionais conforme necessário.

Estimativa simples

Uma regra prática simples é: estime que você precisará de um trabalho paralelo para cada dez usuários no seu servidor.

Estimativa detalhada

Nos seguintes cenários, você pode precisar de vários trabalhos paralelos:

  • Se você tiver várias equipes, se cada uma delas exigir um build de CI e se cada uma das compilações de CI estiver configurada para disparar uma versão, provavelmente você precisará de um trabalho paralelo para cada equipe.

  • Se você desenvolver vários aplicativos em uma coleção, provavelmente você precisará de trabalhos paralelos adicionais, um para implantar cada aplicativo ao mesmo tempo.

Usar seu benefício de assinatura do Visual Studio Enterprise

Os usuários que têm assinaturas do Visual Studio Enterprise são atribuídos ao nível de acesso VS Enterprise no hub de Usuários da instância do TFS. Cada um desses usuários contribui com um trabalho paralelo adicional para cada coleção. Você pode usar esse benefício em todos os Team Foundation Servers na sua organização.

  1. Navegue até Configurações do servidor, Níveis de acesso.

    servidor do painel de controle versus níveis de acesso enterprise

    Exemplo de URL: http://{your_server}:8080/tfs/_admin/_licenses

  2. No lado esquerdo da página, clique em VS Enterprise.

  3. Adicione seus usuários que têm assinaturas do Visual Studio Enterprise.

Depois de adicionar esses usuários, as licenças adicionais serão exibidas na página de limites de recursos descrita abaixo.

Comprar trabalhos paralelos adicionais

Se você precisar executar mais versões paralelas, poderá comprar trabalhos privados adicionais no marketplace do Visual Studio. Como não é possível comprar trabalhos paralelos diretamente do Marketplace para uma instância do TFS no momento, primeiro você deve comprar trabalhos paralelos para uma organização do Azure DevOps. Depois de comprar os trabalhos privados para uma organização do Azure DevOps, insira o número de trabalhos paralelos comprados manualmente na página limites de recursos descrita abaixo.

Exibir e gerenciar trabalhos paralelos

  1. Navegue até Configurações de coleção, Pipelines, Limites de recursos.

    Definir limites de recurso

    Exemplo de URL: http://{your_server}:8080/tfs/DefaultCollection/_admin/_buildQueue?_a=resourceLimits

  2. Exiba ou edite o número de trabalhos paralelos comprados.

Perguntas frequentes

Como me qualificar para a camada gratuita do Azure Pipelines para projetos públicos?

Você se qualificará para os limites de camada gratuita para projetos públicos se atender a estas condições:

  • Seu pipeline faz parte de um projeto público do Azure Pipelines.
  • Seu pipeline compila um repositório público do GitHub ou do mesmo projeto público em sua organização do Azure DevOps.

Para obter informações sobre como solicitar a concessão de trabalhos paralelos gratuitos, confira Quanto custam os trabalhos paralelos (hospedados pela Microsoft)?

Posso atribuir um trabalho paralelo a um projeto ou pool de agentes específico?

Atualmente, não há um modo de particionar ou dedicar a capacidade de trabalho paralelo a um projeto ou pool de agentes específico. Por exemplo:

  • Você compra dois trabalhos paralelos em sua organização.
  • Você começa duas execuções no primeiro projeto e ambos os trabalhos paralelos são consumidos.
  • Você inicia uma execução no segundo projeto. Essa execução não será iniciada até que uma das execuções no seu primeiro projeto seja concluída.

Há limites a quem pode usar o Azure Pipelines?

Você pode ter quantos usuários quiser ao usar o Azure Pipelines. Não há custo por usuário para usar o Azure Pipelines. Os usuários com acesso básico e de stakeholder podem criar quantos builds e versões quiserem.

Há limites ao número de builds e pipelines de lançamento que posso criar?

Não. Você pode criar centenas ou até milhares de pipelines sem custo. Você pode registrar qualquer número de agentes auto-hospedados sem custo.

Como assinante do Visual Studio Enterprise, recebo trabalhos paralelos adicionais para TFS e Azure Pipelines?

Sim. Os assinantes do Visual Studio Enterprise obtêm um trabalho paralelo no Team Foundation Server 2017 ou posterior e um trabalho paralelo auto-hospedado em cada organização do Azure DevOps Services de que eles são membros.

E quanto à opção de pagar por agentes hospedados por minuto?

Alguns de nossos clientes anteriores ainda estão em um plano por minuto para os agentes hospedados. Neste plano, você paga US$ 0,05/minuto pelas primeiras 20 horas após a camada gratuita e US$ 0,01/minuto após 20 horas. Devido às seguintes limitações neste plano, convém considerar a mudança para o modelo de trabalhos paralelos:

  • Ao usar o plano por minuto, você pode executar apenas um trabalho por vez.
  • Se você executar builds por mais de 14 horas pagas em um mês, o plano por minuto poderá ser menos econômico do que o modelo de trabalhos paralelos.

Uso controladores de build XAML com minha organização. Como sou cobrado por eles?

Você pode registrar um controlador de build XAML para cada trabalho paralelo auto-hospedado na sua organização. Sua organização obtém pelo menos um trabalho paralelo auto-hospedado gratuito, para que você possa registrar um controlador de build XAML sem custo adicional. Para cada controlador de build XAML adicional, você precisará de um trabalho paralelo auto-hospedado adicional.

Quem pode usar o sistema?

Os usuários do TFS com uma CAL do TFS podem criar quantas versões desejarem.

Para aprovar versões, uma CAL do TFS não é necessária. Qualquer usuário com acesso de stakeholder pode aprovar ou reprovar versões.

Preciso de trabalhos paralelos para executar builds no TFS?

Não, no TFS você não precisa de trabalhos paralelos para executar builds. Você pode executar quantos builds desejar ao mesmo tempo, sem custo adicional.

Preciso de trabalhos paralelos para gerenciar nas versões anteriores ao TFS 2017?

Não.

No TFS 2015, desde que os usuários tenham uma CAL do TFS, eles podem gerenciar versões sem custo adicional no modo de avaliação. Chamamos de "modo de avaliação" para indicar que, eventualmente, cobraríamos pelo gerenciamento de versões. Apesar desse rótulo, damos suporte total ao gerenciamento de versões no TFS 2015.