Criar e gerenciar pools de agentes

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

Um pool de agentes é uma coleção de agentes. Em vez de gerenciar cada agente individualmente, você organiza agentes em pools de agentes. Quando você configura um agente, ele é registrado com um pool e, quando você cria um pipeline, especifica o pool no qual o pipeline é executado. Quando você executa o pipeline, ele é executado em um agente desse pool que atende às demandas do pipeline.

No Azure Pipelines, os pools têm escopo para toda a organização, para que você possa compartilhar os computadores do agente entre projetos.

Observação

Os trabalhos do pool de agentes executam um trabalho em apenas um agente. Se você precisar executar um trabalho em todos os agentes, como um grupo de implantação para pipelines de lançamento clássicos, confira Provisionar grupos de implantação.

Se você for um administrador da organização, crie e gerencie pools de agentes na guia pools de agentes nas configurações de administrador.

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

2. Escolha Azure DevOps, Configurações da organização.

   

3. Escolha Pools de agentes.

   

Se você é um membro da equipe do projeto, pode criar e gerenciar pools de agentes na guia de pools de agentes nas configurações do projeto.

Navegue até o projeto e escolha Configurações do projeto, Pools de agentes.

Pools de agentes padrão

Os seguintes pools de agentes são fornecidos por padrão:

• Pool padrão: use-o para registrar agentes auto-hospedados que você configurou.

• Pool hospedado do Azure Pipelines com várias imagens do Windows, Linux e macOS. Para obter uma lista completa das imagens disponíveis e dos respectivos softwares instalados, confira Agentes hospedados pela Microsoft.

  Observação

  O pool hospedado do Azure Pipelines substitui os pools hospedados anteriormente que tinham nomes mapeados para as imagens correspondentes. Todos os trabalhos que você tinha nos pools hospedados anteriores são redirecionados automaticamente para a imagem correta no novo pool hospedado do Azure Pipelines. Em algumas circunstâncias, você ainda pode ver os nomes de pool antigos, mas nos bastidores, os trabalhos hospedados são executados usando o pool do Azure Pipelines. Para obter mais informações, consulte as notas sobre a versão do Pool hospedado único das Notas sobre a versãode versão de 1º de julho de 2019 – Sprint 154.

Por padrão, todos os colaboradores em um projeto são membros da função Usuário em pools hospedados. Isso permite que cada colaborador em um projeto crie e execute pipelines usando agentes hospedados pela Microsoft.

Designar um pool em seu pipeline

YAML

Para escolher um agente hospedado pela Microsoft no pool do Azure Pipelines em seu pipeline YAML do Azure DevOps Services, especifique o nome da imagem usando o Rótulo de Imagem da VM YAMLdesta tabela.

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

Para usar um pool privado sem demandas:

pool: MyPool

Para obter mais informações, confira o esquema YAML para pools.

Clássico

Para escolher um pool e um agente no editor clássico, navegue até as configurações do pipeline, selecione o pool de agentes desejado e, em seguida, a imagem desejada na lista suspensa Especificação do Agente . A Especificação do Agente padrão é windows-2019. Para obter mais informações sobre o software instalado nas imagens hospedadas pela Microsoft, consulte a entrada correspondente na coluna Pool do Editor Clássicodesta tabela.

Gerenciar pools e filas

Navegador

Se você for um administrador da organização, crie e gerencie pools de agentes na guia pools de agentes nas configurações de administrador.

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

2. Escolha Azure DevOps, Configurações da organização.

   

3. Escolha Pools de agentes.

   

Se você é um membro da equipe do projeto, pode criar e gerenciar pools de agentes na guia de pools de agentes nas configurações do projeto.

Navegue até o projeto e escolha Configurações do projeto, Pools de agentes.

CLI do Azure DevOps

Listar pools de agentes | Mostrar detalhes do pool de agentes | Listar filas de agentes | Mostrar detalhes da fila de agentes

Observação

Neste momento, você pode exibir informações sobre pools e filas de agentes, mas não editá-las, usando a CLI do Azure.

Se essa for a primeira vez que você usa comandos az devops pipelines, consulte Introdução à CLI do Azure DevOps.

Listar pools de agentes

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

Parâmetros

• action: filtrar a lista com a ação do usuário permitida. Valores aceitos: manage, none, use
• detect: detectar a organização automaticamente. Valores aceitos: false, true
• org ou organization: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
• pool-name: filtre a lista com o nome do pool correspondente.
• pool-type: filtre a lista com o tipo de pool. Valores aceitos: automation, deployment

Exemplo

O exemplo a seguir lista todos os pools no formato de tabela. Este exemplo usa a seguinte configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool list --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

Mostrar detalhes do pool de agentes

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

Parâmetros

• id ou pool-id: (Obrigatório) ID do pool para listar os detalhes.
• action: filtrar a lista com a ação do usuário permitida. Valores aceitos: manage, none, use
• detect: detectar a organização automaticamente. Valores aceitos: false, true
• org ou organization: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

Exemplo

O exemplo a seguir exibe os detalhes do pool do Windows 2019 hospedado com o pool do VS2019. Este exemplo usa a seguinte configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

Você também pode usar --output table, que retorna as mesmas informações que o comando list.

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

Listar filas de agentes

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

Parâmetros

• action: filtrar a lista com a ação do usuário permitida. Valores aceitos: manage, none, use
• detect: detectar a organização automaticamente. Valores aceitos: false, true
• org ou organization: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
• project ou p: nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio de git config.
• queue-name: filtre a lista com regex de nome de fila correspondente, por exemplo, ubuntu para fila com o nome 'Ubuntu hospedado 1604'.

Exemplo

O exemplo a seguir lista todas as filas no formato de tabela. Este exemplo usa a seguinte configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue list --output table
This command group is in preview. It may be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

Mostrar detalhes da fila de agentes

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

Parâmetros

• id ou queue-id: ID da fila de agentes sobre a qual obter informações.
• action: filtrar a lista com a ação do usuário permitida. Valores aceitos: manage, none, use
• detect: detectar a organização automaticamente. Valores aceitos: false, true
• org ou organization: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
• project ou p: nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração Git.

Exemplo

O exemplo a seguir exibe detalhes da fila para a fila Hospedada do Windows 2019 com VS2019. Este exemplo usa a seguinte configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

Os pools são usados para executar trabalhos. Saiba mais sobre como especificar pools para trabalhos.

Se você tiver muitos agentes destinados a diferentes equipes ou finalidades, talvez queira criar mais pools, conforme explicado abaixo.

Criar pools de agentes

Aqui estão algumas situações típicas em que talvez você queira criar pools de agentes auto-hospedados:

• Você é um membro de um projeto e quer usar um conjunto de computadores de sua equipe para executar trabalhos de build e implantação. Primeiro, verifique se você tem as permissões para criar pools no projeto. Basta selecionar Segurança na página de pools de agentes nas configurações do projeto. Você precisa ter a função Administrador para poder criar pools. Em seguida, selecione Adicionar pool e selecione a opção para criar um novo pool. Por fim, instale e configure agentes para fazer parte desse pool de agentes.

• Você é membro da equipe de infraestrutura e gostaria de configurar um pool de agentes para uso em todos os projetos. Primeiro, verifique se você tem as permissões para criar pools no projeto. Basta selecionar Segurança na página de pools de agentes nas configurações da organização. Em seguida, crie um Novo pool de agentes e selecione a opção para provisionar automaticamente esse pool de agentes em todos os projetos ao criar o pool. Essa configuração garante que todos os projetos tenham acesso a esse pool de agentes. Por fim, instale e configure agentes para fazer parte desse pool de agentes.

• Você quer compartilhar um conjunto de computadores de agente com vários projetos, mas não todos. Primeiro, navegue até as configurações de um dos projetos, adicione um pool de agentes e selecione a opção para criar um pool no nível da organização. Em seguida, vá para cada um dos outros projetos e crie um pool em cada um deles enquanto seleciona a opção para Usar um pool de agentes existente da organização. Por fim, instale e configure agentes para fazer parte do pool de agentes compartilhado.

Segurança dos pools de agentes

Entender como a segurança funciona para pools de agentes ajuda a controlar o compartilhamento e o uso de agentes.

As funções são definidas em cada pool de agentes e a associação a essas funções rege quais operações você pode executar em um pool de agentes.

Configurações de segurança no nível da organização

Função em um pool de agentes nas configurações da organização	Finalidade
Leitor	Os membros dessa função podem visualizar o pool de agentes e os agentes. Normalmente, você usa isso para adicionar operadores responsáveis por monitorar os agentes e a integridade deles.
Conta de serviço	Os membros dessa função podem usar o pool de agentes da organização para criar um pool de agentes de projeto em um projeto. Se você seguir as diretrizes acima para criar pools de agentes de projeto, normalmente não será preciso adicionar nenhum membro aqui.
Administrador	Além de todas as permissões acima, os membros dessa função podem registrar ou cancelar o registro de agentes do pool de agentes da organização. Eles também podem se referir ao pool de agentes da organização ao criar um pool de agentes de projeto em um projeto. Por fim, também podem gerenciar a associação para todas as funções do pool de agentes da organização. O usuário que criou o pool de agentes da organização é adicionado automaticamente à função Administrador desse pool.

O nó Todos os pools de agentes na guia Pools de Agentes é usado para controlar a segurança de todos os pools de agentes da organização. Associações de função para pools de agentes de organização individuais são herdadas automaticamente do nó "Todos os pools de agentes". Por padrão, os administradores de TFS e Azure DevOps Server também são administradores do nó "Todos os pools de agentes" ao usar o TFS ou o Azure DevOps Server.

Configurações de segurança no nível do projeto

As funções também são definidas em cada pool de agentes de projeto, e as associações nessas funções regem quais operações você pode executar em um pool de agentes no nível do projeto.

Função em um pool de agentes nas configurações do projeto	Finalidade
Leitor	Os membros dessa função podem visualizar o pool de agentes do projeto. Normalmente, você o usa para adicionar operadores responsáveis por monitorar os trabalhos de build e implantação nesse pool de agentes de projeto.
Usuário	Os membros dessa função podem usar o pool de agentes do projeto ao criar pipelines.
Administrador	Além disso, para todas as operações acima, os membros dessa função podem gerenciar a associação para todas as funções do pool de agentes de projeto. O usuário que criou o pool é adicionado automaticamente à função Administrador desse pool.

Permissões de pipeline

As permissões de pipeline controlam quais pipelines YAML estão autorizados a usar um pool de agentes. As permissões de pipeline não restringem o acesso de pipelines Clássicos.

É possível escolher um das seguintes opções:

• Abra o acesso a todos os pipelines para usar o pool de agentes por meio do menu mais opções no canto superior direito da seção Permissões de pipeline na guia segurança de um pool de agentes.

• Bloqueie o pool de agentes e permita apenas que pipelines YAML selecionados o usem. Se qualquer outro pipeline YAML se referir ao pool de agentes, uma solicitação de autorização será gerada, que deverá ser aprovada por um Administrador do pool de agentes. Isso não limita o acesso de pipelines Clássicos.

As permissões de pipeline para o pool de agentes do Azure Pipelines não podem ser configuradas, pois o pool está acessível, por padrão, a todos os pipelines.

A ação Segurança na guia Pools de agentes é usada para controlar a segurança de todos os pools de agentes de projeto em um projeto. As associações de função para pools de agentes de projeto individuais são herdadas automaticamente das configurações que você define aqui. Por padrão, os seguintes grupos são adicionados à função Administrador de "Todos os pools de agentes": Administradores de Build, Administradores de Versão e Administradores de Projeto.

Perguntas frequentes

Se eu não agendar uma janela de manutenção, quando os agentes executarão a manutenção?

Se nenhuma janela for agendada, os agentes nesse pool não executarão o trabalho de manutenção.

O que é um trabalho de manutenção?

Você pode configurar pools de agentes para limpar periodicamente diretórios de trabalho e repositórios obsoletos. Isso deve reduzir a possibilidade de os agentes ficarem sem espaço em disco. Os trabalhos de manutenção são configurados no nível da organização nas configurações do pool de agentes.

Para definir as configurações do trabalho de manutenção:

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

2. Escolha Azure DevOps, Configurações da organização.

   

3. Escolha Pools de agentes.

   

Escolha o pool desejado e escolha Configurações para definir as configurações de trabalho de manutenção para esse pool de agentes.

Importante

Você precisa ter a permissão Gerenciar filas de build para definir as configurações do trabalho de manutenção. Se você não vir a guia Configurações ou a guia Histórico de Manutenção, não terá essa permissão, que é concedida por padrão à função Administrador. Para saber mais, confira Segurança de pools de agentes.

Defina as configurações desejadas e escolha Salvar.

Selecione Histórico de Manutenção para ver o histórico de trabalhos de manutenção do pool de agentes atual. Você pode baixar e revisar os logs para ver as etapas e as ações de limpeza executadas.

A manutenção é feita por pool de agentes (não por computador). Portanto, se você tiver vários pools de agentes em apenas um computador, ainda poderá ter problemas de espaço em disco.

O trabalho de manutenção do meu pool de agentes auto-hospedados parece preso. Por quê?

Normalmente, um trabalho de manutenção fica "preso" quando está esperando para ser executado em um agente que não está mais no pool de agentes. Isso acontece quando, por exemplo, o agente foi propositalmente colocado offline ou quando há problemas de comunicação com ele.

Os trabalhos de manutenção enfileirados para execução aguardarão sete dias para serem executados. Posteriormente, eles serão automaticamente configurados para o estado de falha se não forem executados. Este limite de tempo não pode ser alterado.

O limite de sete dias é diferente da configuração de tempo limite do trabalho de manutenção. Esse último controla o número máximo de minutos que um agente pode gastar fazendo manutenção. O temporizador começa quando o trabalho é iniciado, não quando o trabalho está na fila de um agente.

Estou tentando criar um pool de agentes de projeto que usa um pool de agentes da organização existente, mas os controles estão esmaecidos. Por que?

Na caixa de diálogo "Criar um pool de agentes de projeto", você não poderá usar um pool de agentes da organização existente se ele já for referenciado por outro pool de agentes de projeto. Cada pool de agentes da organização pode ser referenciado por apenas um pool de agentes de projeto em uma determinada coleção de projetos.

Não consigo selecionar um pool hospedado pela Microsoft e não consigo enfileirar minha compilação. Como corrigir isso?

Peça ao proprietário da sua organização do DevOps do Azure para conceder a permissão para usar o pool. Consulte Segurança dos pools de agentes .

Preciso de mais recursos de build hospedados. O que posso fazer?

R: O pool do Azure Pipelines fornece agentes de build hospedados na nuvem e minutos de build gratuitos todos os meses a todas as organizações do Azure DevOps. Se você precisar de mais recursos de build hospedados pela Microsoft ou precisar executar mais trabalhos em paralelo, poderá:

• Hospedar seus agentes na infraestrutura que você gerencia
• Comprar trabalhos paralelos adicionais